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 — это быстрая оболочка для кодинг-агента, написанная на Go: LLM работает в цикле использования инструментов (bash, read, write, edit, subagent) внутри интерактивной сессии в терминале на bubbletea, чтобы работать с вашим кодом.
Чем он отличается от других кодинг-агентов вроде 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 или новее.
Почему он заточен под open-source модели?whip ставит на будущее, в котором предпочтение будет за open-source моделями. Поскольку за ними трудно уследить, он подхватывает модели на лету из каталога каждого провайдера, показывает новые в меню выбора и держит быструю дефолтную модель, идущую в ногу с передним краем.
Могу ли я использовать свою подписку ChatGPT/Codex вместо API-ключа?Да. Запустите whip auth codex и подтвердите одноразовый код — модели Codex этого аккаунта сразу появятся в /model. /usage показывает окна лимитов, логин хранится в ~/.codex/auth.json, а истекающие токены обновляются локально.
Как добавить MCP-серверы?Положите файл .mcp.json в свой репозиторий — и серверы просто появятся; /mcp показывает, что подключено. Инструменты для браузера и computer-use тоже описаны в документации.
Какие инструменты может запускать агент?bash, read, write, edit и subagent. Вызовы инструментов идут параллельно со полной стриминговой передачей, а фоновые сабагенты — это примитивы Go с проверкой компилятором (каналы вместо самописных промисов).
Почему whip такой быстрый?Скорость — его основное проектное ограничение: он написан на Go с параллельными вызовами инструментов и полным стримингом, поэтому между вами и моделью нет ничего, кроме цикла.
Size
69.5 MB
Stars
1.1K
Age
1mo
Commits · 90 Days