Telegram bot that proxies your local Codex CLI input/output.

• /project <path> sets the working directory
• /clear clears the current session and project
• /resume <id|index> sets the current Codex session id
• /new starts a fresh Codex session on the next message
• /continue shows the current session id
• /status shows current settings

npm install
cp .env.example .env

Fill in .env:

• TELEGRAM_BOT_TOKEN
• ALLOWED_USER_IDS (comma-separated)
• CODEX_CMD and CODEX_ARGS if needed

Run:

npm run dev

• The bot runs codex exec resume --last by default (non-interactive).
• If your Codex CLI prints a session id, set CODEX_SESSION_REGEX to auto-capture it.
• Default mode is CODEX_MODE=exec, which avoids TTY issues and uses Codex's built-in session resume.
• If you switch to CODEX_MODE=interactive, keep CODEX_USE_PTY=true and CODEX_USE_SCRIPT=true to emulate a TTY.
• Use PROMPT_PREFIX to steer Codex responses (for example, avoid mentioning sandboxes).

Build once, then install:

npm run build
./scripts/launchctl/install.sh

Stop/remove:

./scripts/launchctl/uninstall.sh

Logs:

• ~/.codexgram/logs/codexgram.out.log
• ~/.codexgram/logs/codexgram.err.log