オープンソース · モデルは自分で選ぶ · ターミナルで動く

Codewhale は深く潜る。
あなたが潜る必要はない。

Codewhale は、ターミナルで動くオープンソースのコーディングエージェントです。モデルとタスクを渡せば、コードを読み、ファイルを編集し、自分でチェックを回して、仕事が終わるか、あなたの判断が必要になったところで止まります。モデルは何でも持ち込めます。混ぜてもいい — 役割ごとに別のモデルを固定できます。

1 行でインストール
npm install -g codewhale
Node 18+ が必要 — Rust ツールチェーンは不要その他の方法 →

cw最新リリース v0.9.6現在のソース v0.9.640 件のプロバイダールートMIT

Codewhale TUI現在のセッション
Operate モード、クジラ、入力欄、フッターが写った現在の Codewhale ターミナルセッション
現在の Codewhale セッション · Operate モード · 権限は Ask
速 報LIVE
オープン#5337Web: finish the #4934 dictionary spine — retire every isZh branch and @Lstarsky0 さん1時間前クローズ#5320fix(session): separate snapshot reads from crash recovery@h3c-hexin さん2時間前マージ#5330fix(session): separate snapshot reads from crash recovery@Hmbown さん2時間前オープン#5336fix(mcp): omit nextCursor when there are no further pages@xiaoray-blip さん2時間前オープン#5335serve --mcp responds to tools/list and resources/list with "nextCursor@xiaoray-blip さん2時間前オープン#5334docs(i18n): retire the stale zh-Hant partial-pack declaration@Lstarsky0 さん3時間前クローズ#5321feat: register OrcaRouter as a named provider@XiaoHuo888-hue さん3時間前マージ#5332feat(config): register OrcaRouter as a named provider@Hmbown さん3時間前クローズ#5314Copy message from context menu includes rail decorations (● ▏) — make @maimik さん4時間前クローズ#5319fix(tui): copy messages without visual rails@XhesicaFrost さん4時間前マージ#5331fix(tui): copy messages without visual rails@Hmbown さん4時間前クローズ#5267v0.9.5: turn-stop honesty (status that says ending must end)@Hmbown さん4時間前オープン#5333feat(tui): pin host terminal window as an always-on-top mini window@Hmbown さん5時間前リリースv0.9.67時間前オープン#5323**Regression in v0.9.5: Auto-Review mode silently blocks every Bash ca@USTHzhanglu さん14時間前オープン#5322Regression: output area doesn't fill wide terminals (worked in v0.8.65@M-Maciej さん20時間前オープン#5316EPIC-005: CodeWhale TUI Crate Decomposition (Umbrella)@aboimpinto さん一昨日オープン#4949Discussion: The Chinese Translation of "Constitution" — "宪法", "协作准则", @SparkofSpike さん15日前

水中のターミナルシェル。どんなモデルでも。あなたのマシンで。

すでに使っているモデルをそのまま持ち込めます — ホスト型、ゲートウェイ、ローカル。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 は初めてですか? 4 ステップで最後まで。

インストール → キー不要の最初のセッション → プロバイダー接続 → 最初の 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
Web クライアントループバック限定のブラウザクライアント
Runtime API + MCPローカル連携
Fleet永続的なマルチエージェント作業
ランタイムの各画面と安定性の注記を見る →

コマンド 1 つで始める。

npm install -g codewhale

CargoバイナリDockerNixWindowsAndroid / Termux中国ミラー

インストールガイドを読む →

公開の場でつくる

MIT ライセンス。ランタイム、プロバイダー、プラットフォーム、ドキュメント、テストにまたがる貢献者たちの手で形づくられています。