Выпуск 2026-08-13
v0.9.5
Codewhaleлюбая модель, на вашей машине
★ 40.7k
Открытый код · Своя модель · В вашем терминале

Codewhale ныряет в глубину,
чтобы вам не пришлось.

Codewhale — кодинг-агент с открытым исходным кодом для вашего терминала. Дайте ему модель и задачу — он читает ваш код, правит файлы, сам запускает проверки и останавливается, когда работа сделана или ему нужны вы. Подойдёт любая модель, а можно и смешивать: закрепите за каждой ролью свою.

Установить Документация GitHub
установка одной строкой
npm install -g codewhale
нужен Node 18+ — тулчейн Rust не требуетсядругие способы →

cwПоследний релиз v0.9.6Текущие исходники v0.9.6маршрутов провайдеров — 40MIT

Codewhale TUIТекущий сеанс
Текущий терминальный сеанс Codewhale: режим Operate, кит, поле ввода и нижняя панель
Текущий сеанс Codewhale · режим Operate · режим разрешений Ask
ЭфирLIVE
открыт#5343test(release): tolerate shared-runner route latencyавтор @Hmbown-28 минвлит#5341chore(release): prepare v0.9.7автор @Hmbown-56 миноткрыт#5342fix(tui): restore bounded Auto-Review executionавтор @Hmbown-1 чоткрыт#5340[0.9.6] doctor: `first-run` / `update checkpoint` permanently stuck on…автор @pnbob1988-4 чоткрыт#5337Web: finish the #4934 dictionary spine — retire every isZh branch and …автор @Lstarsky0-17 чзакрыт#5320fix(session): separate snapshot reads from crash recoveryавтор @h3c-hexin-18 чвлит#5330fix(session): separate snapshot reads from crash recoveryавтор @Hmbown-18 чоткрыт#5333feat(tui): pin host terminal window as an always-on-top mini windowавтор @Hmbown-20 чвыпускv0.9.6-23 чоткрыт#5328FEAT-014: Command contract crate boundary (facets + shared types) for …автор @aboimpintoвчераоткрыт#5324agent tool: simplify the 32-field schema so models stop erroring on itавтор @Hmbownвчераоткрыт#5323**Regression in v0.9.5: Auto-Review mode silently blocks every Bash ca…автор @USTHzhangluвчераоткрыт#5322Regression: output area doesn't fill wide terminals (worked in v0.8.65…автор @M-Maciejпозавчераоткрыт#5318feat(tui): pin host terminal window as an always-on-top mini windowавтор @SparkofSpikeпозавчераоткрыт#5290fix(web): restore clickable controls on non-English routesавтор @Hmbown-5 дн.открыт#5060Workflow experimental search re-hardcodes a 16-worker ceiling instead …автор @Hmbown-11 дн.открыт#5055DeepSeek Pro effort mapping is hardcoded inline with no date-annotated…автор @Hmbown-11 дн.открыт#4949Discussion: The Chinese Translation of "Constitution" — "宪法", "协作准则", …автор @SparkofSpike-16 дн.

Подводная оболочка для терминала. Любая модель. На вашей машине.

Подключите модель, которой уже пользуетесь — облачную, через шлюз или локальную. Plan / Act / Operate и явные режимы разрешений держат погружение под вашим контролем.

Как он принимает решения

Правила видны прямо в ходе рассуждений

Фрагменты реальных сеансов — приоритет правил проекта виден в рассуждении модели, а не только заявлен на странице.

codewhale — thinking
ход рассуждений
# When the prior session's summary didn't match the repo…
› Per Article II (truth) and V (verification), I report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
→ Reported the uncommitted work the summary left out, instead of repeating the claim.
›

От задачи к проверенному изменению.

  1. 01

    Осмотр

    Читает репозиторий, его инструкции и задачу.

  2. 02

    Действие

    Правит файлы в рамках явных границ одобрения.

  3. 03

    Проверка

    Запускает проверки и изучает результат.

  4. 04

    Отчёт

    Оставляет краткую и долговечную квитанцию.

$ codewhale exec "fix the failing test"inspect   репозиторий и инструкцииact       правка в рамках выбранного режима разрешенийverify    cargo test --lockedreport    проверки пройдены · квитанция сохранена

Впервые в Codewhale? Четыре шага от начала до конца.

Установка → первый сеанс без ключей → подключение провайдера → первый воркфлоу Fleet. Термины — на странице словаря.

  1. Install Codewhale

    One npm command installs the dispatcher and terminal runtime. Cargo, archives, Docker, Nix, and China mirrors are documented alternatives — published releases only.

    npm install -g codewhale
codewhale doctor
    Full install guide →

  2. Open a first session — no key needed

    Launches without any API key: short constitution-first setup, then the full interface. Explore in Plan mode — always read-only. Model replies need a provider; that's the next step.

    codewhale
    Learn the product nouns first →

  3. Connect a provider

    Pick a supported route — hosted key, gateway, or keyless local runtime (Ollama, vLLM, SGLang). Provider and model stay explicit; reasoning and routing provenance stay separate, and unavailable values stay unavailable.

    codewhale auth set --provider deepseek
    Providers and models →

  4. Run a first Fleet workflow

    For durable workers, ordered phases, or receipts, author a reusable agent-team profile and launch a run. Fleet state lives in the workspace ledger; ordinary single tasks need none of this.

    codewhale fleet init
codewhale fleet run tasks.json --max-workers 4
    Fleet and Workflow docs →
Читать руководство «С чего начать» →Посмотреть словарь продукта →

Ваша модель.
Ваши границы.

Вы явно выбираете модель, рабочий режим и режим разрешений. Неизвестная стоимость остаётся неизвестной, а предварительные возможности прямо помечены как предварительные.

маршрутов провайдеров — 40
Облачные, шлюзовые и локальные модели
Plan · Act · Operate
От планирования только для чтения до автономной работы
Ask · Auto-Review · Full Access
Выберите режим разрешений под задачу
TUI · exec · web · API
Интерактивные и headless-интерфейсы рантайма

Используйте рантайм там, где идёт работа.

TUIИнтерактивная работа в терминале
codewhale execСкрипты и CI
Веб-клиентКлиент в браузере, только через loopback
Runtime API + MCPЛокальные интеграции
FleetДлительная работа нескольких агентов
Интерфейсы рантайма и заметки о стабильности →

Начните с одной команды.

npm install -g codewhale

CargoБинарные сборкиDockerNixWindowsAndroid / TermuxЗеркала в Китае

Читать руководство по установке →

Разрабатывается открыто

Лицензия MIT; проект формируют контрибьюторы, работающие над рантаймами, провайдерами, платформами, документацией и тестами.