Codewhale

Codewhale — это агент для программирования с открытым исходным кодом, работающий в терминале. Он написан на Rust и открыто развивается вместе со своими пользователями.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

Установка

npm install -g codewhale
codewhale

При первом запуске Codewhale поможет подключить провайдера или остаться в автономном режиме. Он также поддерживает Cargo, Docker, Nix, Scoop, готовые архивы, Android/Termux и зеркало CNB. См. руководство по установке.

Для автодополнения по Tab достаточно одной команды для каждой оболочки — codewhale completion bash|zsh|fish|powershell|elvish. См. автодополнение оболочки.

Использование

Обращайтесь к Codewhale так же, как к коллеге по команде:

Fix the failing tests and explain what changed.

Задачу можно запустить и без открытия TUI:

codewhale exec "fix the failing tests and explain what changed"

Codewhale умеет читать ваш репозиторий, редактировать файлы, выполнять команды, проверять результаты и продолжать работу над целью. Вы сами решаете, какой доступ ему предоставить.

Почему Codewhale

• Используйте нужную вам модель. Подключайте облачных провайдеров или локальные модели через Ollama, vLLM или SGLang. Переключайте провайдера и модель командой /model.
• Сохраняйте контроль. Режим Plan доступен только для чтения. Ask, Auto-Review и Full Access наглядно показывают порядок подтверждений. /undo отменяет последний ход, а /restore возвращает рабочую область к более раннему снимку.
• Организуйте длительную работу. Сохраняйте сеансы, задавайте постоянную /goal, проверяйте рабочие процессы перед запуском и координируйте агентов так, чтобы их внутренние инструкции не попадали в вашу переписку.
• Расширяйте уже настроенного агента. Подключайте серверы MCP и навыки, настраивайте хуки и храните роли агентов в виде понятных файлов в проекте или личных настройках.

Выполните /help в TUI, чтобы увидеть команды и сочетания клавиш.

Безопасность

Codewhale работает на вашем компьютере с предоставленным вами доступом. Режимы подтверждения и правила репозитория ограничивают действия агента; дополнительная песочница ОС создаёт более строгую границу выполнения там, где она поддерживается. Неизвестная цена модели отображается как неизвестная, а не как нулевая.

Точный порядок применения политик описан в разделе порядок авторизации, а локальные настройки — в разделе конфигурация.

Документация

• Провайдеры и локальные модели
• Команды агентов
• MCP, хуки и конфигурация
• Локальный веб-клиент
• Вся документация

Присоединяйтесь к сообществу

Codewhale становится лучше, когда люди пользуются им, сообщают о неудобствах и помогают их исправить. Если нужного провайдера нет, рабочий процесс неудобен или интерфейс терминала мешает работе, создайте issue. Если вы знаете, как это улучшить, откройте pull request. Мы рады первым вкладам, а авторство принятой работы сохраняется за участниками.

Присоединяйтесь к Discord или добавьте Hunter в WeChat (hunterbown) и попросите принять вас в группу Whale Brothers.

История проекта

Codewhale начинался как deepseek-tui и по-прежнему сохраняет совместимость с его конфигурацией и сеансами. Теперь он нейтрален к провайдерам, поддерживается независимо и не связан ни с одним поставщиком моделей.

Спасибо всем участникам и сообществам открытого исходного кода, которые помогли проекту вырасти. См. список участников.

Лицензия

MIT. Части, адаптированные из других проектов с открытым исходным кодом, указаны в уведомлениях о сторонних компонентах.