Codewhale

Một runtime. Các model hosted và local được hỗ trợ. Máy của bạn.

Codewhale là một coding agent cho terminal của bạn. Hoạt động với các model hosted và local được hỗ trợ; ưu tiên model mở. Đưa cho nó một provider, một model và một nhiệm vụ: nó đọc code của bạn, sửa file, chạy lệnh, kiểm tra công việc của mình, và dừng lại khi nhiệm vụ hoàn thành hoặc cần đến bạn. Đổi model giữa chừng bằng /model. Dùng TUI cho công việc tương tác, codewhale exec cho script và CI. Viết bằng Rust, giấy phép MIT, chạy trên máy của bạn.

Vì sao chọn Codewhale:

• Không bị khóa chân. DeepSeek, Claude, GPT, Kimi, GLM, hơn 30 provider, và vLLM, SGLang hay Ollama của riêng bạn — không cần key — đều chạy qua một runtime và một bộ công cụ. Ngân sách ngữ cảnh và giá lấy từ route thật; giá chưa rõ hiển thị là chưa rõ, không bao giờ là $0.
• An toàn từ thiết kế. Chế độ Plan chỉ đọc. Mọi lệnh gọi rủi ro đều qua phê duyệt. Codewhale chỉ báo sandbox lệnh của hệ điều hành khi lệnh thực sự được bọc: Seatbelt trên macOS khi khả dụng và bubblewrap trên Linux khi đã cài đặt và bật rõ ràng. Windows hiện báo không có sandbox. constitution.json của repo được biên dịch thành các chốt chặn ghi mà ngay cả Full Access cũng không thể bỏ qua.
• Công việc không mất. Fleet ghi lại từng bước vào sổ cái chỉ ghi thêm; fleet resume tiếp tục từ chỗ bạn dừng. Mỗi lượt đều để lại một biên nhận bạn có thể kiểm tra.

Sinh ra từ deepseek-tui. Cộng đồng của nó cần nhiều provider hơn, nên chúng tôi xây một runtime nơi model là một linh kiện, không phải sản phẩm.

English · 简体中文 · 日本語 · 한국어 · Español · Português · codewhale.net · Docs · Changelog

Cài đặt

npm install -g codewhale

Cargo, Docker, Nix, Scoop, archive dựng sẵn, Android/Termux, và một mirror CNB cho người dùng không truy cập được GitHub đều được hướng dẫn trong docs/INSTALL.md. Chuyển từ deepseek-tui sang? Cấu hình và session của bạn được giữ nguyên — xem docs/REBRAND.md.

Sử dụng

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

Trong TUI: /model đổi provider và model cùng lúc, /fleet chạy một đội worker, và /restore hoàn tác một lượt. Khi vùng soạn thảo đang rảnh, Tab chuyển vòng qua Plan / Act / Operate và Shift+Tab chuyển vòng qua tư thế quyền Ask / Auto-Review / Full Access. ! chạy một lệnh shell qua đường phê duyệt bình thường.

Tìm hiểu thêm

• docs/PROVIDERS.md — mọi route provider: dịch vụ, gateway và cục bộ
• docs/FLEET.md — fleet, sổ cái và resume
• docs/CONFIGURATION.md — config.toml, hook và constitution
• docs/WEB.md — trình duyệt nhúng chỉ chạy trên loopback và ranh giới xác thực dùng một lần

Mọi thứ còn lại — chế độ, phím tắt, chi tiết sandbox, MCP, runtime API, kiến trúc — nằm trong docs và trên codewhale.net.

Đóng góp

Mọi phản hồi đều là một món quà. Issue, PR, các bước tái hiện lỗi, log, yêu cầu tính năng và những đóng góp đầu tiên đều là công việc thực sự của dự án. Khi một PR không thể merge nguyên trạng, maintainer sẽ harvest phần dùng được và tác giả vẫn được ghi công — trong commit, trong changelog và trong docs/CONTRIBUTORS.md. Nếu một model hay provider bạn dùng còn thiếu, hoặc có gì đó hỏng trên máy của bạn, báo cho chúng tôi biết là điều hữu ích nhất bạn có thể làm.

• Issue đang mở — những đóng góp đầu tiên phù hợp nằm ở đây
• CONTRIBUTING.md — thiết lập môi trường dev và quy trình PR
• docs/CONTRIBUTORS.md — tất cả những người đã góp phần định hình dự án
• Buy me a coffee

Cảm ơn DeepSeek vì các model và sự hỗ trợ đã khởi đầu dự án, DataWhale 🐋 vì đã chào đón chúng tôi vào đại gia đình Whale Brother, và OpenWarp cùng Open Design vì đã hợp tác xây dựng trải nghiệm agent trên terminal.

Giấy phép

MIT. Dự án cộng đồng độc lập; không trực thuộc bất kỳ nhà cung cấp model nào.