Випуск 2026-08-12
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
відкрито#5334docs(i18n): retire the stale zh-Hant partial-pack declarationавтор @Lstarsky024 хв томузакрито#5321feat: register OrcaRouter as a named providerавтор @XiaoHuo888-hue52 хв томувлито#5332feat(config): register OrcaRouter as a named providerавтор @Hmbown52 хв томузакрито#5314Copy message from context menu includes rail decorations (● ▏) — make …автор @maimik2 год томузакрито#5319fix(tui): copy messages without visual railsавтор @XhesicaFrost2 год томувлито#5331fix(tui): copy messages without visual railsавтор @Hmbown2 год томузакрито#5267v0.9.5: turn-stop honesty (status that says ending must end)автор @Hmbown2 год томузакрито#5037Make web search and fetch a coherent, high-quality retrieval pathавтор @Hmbown2 год томузакрито#5041Make notifications actionable, predictable, configurable, and consiste…автор @Hmbown2 год томузакрито#5270v0.9.5: unified tasks surface (shell + subagents + durable workers)автор @Hmbown2 год томузакрито#5272v0.9.5: prompt-scoped file recovery (restore workspace from a prior pr…автор @Hmbown2 год томувідкрито#5333feat(tui): pin host terminal window as an always-on-top mini windowавтор @Hmbown2 год томувлито#5329fix(tui): move lru to 0.18 and unpin ratatui-core (RUSTSEC-2026-0253)автор @Hmbown3 год томувідкрито#5330fix(session): separate snapshot reads from crash recoveryавтор @Hmbown3 год томурелізv0.9.65 год томувідкрито#5320fix(session): separate snapshot reads from crash recoveryавтор @h3c-hexinучоравідкрито#5318feat(tui): pin host terminal window as an always-on-top mini windowавтор @SparkofSpikeучоравідкрито#5316EPIC-005: CodeWhale TUI Crate Decomposition (Umbrella)автор @aboimpintoпозавчоравідкрито#4949Discussion: The Chinese Translation of "Constitution" — "宪法", "协作准则", …автор @SparkofSpike15 дн. тому

Підводна термінальна оболонка. Будь-яка модель. На вашій машині.

Підключіть модель, якою вже користуєтеся — хмарну, шлюзову чи локальну. Режими 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
Інтерактивні та неінтерактивні інтерфейси рантайму

Використовуйте рантайм там, де відбувається робота.

TUIІнтерактивна робота в терміналі
codewhale execСкрипти та CI
ВебклієнтБраузерний клієнт лише через loopback
Runtime API + MCPЛокальні інтеграції
FleetСтійка багатоагентна робота
Інтерфейси рантайму та нотатки про стабільність →

Почніть з однієї команди.

npm install -g codewhale

CargoБінарні файлиDockerNixWindowsAndroid / Termuxдзеркала в Китаї

Читати посібник зі встановлення →

Розробляємо відкрито

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