Codewhale

August 7, 2026 · View on GitHub

Sebuah coding agent sumber terbuka untuk terminal Anda — bawa model pilihan Anda sendiri.

Codewhale berawal sebagai pengalaman asli (native) untuk DeepSeek. Sejak saat itu, proyek ini berkembang menjadi proyek yang didorong oleh komunitas: satu coding harness yang memenuhi kebutuhan komunitas internasional yang terus berkembang serta mendukung sebanyak mungkin model dan penyedia (provider) — mengutamakan model terbuka, baik yang di-host maupun lokal, tanpa membeda-bedakan satu sama lain.

Berikan penyedia, model, dan tugas: Codewhale akan membaca kode Anda, mengedit berkas, menjalankan perintah, serta memeriksa hasil kerjanya sendiri, lalu berhenti setelah pekerjaan selesai atau ketika membutuhkan arahan Anda. Ganti model di tengah tugas dengan /model. Bekerja secara interaktif di TUI, atau jalankan codewhale exec dalam skrip dan CI. Dibuat menggunakan Rust, berlisensi MIT, dan berjalan langsung di mesin Anda sendiri.

Yang membedakannya dari harness lain: Anda memilih model untuk setiap peran, dan model-model itu tidak harus sama. Sebuah fleet menyematkan penyedia, model, dan tingkat penalaran per peran — sehingga model yang murah dan cepat bisa mengarahkan model penalaran yang mahal, atau seorang builder GLM bisa mengerjakan tugas yang sama dengan seorang reviewer Kimi. Tulis peran Anda sendiri, constitution Anda sendiri, dan harness itu menjadi milik Anda, bukan milik kami.

Kami selalu membuka kesempatan bagi para kontributor dan cara untuk terus berkembang. Jika model atau penyedia yang Anda gunakan belum tersedia, atau ada hal yang tidak berjalan semestinya, memberi tahu kami adalah salah satu kontribusi paling berharga yang bisa Anda lakukan — lihat Kontribusi.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · codewhale.net · Docs · Changelog · Discord

CI crates.io npm Discord

Codewhale running in a terminal

Instalasi

npm install -g codewhale

Cargo, Docker, Nix, Scoop, arsip biner pra-kemas, Android/Termux, serta mirror CNB bagi siapa pun yang memiliki keterbatasan akses ke GitHub dibahas secara lengkap di docs/INSTALL.id.md (English). Bermigrasi dari deepseek-tui? Konfigurasi dan sesi Anda akan tetap dipertahankan — lihat docs/REBRAND.id.md (English).

Penggunaan

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

Di dalam TUI: /model mengganti penyedia dan model sekaligus, /fleet menjalankan tim pekerja (workers), /undo membatalkan langkah (turn) terakhir, dan /restore <N> mengembalikan workspace ke snapshot sebelumnya (/restore tanpa argumen hanya menampilkan daftarnya). Saat composer kosong, Tab beralih antar mode Plan / Act / Operate; bila composer berisi teks, Tab justru melengkapi perintah slash dan sebutan @. Shift+Tab beralih antar postur izin Ask / Auto-Review / Full Access kapan saja. ! menjalankan perintah shell melalui alur persetujuan normal.

Fitur & Kapabilitas

  • Model mana saja, penyedia apa saja. DeepSeek, Claude, GPT, Kimi, GLM, dan 30+ penyedia lainnya, ditambah vLLM, SGLang, atau Ollama milik Anda sendiri tanpa memerlukan API key — semuanya melalui satu runtime dan satu kumpulan alat. Batas konteks dan harga diambil dari rute sebenarnya, dan harga yang tidak diketahui ditampilkan sebagai unknown daripada $0.
  • Harness yang Anda tulis sendiri. Peran adalah berkas yang bisa Anda baca dan sunting — satu model, satu sikap perkakas, dan instruksi tetap untuk tiap peran — disimpan di dalam proyek agar tim berbagi, atau di samping pengaturan pribadi Anda agar ikut berpindah antar repo. Constitution mencatat bagaimana Anda ingin agen berperilaku di setiap sesi, sehingga harness mengikuti cara kerja Anda, bukan cara kami.
  • Read-only sampai Anda memberi izin lebih. Mode Plan tidak dapat mengubah berkas, dan gerbang persetujuan memproteksi perintah berisiko. Ketika sandbox OS membungkus perintah, Codewhale akan menginformasikannya: Seatbelt pada macOS (jika tersedia), serta opsi bubblewrap di Linux. Berkas constitution.json repositori dikompilasi menjadi pembatas penulisan yang bahkan tidak dapat dilewati oleh mode Full Access.
  • Pekerjaan yang dapat dilanjutkan. Fleet mencatat setiap langkah ke ledger bertipe append-only, sehingga fleet resume dapat melanjutkan pekerjaan tepat di mana Anda meninggalkannya.

Pelajari Lebih Lanjut

Topik lainnya — mode eksekusi (English), pintasan tombol (English), detail sandbox, MCP (English), runtime API, dan arsitektur — tersedia di dalam direktori docs serta di codewhale.net.

Kontribusi

Issue, PR, langkah reproduksi masalah, log, dan permintaan fitur semuanya merupakan kontribusi nyata pada proyek ini, dan kami sangat menyambut kontribusi pertama Anda. Jika sebuah PR tidak dapat di-merge secara langsung, maintainer akan memetik bagian yang berfungsi dan tetap memberikan kredit kepada pembuatnya — dalam commit, changelog, dan docs/CONTRIBUTORS.md.

Terima kasih kepada DeepSeek untuk model dan dukungan yang mengawali proyek ini, DataWhale 🐋 atas sambutan hangat ke dalam keluarga Whale Brother, serta OpenWarp dan Open Design atas kolaborasi dalam menghadirkan pengalaman terminal-agent yang lebih baik.

Lisensi

MIT. Sebuah proyek komunitas independen, tidak terafiliasi dengan penyedia model mana pun.

Star History Chart