Số ra 2026-08-12
v0.9.5
Codewhalemọi mô hình, trên máy của bạn
★ 40.7k
Nguồn mở · Mang theo mô hình của bạn · Chạy trong terminal của bạn

Codewhale lặn xuống biển sâu
để bạn khỏi phải lặn.

Codewhale là tác nhân lập trình mã nguồn mở trong terminal của bạn. Giao cho nó một mô hình và một nhiệm vụ — nó đọc mã của bạn, sửa tệp, tự chạy kiểm tra, và dừng lại khi việc đã xong hoặc khi nó cần bạn. Mang bất kỳ mô hình nào, hoặc trộn nhiều mô hình: ghim một mô hình riêng cho từng vai trò.

Cài đặt Tài liệu GitHub
cài đặt một dòng lệnh
npm install -g codewhale
cần Node 18+ — không cần bộ công cụ Rustcách khác →

cwBản phát hành mới nhất v0.9.6Mã nguồn hiện tại v0.9.640 tuyến nhà cung cấpMIT

Codewhale TUIPhiên hiện tại
Phiên terminal Codewhale hiện tại hiển thị chế độ Operate, hình cá voi, khung soạn thảo và thanh chân màn hình
Phiên Codewhale hiện tại · chế độ Operate · mức quyền Ask
Trực tiếpLIVE
đã đóng#5314Copy message from context menu includes rail decorations (● ▏) — make …bởi @maimik41 phút trướcđã đóng#5319fix(tui): copy messages without visual railsbởi @XhesicaFrost41 phút trướcđã hợp nhất#5331fix(tui): copy messages without visual railsbởi @Hmbown41 phút trướcđã đóng#5267v0.9.5: turn-stop honesty (status that says ending must end)bởi @Hmbown1 giờ trướcđã đóng#5037Make web search and fetch a coherent, high-quality retrieval pathbởi @Hmbown1 giờ trướcđã đóng#5041Make notifications actionable, predictable, configurable, and consiste…bởi @Hmbown1 giờ trướcđã đóng#5270v0.9.5: unified tasks surface (shell + subagents + durable workers)bởi @Hmbown1 giờ trướcđã đóng#5272v0.9.5: prompt-scoped file recovery (restore workspace from a prior pr…bởi @Hmbown1 giờ trướcđã mở#5333feat(tui): pin host terminal window as an always-on-top mini windowbởi @Hmbown1 giờ trướcđã hợp nhất#5329fix(tui): move lru to 0.18 and unpin ratatui-core (RUSTSEC-2026-0253)bởi @Hmbown2 giờ trướcđã mở#5332feat(config): register OrcaRouter as a named providerbởi @Hmbown2 giờ trướcđã mở#5330fix(session): separate snapshot reads from crash recoverybởi @Hmbown2 giờ trướcđã đóng#2904Feature request: Persistent agent state and signed compressed KV cache…bởi @skiyo4 giờ trướcđã đóng#3307v0.9.3: Extract inline tests from the largest Rust files before deeper…bởi @Hmbown4 giờ trướcđã đóng#3978v0.9.3 Onboarding: import common project instruction files during cont…bởi @Hmbown4 giờ trướcđã phát hànhv0.9.64 giờ trướcđã mở#5321feat: register OrcaRouter as a named providerbởi @XiaoHuo888-hue21 giờ trướcđã mở#5320fix(session): separate snapshot reads from crash recoverybởi @h3c-hexinhôm quađã mở#5318feat(tui): pin host terminal window as an always-on-top mini windowbởi @SparkofSpikehôm qua

Một lớp vỏ terminal dưới lòng biển. Mọi mô hình. Trên máy của bạn.

Mang theo mô hình bạn đang dùng — hosted, gateway hoặc cục bộ. Plan / Act / Operate cùng các mức quyền khai báo rõ giữ cuộc lặn luôn trong tầm kiểm soát của bạn.

Xem cách nó quyết định

Luật lệ bạn quan sát được ngay trong mạch suy luận

Trích đoạn từ phiên thật — thứ bậc luật lệ của dự án thấy được trong suy luận của mô hình, không chỉ là lời hứa trên trang chủ.

codewhale — thinking
mạch suy luận
# 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.
›

Từ nhiệm vụ đến thay đổi đã kiểm chứng.

  1. 01

    Khảo sát

    Đọc kho mã, các hướng dẫn của nó và nhiệm vụ.

  2. 02

    Hành động

    Sửa tệp trong ranh giới phê duyệt rõ ràng.

  3. 03

    Xác minh

    Chạy các bước kiểm tra và xem kết quả.

  4. 04

    Báo cáo

    Để lại một biên nhận ngắn gọn, bền lâu.

$ codewhale exec "fix the failing test"inspect   kho mã và hướng dẫnact       sửa theo mức quyền đã chọnverify    cargo test --lockedreport    kiểm tra đạt · đã lưu biên nhận

Mới dùng Codewhale? Bốn bước từ đầu đến cuối.

Cài đặt → phiên đầu không cần khóa → kết nối nhà cung cấp → Workflow Fleet đầu tiên. Thuật ngữ được định nghĩa ở trang thuật ngữ.

  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 →
Đọc hướng dẫn bắt đầu →Xem thuật ngữ sản phẩm →

Mô hình của bạn.
Ranh giới của bạn.

Chọn rõ ràng mô hình, chế độ làm việc và mức quyền. Chi phí chưa biết vẫn được ghi là chưa biết, và những phần còn ở bản xem trước luôn được ghi nhãn đúng như vậy.

40 tuyến nhà cung cấp
Mô hình hosted, gateway và cục bộ
Plan · Act · Operate
Từ lập kế hoạch chỉ đọc đến vận hành tự chủ
Ask · Auto-Review · Full Access
Chọn mức quyền cho công việc
TUI · exec · web · API
Giao diện runtime tương tác và headless

Dùng runtime ngay nơi công việc diễn ra.

TUILàm việc tương tác trong terminal
codewhale execScript và CI
Ứng dụng webChạy trong trình duyệt, chỉ qua loopback
Runtime API + MCPTích hợp cục bộ
FleetCông việc nhiều tác tử, bền vững
Xem các giao diện runtime và ghi chú về độ ổn định →

Bắt đầu chỉ bằng một lệnh.

npm install -g codewhale

CargoBản nhị phânDockerNixWindowsAndroid / TermuxMirror Trung Quốc

Đọc hướng dẫn cài đặt →

Xây dựng công khai

Giấy phép MIT, được định hình bởi những người đóng góp trên khắp runtime, nhà cung cấp, nền tảng, tài liệu và kiểm thử.