tg-code-bot 0.1.0__tar.gz

tg_code_bot-0.1.0/.claude/settings.local.json

@@ -0,0 +1,14 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "WebFetch(domain:developers.openai.com)",
+      "Bash(claude -p \"say hello\" --output-format json 2>&1)",
+      "WebFetch(domain:github.com)",
+      "Bash(docker build -t tg-code-sandbox -f /home/andrew/Documents/projects/chat-with-codebase/Dockerfile /home/andrew/Documents/projects/chat-with-codebase/ 2>&1)",
+      "Bash(.venv/bin/tg-code config remove-repo test-repo 2>&1 && .venv/bin/tg-code config list-repos 2>&1)",
+      "Bash(.venv/bin/tg-code config allowed-users remove 12345 2>&1)",
+      "Bash(docker rm -f tg-code-wt-test 2>&1)"
+    ]
+  }
+}

tg_code_bot-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+__pycache__
+.venv
+

tg_code_bot-0.1.0/Dockerfile

@@ -0,0 +1,30 @@
+FROM node:22-bookworm-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    python3 \
+    python3-pip \
+    curl \
+    jq \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Claude Code CLI
+RUN npm install -g @anthropic-ai/claude-code
+
+# Install Codex CLI
+RUN npm install -g @openai/codex
+
+# Install GitHub CLI
+RUN curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
+      | dd of=/usr/share/keyrings/gh.gpg && \
+    echo "deb [signed-by=/usr/share/keyrings/gh.gpg] https://cli.github.com/packages stable main" \
+      > /etc/apt/sources.list.d/github-cli.list && \
+    apt-get update && apt-get install -y gh && \
+    rm -rf /var/lib/apt/lists/*
+
+RUN mkdir -p /workspace/repo /workspace/sessions
+
+WORKDIR /workspace/repo
+
+# Keep container alive
+CMD ["sleep", "infinity"]

tg_code_bot-0.1.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: tg-code-bot
+Version: 0.1.0
+Summary: Telegram bot bridging 1-on-1 messages to Claude Code CLI or OpenAI Codex CLI in isolated Docker containers
+Requires-Python: >=3.11
+Requires-Dist: aiogram>=3.25
+Requires-Dist: aiosqlite
+Requires-Dist: click
+Requires-Dist: tomli-w

tg_code_bot-0.1.0/README.md

@@ -0,0 +1,113 @@
+# tg-code
+
+Telegram bot that bridges 1-on-1 DMs to [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) or [OpenAI Codex CLI](https://github.com/openai/codex), with each repo running in an isolated Docker container sandbox.
+
+```
+Telegram DM (you <-> bot)
+    |
+tg-code bot (Python/aiogram on host)
+    |
+    +-- Session #1 --> docker exec container-myapp claude -p "..." --resume sid1
+    +-- Session #2 --> docker exec container-myapp codex exec resume tid2 "..."
+    +-- /pr ----------> docker exec container-myapp gh pr create ...
+```
+
+## Requirements
+
+- Python >= 3.11
+- Docker
+- A Telegram bot token (from [@BotFather](https://t.me/BotFather))
+- An Anthropic API key and/or OpenAI API key
+
+## Install
+
+```bash
+# With uv (recommended)
+uv tool install tg-code-bot
+
+# Or ephemeral
+uvx tg-code-bot --help
+```
+
+## Setup
+
+```bash
+# 1. Set your bot token
+tg-code config bot-token YOUR_BOT_TOKEN
+
+# 2. Whitelist your Telegram user ID
+tg-code config allowed-users add YOUR_TELEGRAM_USER_ID
+
+# 3. Register a repo
+tg-code config add-repo --path /path/to/your/repo --name my-app
+
+# 4. Set API keys (or export ANTHROPIC_API_KEY / CODEX_API_KEY env vars)
+tg-code config set-keys
+```
+
+## Run
+
+```bash
+tg-code run
+```
+
+On first run, tg-code builds the `tg-code-sandbox` Docker image (node 22 + claude-code + codex + gh CLI). This takes a few minutes.
+
+## Telegram Commands
+
+| Command | Description |
+|---------|-------------|
+| `/start` | Connect this chat to a repo |
+| `/new` | Start a new sandboxed session (git worktree) |
+| `/pr` | Create a PR from the current session |
+| `/pr 123` | Check out PR #123 into a new session |
+| `/pr search text` | Search PRs and pick one to check out |
+| `/claude` | Switch engine to Claude Code |
+| `/codex` | Switch engine to Codex CLI |
+| `/status` | Show current session info |
+| `/destroy` | Remove container and all sessions |
+
+Regular messages are forwarded to the active AI session. Reply to a bot message to route to that specific session.
+
+## CLI Commands
+
+```
+tg-code config bot-token <token>          # Set Telegram bot token
+tg-code config add-repo [--path] [--name] # Register a repo
+tg-code config remove-repo <name>         # Unregister a repo
+tg-code config list-repos                 # List all repos
+tg-code config allowed-users add <id>     # Allow a Telegram user
+tg-code config allowed-users remove <id>  # Remove a Telegram user
+tg-code config set-keys                   # Set API keys interactively
+tg-code run                               # Start the bot
+```
+
+## How It Works
+
+- Each registered repo gets its own Docker container with claude-code, codex, and gh pre-installed
+- Sessions run in git worktrees for branch isolation, so you can have multiple parallel tasks per repo
+- Your `~/.gitconfig` and `~/.git-credentials` are copied into containers so git/gh operations work
+- Session state is persisted to SQLite (`~/.config/tg-code/state.db`) and survives bot restarts
+- CLIs are auto-updated nightly at 3 AM EST
+
+## Config
+
+Stored at `~/.config/tg-code/config.toml`:
+
+```toml
+[bot]
+token = "123456:ABC..."
+allowed_users = [987654321]
+
+[keys]
+anthropic_api_key = ""
+codex_api_key = ""
+
+[[repos]]
+name = "my-app"
+path = "/home/user/projects/my-app"
+default_engine = "claude"
+copy_untracked = [".env"]
+```
+
+API keys can also be set via `ANTHROPIC_API_KEY` and `CODEX_API_KEY` environment variables.