Codewhale

Агент для програмування з відкритим кодом у вашому терміналі — модель приносите ви.

Codewhale починався як нативний інструмент для DeepSeek. Відтоді він виріс у проєкт, яким керує спільнота: єдине середовище для програмування, яке підходить міжнародній спільноті, що зростає, і підтримує якнайбільше моделей та провайдерів — відкриті моделі насамперед, хмарні чи локальні, жодна не має переваги перед іншими.

Дайте йому провайдера, модель і завдання. Він читає ваш код, редагує файли, виконує команди й перевіряє власну роботу, а потім зупиняється, коли робота завершена або коли йому потрібні ви. Перемикайте моделі в розпалі завдання командою /model. Працюйте інтерактивно в TUI або запускайте codewhale exec у скриптах і CI. Він написаний на Rust, поширюється за ліцензією MIT і працює на вашому комп'ютері.

Ми завжди шукаємо учасників і способи стати кращими. Якщо моделі чи провайдера, якими ви користуєтесь, бракує, або щось ламається, повідомити про це — одна з найкорисніших речей, які ви можете зробити — див. Участь у проєкті.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · codewhale.net · Документація · Журнал змін · Discord

Встановлення

npm install -g codewhale

Cargo, Docker, Nix, Scoop, готові архіви, Android/Termux, а також дзеркало CNB для тих, хто не може отримати доступ до GitHub, описані в docs/INSTALL.md. Переходите з deepseek-tui? Ваші налаштування й сесії переносяться — див. docs/REBRAND.md.

Використання

codewhale auth set --provider deepseek   # or export ANTHROPIC_API_KEY, etc.
codewhale                                # open the TUI
codewhale exec "fix the failing test"    # headless
codewhale web                            # local browser client on 127.0.0.1

У TUI: /model перемикає провайдера й модель разом, /fleet запускає команду працівників, /undo скасовує останній крок, а /restore <N> відкочує робочу копію до давнішого знімка (/restore без аргументу лише виводить їхній список). Коли поле введення порожнє, Tab циклічно перемикає Plan / Act / Operate; якщо в полі є текст, Tab доповнює слеш-команди та згадки @. Shift+Tab перемикає режими дозволів Ask / Auto-Review / Full Access будь-коли. ! виконує команду оболонки через звичайний шлях затвердження.

Що він уміє

• Будь-яка модель, будь-який провайдер. DeepSeek, Claude, GPT, Kimi, GLM та понад 30 провайдерів, а також власні vLLM, SGLang чи Ollama без жодного ключа — усе через одне середовище виконання й один набір інструментів. Ліміти контексту й ціни беруться з реального маршруту, а невідома ціна показується як невідома, а не як $0.
• Лише читання, доки ви не дозволите більше. Режим Plan не може змінювати файли, а ризиковані команди проходять через затвердження. Коли пісочниця ОС справді обгортає команду, Codewhale каже про це: Seatbelt на macOS, де він доступний, і bubblewrap за бажанням на Linux. constitution.json репозиторію компілюється у блокування запису, які не може обійти навіть Full Access.
• Робота, яку можна відновити. Флот записує кожен крок до журналу, що лише доповнюється, тож fleet resume підхоплює роботу з місця, де ви зупинились.

Дізнатися більше

• docs/PROVIDERS.md — кожен маршрут провайдера: хмарний, шлюзовий і локальний
• docs/FLEET.md — флоти, журнал і відновлення
• docs/WORKFLOW_EXPERIMENTAL_SEARCH.md — заморожений, нейтральний до провайдерів експериментальний пошук у Workflow
• docs/CONFIGURATION.md — config.toml, хуки й конституція
• docs/AUTHORIZATION_ORDER.md — як поєднуються режими, хуки, правила дозволів, мінімальні вимоги безпеки, правила репозиторію, затвердження та пісочниця
• docs/HOOKS.md — одинадцять подій хуків життєвого циклу TUI, їхні корисні навантаження та три з них, що можуть скеровувати хід (codewhale exec і підкоманди CLI хуків не запускають)
• docs/WEB.md — браузерний клієнт, доступний лише через loopback, і його межа одноразової автентифікації

Усе решта — режими, комбінації клавіш, деталі пісочниці, MCP, API середовища виконання й архітектура — знаходиться в docs і на codewhale.net.

Участь у проєкті

Звіти про проблеми, PR, кроки відтворення, журнали й побажання щодо функцій — усе це справжня робота над проєктом, і перші внески вітаються. Коли PR не можна злити як є, супровідники забирають те, що працює, і зберігають авторство — у коміті, в журналі змін і в docs/CONTRIBUTORS.md.

• Відкриті issues — тут живуть хороші перші внески
• CONTRIBUTING.md — налаштування середовища розробки й процес PR
• docs/CONTRIBUTORS.md — усі, хто сформував цей проєкт
• Buy me a coffee

Дякуємо DeepSeek за моделі й підтримку, з яких почався проєкт, DataWhale 🐋 за те, що прийняли нас у родину Китових Братів, а також OpenWarp і Open Design за співпрацю над досвідом термінального агента.

Ліцензія

MIT. Незалежний проєкт спільноти, не пов'язаний із жодним провайдером моделей.