TokenCode

TokenCode

**Token 燃烧机，为 Token 燃烧而生。** 把 token 当燃料、用并行换质量的 Agent 引擎，对团队友好。当前形态：一个 Go 终端编码 agent——单 agent 底座 + TUI 之上，已长出第一种并行模式 `/race`（最多 1000 个 agent 隔离竞赛解题、裁判择优）。方向：把编码 agent 从「个人终端工具」变成「团队基础设施」。路线见 [`ROADMAP.md`](ROADMAP.md)。


为什么叫 TokenCode：为 Token 燃烧而生

一个赌注：**token 在变便宜，质量永远稀缺。**

主流编码 agent 都在省 token——精简上下文、少调几次、能一个 agent 干完绝不开第二个。TokenCode 反过来下注：既然 token 越来越便宜，那就把它当燃料烧，往一个问题上猛烧，用冗余换那份单跑一个 agent 拿不到的质量。`/race` 就是这台燃烧机的第一种烧法——同一道题派最多 1000 个 agent 各自在隔离 worktree 里解，裁判择优，败者退钱（取消、停手、退预算）。烧掉的是算力，买回来的是确定性。

但有一条线划死：**烧得其所，绝不空烧。** 为质量主动烧是存在的理由；空转、心跳空跑、上下文塞废料这种「意外烧掉」要拼命掐死（心跳三级短路、做梦压缩重写、pulse 权限从严，都是为这条线写的）。火力全开在该烧的地方，平时一粒火星不漏——这才是一台好的燃烧机。

所以名字不是噱头：**Token 是燃料，Code 是它烧出来的东西。** 并行是炉子，燃烧是目的——「为并行而生」是肉身，「为 Token 燃烧而生」是灵魂。

它是什么

一个跑在终端里的编码 agent：你说一句话，它用 `read` / `write` / `edit` / `bash`、`ls` / `glob` / `grep`（文件检索）、`git_status` / `git_diff` / `git_commit`（git 专用）、`websearch` / `webfetch`（联网）工具读改文件、跑命令、查资料，循环直到把活干完。流式输出、会话自动落盘（`-continue` 随时接着聊）、可同步（`agent` / `workflow`）或异步（`spawn_agent` / `wait_agent` / `resume_agent` / `list_agents`）委托子代理与 JS 工作流编排，还能用 `cron_create` 注册会话内定时任务。核心是标准的 tool-use 循环：

用户消息 → LLM(带工具) → tool_use → 执行 → tool_result 回灌 → 循环 → 结束

• 走 Anthropic 协议，默认通过 DeepSeek 的 Anthropic 兼容端点接入，默认模型 deepseek-v4-pro[1m]。换 base URL 即可指向官方 Anthropic 或任何兼容服务。
• 单个静态二进制，开箱即用。

`/race`：并行竞赛模式

/race 8 修复 internal/foo 的并发 bug，跑通全部测试

派 N 个 agent（N≤1000）**各自在隔离的 git worktree** 里独立解同一道题（文件工具被硬隔离在各自写空间），窗口化并发；跑完后裁判流水线择优——客观粗筛（空 diff / `race.check` 校验命令淘汰，零 token）→ 并行 LLM 打分 → top-4 决赛。排行榜出来后 `/race apply` 一键应用冠军改动（不自动 commit），冠军分支保留可追溯。

配置 `race.good_enough`（1-10）可开启**够好即收**（败者退钱）：racer 冲线立即初评，首个达到够好线的当场夺冠并取消全场——排队的不再起跑、在跑的立即停手，没烧的 token 就是退回的预算。默认关闭（全员跑完再裁判）。

联网搜索

`websearch` 多后端自动回退：设置 `TAVILY_API_KEY` 时走 [Tavily](https://tavily.com)（LLM 友好摘录，免费档 1000 次/月），否则 DuckDuckGo → Mojeek 免 key 兜底——零配置可用，有配置更好。`webfetch` 抓网页转纯文本。

快速开始

export