Hunter Bown
5.8 KiB
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 ミラーにも対応しています。詳しくはインストールガイドをご覧ください。
使い方
チームメイトに話しかけるのと同じように、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 サーバーやスキルを接続し、フックを設定し、エージェントの役割をプロジェクトまたは個人設定内の読みやすいファイルとして管理できます。
コマンドとキーボードショートカットは、TUI で /help を実行して確認できます。
安全性
Codewhale は、あなたが許可した範囲のアクセス権で、あなたのマシン上で動作します。承認モードとリポジトリのルールがエージェントの操作を制限し、対応環境では任意の OS サンドボックスがさらに強固な実行境界を加えます。不明なモデル料金は、無料と表示せず不明のまま扱います。
正確なポリシーの適用順序は認可の順序、ローカル設定は設定ガイドをご覧ください。
ドキュメント
コミュニティに参加
Codewhale は、実際に使い、違和感を報告し、修正を手伝ってくださる皆さんとともに成長します。必要なプロバイダーがない、ワークフローが使いづらい、ターミナル UI が作業を妨げるといった場合は、issue を作成してください。改善方法をご存じなら、pull request を作成してください。初めてのコントリビューションも歓迎し、採用された成果にはコントリビューターのクレジットを残します。
Discord に参加するか、WeChat で Hunter（hunterbown）を追加して Whale Brothers グループへの参加を依頼してください。
プロジェクトの沿革
Codewhale は deepseek-tui として始まり、その設定とセッションとの互換性を現在も維持しています。今ではプロバイダーに依存せず、独立して保守されており、いかなるモデルプロバイダーとも提携していません。
すべてのコントリビューターと、プロジェクトの成長を支えたオープンソースコミュニティに感謝します。コントリビューターの記録もご覧ください。