CodewhaleMIT

Океан данных и кода

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

Codewhale даёт обычным людям рычаг LLM для создания вещей. В вашем терминале он читает репозиторий, правит файлы, запускает проверки и оставляет отчёт — не требуя, чтобы вы уже говорили на языке кода. Работает на вашей машине.

npm install -g codewhale

Последний релиз v0.9.2 · Текущие исходники v0.9.2: Маршруты провайдеров: 36 · MIT

Codewhale TUICurrent session
Current Codewhale terminal session showing Operate mode, the whale, composer, and footer
Current Codewhale session · Operate mode · Ask permission posture

Подводная терминальная оболочка. Нейтральна к моделям. Локальна прежде всего.

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

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

  1. 01

    Инспекция

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

  2. 02

    Действие

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

  3. 03

    Проверка

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

  4. 04

    Отчёт

    Оставляет краткий, долговечный след.

$ codewhale exec "fix the failing test"inspect   repository and instructionsact       edit through the selected permission postureverify    cargo test --lockedreport    checks passed · receipt saved

New to Codewhale? Four steps end to end.

Install → a first keyless session → provider connection → a first Fleet workflow. The nouns are defined on the vocabulary page.

  1. Install Codewhale

    One npm command installs the dispatcher and the terminal runtime. Cargo, prebuilt archives, Docker, Nix, and China mirrors are documented alternatives; every channel serves published releases only.

    npm install -g codewhale
    codewhale doctor
    Full install guide
  2. Open a first session — no key needed

    The runtime launches without any API key: a short constitution-first setup (language, provider readiness, runtime posture, your constitution), then the full interface. Explore in Plan mode — it is always read-only. Model replies need a provider; that is the next step.

    codewhale
    Learn the product nouns first
  3. Connect a provider

    Pick any supported route — a hosted key, a gateway, or a keyless local runtime such as Ollama, vLLM, or SGLang for fully local inference. Provider and model stay explicit; requested and effective reasoning plus routing source are separate provenance fields, and unavailable values stay unavailable.

    codewhale auth set --provider deepseek
    Providers and models
  4. Run a first Fleet workflow

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

    codewhale fleet init
    codewhale fleet run tasks.json --max-workers 4
    Fleet and Workflow docs

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

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

Маршруты провайдеров: 36
Облачные, шлюзовые и локальные модели
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 · Бинарные пакеты · Docker · Nix · Windows · Android / Termux · зеркала в Китае

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

Разработка открыто

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