banteg
69 lines
1.7 KiB
Markdown
69 lines
1.7 KiB
Markdown
# takopi
|
|
|
|
🐙 *he just wants to help-pi*
|
|
|
|
telegram bot for [codex](https://github.com/openai/codex). with streaming progress and resumeable sessions.
|
|
|
|
## features
|
|
|
|
stateless resume via `codex resume <token>` lines in chat.
|
|
|
|
edits progress message while codex runs (commands, tools, reasoning, edits, elapsed time).
|
|
|
|
renders markdown to telegram entities.
|
|
|
|
runs in parallel across threads and queues per thread to keep codex history sane.
|
|
|
|
## requirements
|
|
|
|
- `uv` for installation (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
|
|
- `codex` on PATH (`npm install -g @openai/codex` or `brew install codex`)
|
|
|
|
## install
|
|
|
|
- `uv tool install takopi` to install as `takopi`
|
|
- or try it out with `uvx takopi`
|
|
|
|
## setup
|
|
|
|
1. get `bot_token` from [@BotFather](https://t.me/BotFather)
|
|
2. get `chat_id` from [@myidbot](https://t.me/myidbot)
|
|
2. send `/start` to the bot (telegram won't let it message you first)
|
|
3. run `codex` once interactively in the repo to trust the directory
|
|
|
|
## config
|
|
|
|
takopi config lives in `~/.takopi/takopi.toml` and can be overriden by `.takopi/takopi.toml` in the current repo.
|
|
|
|
```toml
|
|
bot_token = "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
|
|
chat_id = 123456789
|
|
|
|
[codex]
|
|
# optional: profile from ~/.codex/config.toml
|
|
profile = "takopi"
|
|
```
|
|
|
|
## usage
|
|
|
|
start takopi in the repo you want to work on:
|
|
|
|
```sh
|
|
cd ~/dev/your-repo
|
|
takopi
|
|
```
|
|
|
|
send a message to the bot.
|
|
|
|
to continue a thread, reply to a bot message.
|
|
|
|
to stop a run, reply to the progress message with `/cancel`.
|
|
|
|
## cli
|
|
|
|
by default takopi sends the progress message silently, and replaces it with the final answer to notify you. this can be turned off with `--no-final-notify`
|
|
|
|
## development
|
|
|
|
see [`docs/specification.md`](docs/specification.md) and [`docs/developing.md`](`docs/developing.md`).
|