whip README

The project's README from github.com/context-labs/whip. As one markdown file: README.md.

              █   ▀    
        █ ▄ █ █▀█ █ █▀█
        ▀▄▀▄▀ █ █ █ █▄█
         ▀ ▀  ▀ ▀ ▀ █  
        whip — a fast coding-agent harness in Go

An LLM tool-use loop (bash / read / write / edit / subagent), an interactive bubbletea session, and provider-routable models. One binary, no runtime, config you can read.

Why whip

Install

curl -fsSL https://raw.githubusercontent.com/context-labs/whip/main/install.sh | sh

Checksum-verified prebuilt binaries (Linux/macOS, x64/arm64). Or from source (Go ≥ 1.27):

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

Then whip and you're in. Defaults to inference.net models — any OpenAI-compatible endpoint works as a provider. One command wires up OpenRouter's whole catalog (/model lists every model, no per-model config):

whip auth openrouter   # masked key prompt — or /auth openrouter in-session

To update to the latest release later, run whip update — it re-runs the install script above.

Codex subscription

Whip can use an existing ChatGPT/Codex subscription instead of an API key. Run whip auth codex and follow the displayed URL and one-time code. On approval, Whip saves the login and adds the account's available Codex models to /model immediately. The same flow is available from an active session with /auth codex. /usage shows the subscription's rate-limit windows; whip auth codex logout removes the provider from Whip again.

Whip saves the login in ~/.codex/auth.json. Expiring tokens refresh locally and are never printed or added to conversations. Whip fetches the signed-in account's https://chatgpt.com/backend-api/codex/models catalog and refreshes it every 24 hours (or with /model refresh), so plan and rollout availability come from the backend rather than a hard-coded list. gpt-5.5 @ codex-subscription remains as a compatible fallback route. OAuth credentials are only sent to https://chatgpt.com/backend-api.

First things to try

/context-doctor     audit what a fresh session injects, in tokens
/goal <text>        work until done
/model              pick a model — type to filter (new) entries come from the
                    provider catalog, no config needed

Drop a .mcp.json in your repo and MCP servers just appear (/mcp to see them). ctrl+c once interrupts; twice quits.

Docs

The full setup, config reference, MCP, browser/computer-use, and how everything works: docs/README.md.

Highlights:

whip (context-labs/whip)

Searching Database…

1.1K ·GitHub
Whip
这是什么？whip 是一个用 Go 编写的高速编码智能体框架：大语言模型在交互式的 bubbletea 终端会话中运行工具调用循环（bash、read、write、edit、subagent），帮你处理代码。
它和 opencode、codex 这类编码智能体有什么不同？它是一个单独的 Go 二进制文件，不需要任何运行时，配置也清晰易读。whip 从 pi、opencode、codex 和 exo 中汲取最好的思路，整合成一个立场鲜明的框架，而不是自己另搞一套模式。
怎么安装和启动？安装经过校验和验证的预编译二进制文件（Linux/macOS，x64/arm64），或者用 Go 1.27 或更新版本从源码构建，然后直接运行 whip 就行。按一次 ctrl+c 中断，按两次退出；以后可以用 whip update 升级。
需要 API 密钥吗？能用哪些模型？不需要运行时，也不用针对每个模型单独配置：任何兼容 OpenAI 的接口都可以作为提供商使用。whip 默认使用 inference.net 的模型，一条命令就能接入 OpenRouter 的全部模型目录，通过 /model 即可浏览。
有 Windows 版本吗？预编译二进制文件只提供 Linux 和 macOS（x64/arm64）版本，Windows 用户需要自己从源码编译，这要求安装 Go 1.27 或更新版本。
它为什么面向开源模型打造？whip 押注于开源模型将成为首选的未来。由于跟进开源模型的更新很难，它可以从每个提供商的目录实时发现模型，在模型选择器中展示新模型，并保留一个紧跟前沿的快速默认选项。
我可以用 ChatGPT/Codex 订阅代替 API 密钥吗？可以。运行 whip auth codex 并批准一次性代码，账户的 Codex 模型会立即出现在 /model 里。/usage 可以查看限流窗口，登录信息保存在 ~/.codex/auth.json，过期的令牌会在本地自动刷新。
怎么添加 MCP 服务器？在你的仓库里放一个 .mcp.json 文件，服务器就会自动出现——用 /mcp 可以查看已连接的服务器。浏览器和计算机操作工具的使用方法文档里也有说明。
智能体可以使用哪些工具？bash、read、write、edit 和 subagent。工具调用并行执行，所有输出都是流式的，后台 subagent 是经过编译器检查的 Go 原语（用 channel 而不是手写的 promise）。
whip 为什么这么快？速度是它的核心设计约束：它用 Go 编写，支持并行工具调用和完整流式输出，在你和模型之间只有一个循环，没有别的开销。
What are similar projects?Baize, jcode, maki, magpie, SystemOneHarness, Rapid-MLX, tuios, OpenHarness
Which topics is it in?bubbletea, mcp-client, subagents, tool-calling, openrouter, harness, tui, openai-compatible, streaming, coding-agent, performance, go
Creator
context-labs
Size
70.7 MB
Stars
1.1K
Updated
CommitOct 17Releasev1.0.0Sep 25
Age
1mo
Commits · 90 Days