From c2c4190881e86a600024ba9105533116f10d9158 Mon Sep 17 00:00:00 2001
From: banteg <4562643+banteg@users.noreply.github.com>
Date: Sat, 10 Jan 2026 01:39:40 +0400
Subject: [PATCH] docs: clean up readme

- add per-project chat routing to features
- fix inactive doc links in plugins section
- remove redundant python install step
- remove notes section (locks handle single-instance)
- explain chat_id in projects section
---
 readme.md | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/readme.md b/readme.md
index 6d399b5..d85d939 100644
--- a/readme.md
+++ b/readme.md
@@ -20,6 +20,8 @@ parallel runs across threads, per thread queue support.
 
 optional voice note transcription for telegram (routes transcript like typed text).
 
+per-project chat routing: assign different telegram chats to different projects.
+
 ## requirements
 
 - `uv` for installation (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
@@ -32,7 +34,6 @@ optional voice note transcription for telegram (routes transcript like typed tex
 
 ## install
 
-- `uv python install 3.14`
 - `uv tool install -U takopi` to install as `takopi`
 - or try it with `uvx takopi@latest`
 
@@ -63,8 +64,6 @@ bot_token = "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
 chat_id = 123456789
 voice_transcription = true
 
-# set OPENAI_API_KEY in your environment for voice transcription
-
 [codex]
 # optional: profile from ~/.codex/config.toml
 profile = "takopi"
@@ -111,9 +110,11 @@ path = "~/dev/z80"
 worktrees_dir = ".worktrees"
 default_engine = "codex"
 worktree_base = "master"
-chat_id = -123456789        # optional, project chat id
+chat_id = -123456789
 ```
 
+set `chat_id` to route messages from that chat to the project automatically.
+
 note: the default `worktrees_dir` lives inside the repo, so `.worktrees/` will
 show up as untracked unless you ignore it (add to `.gitignore` or
 `.git/info/exclude`), or set `worktrees_dir` to a path outside the repo.
@@ -157,15 +158,7 @@ if you prefer no notifications, `--no-final-notify` edits the progress message i
 
 takopi supports entrypoint-based plugins for engines, transports, and command backends.
 
-see:
-
-- `docs/plugins.md`
-- `docs/public-api.md`
-
-## notes
-
-* the bot only responds to the primary `chat_id` plus any per-project `chat_id`
-* run only one takopi instance per bot token: multiple instances will race telegram's `getUpdates` offsets and cause missed updates
+see [`docs/plugins.md`](docs/plugins.md) and [`docs/public-api.md`](docs/public-api.md).
 
 ## development