context-labs/whip

whip – 一个用 Go 编写的快速编码代理工具

它是什么 – whip 是一个单一二进制命令行工具，用于运行 LLM 驱动的“工具使用”循环。它让语言模型能够读取、写入、编辑文件、运行 bash 命令，甚至生成子代理，所有这些都通过使用 Bubble Tea 构建的交互式终端 UI 完成。

为什么存在 – 作者认为现有的代理工具运行缓慢或需要大量配置。通过使用 Go 的并发原语（channels, goroutines），该程序可以进行并行工具调用、流式传输响应，并尽可能缩短从模型到用户的路径。

主要功能（如 README 所述）

• 速度导向设计 – 并行工具调用、流式 I/O，无额外运行时层。
• 独特的默认值 – 整合了来自 pi, opencode, codex 和 exo 等项目的想法；路线图文件引用了每个来源。
• 提供商路由模型 – 适用于任何兼容 OpenAI 的端点。它可以自动发现提供商（例如 OpenRouter）提供的每个模型，无需针对每个模型进行配置。
• 内置模型发现 – whip auth openrouter 可加载整个 OpenRouter 目录；whip auth codex 让您使用 ChatGPT/Codex 订阅登录，而非使用 API 密钥。
• 自动令牌处理 – 登录令牌存储在本地 (~/.codex/auth.json)，静默刷新，且绝不会在提示词中暴露。
• MCP 支持 – 在存储库中放入 .mcp.json 文件即可显示“MCP 服务器”，并可通过 /mcp 命令访问。
• 主题 – /theme 让您预览并选择终端配色方案。
• 便捷命令 –
  • /context-doctor – 审核新会话的令牌使用情况。
  • /goal <text> – 指示代理工作直到达成目标。
  • /model – 交互式选择模型，并从提供商目录获取实时更新。
  • /usage – 显示 Codex 订阅的速率限制信息。

安装

# 单行安装程序（下载适用于 Linux/macOS 的校验码验证二进制文件）
curl -fsSL https://raw.githubusercontent.com/context-labs/whip/main/install.sh | sh

或从源代码安装（需要 Go ≥ 1.27）：

go install github.com/context-labs/whip/cmd/whip@latest

安装后即可运行 whip 命令。

更新 – whip update 会重新运行安装脚本以获取最新版本。

文档 – 存储库包含一个 docs/ 文件夹，内含详细的 markdown 文件，涵盖架构、代理循环、并发模型、完整功能对照表，以及区分已发布功能与未来工作的路线图。

典型的第一步

/context-doctor   # 查看令牌注入详情
/goal Build a simple CLI tool
/model            # 选择模型（输入以筛选）
/theme            # 选择终端主题

按 Ctrl-C 一次可中断当前操作，按两次可退出程序。

---

以上所有信息均直接取自存储库的 README；未做任何额外假设。