CLAUDE.md

1# TG Claude - Telegram Bridge for Claude Code
2 
3## What This Is
4Node.js bot that turns Mac into remote Claude Code terminal via Telegram. Not an API wrapper - runs real CLI with full tool access.
5 
6## Architecture
7```
8User (Telegram) -> Bot (Node.js) -> Claude Code CLI -> tools -> response -> User
9```
10 
11## Key Files
12- `worker/` - Claude Code session management, message processing
13- `approval-hook.mjs` - PreToolUse hook, sends approval buttons to Telegram
14- `stop-hook.mjs` - Stop hook, notifies on session end
15- `notify-hook.mjs` - Notification hook
16- `mode.mjs` - Mode management (auto/confirm)
17- `bot-system-prompt.md` - System prompt injected into every Claude session
18- `config.json` - Bot token, allowed users, settings (NEVER commit)
19- `launcher.sh` - Process manager
20 
21## Rules
22- **Telegram HTML formatting only** - no Markdown. Use `<b>`, `<code>`, `<pre>` tags
23- **No Markdown tables** - Telegram doesn't render them
24- **Concise responses** - phone screen, not desktop
25- **bot-system-prompt.md** is the system prompt for Telegram sessions - edit there, not here
26- **config.json** contains secrets - always in .gitignore
27- **test.txt** in root is test artifact, can be deleted
28 
29## Stack
30- Node.js 20+ (ESM, .mjs)
31- grammY (Telegram bot framework)
32- Claude Code CLI (spawned as child process)
33- No database - sessions in memory, config in JSON
34