| 1 | # Menginstal Codewhale |
| 2 | |
| 3 | Halaman ini mencakup setiap jalur instalasi yang didukung dan penanganan masalah umum saat instalasi gagal, termasuk **Linux ARM64** dan platform lainnya. |
| 4 | |
| 5 | Jika Anda hanya menginginkan versi singkat, lihat [README utama](../../README.md#install) atau [README Bahasa Indonesia](../../README.id.md#instalasi). |
| 6 | |
| 7 | Perintah `latest` memilih rilis yang sudah diterbitkan, bukan build kandidat dari |
| 8 | kode sumber. Pada pemeriksaan 2026-09-04, rilis stabil terbaru adalah |
| 9 | [v0.9.11](https://github.com/Hmbown/CodeWhale/releases/tag/v0.9.11). |
| 10 | |
| 11 | --- |
| 12 | |
| 13 | ## 1. Skrip Instalasi Web (macOS & Linux) |
| 14 | |
| 15 | Untuk instalasi baru di macOS dan Linux, gunakan installer resmi GitHub: |
| 16 | |
| 17 | ```bash |
| 18 | curl -fsSL https://codewhale.net/install.sh | sh |
| 19 | ``` |
| 20 | |
| 21 | Skrip ini akan mengunduh biner rilis `codewhale` dan `codew` yang cocok, memverifikasinya terhadap `codewhale-artifacts-sha256.txt`, dan menginstalnya ke `~/.local/bin` secara bawaan. Nama aset `codewhale-tui-*` hanya dipertahankan untuk kompatibilitas updater lama dan bukan perintah ketiga. |
| 22 | |
| 23 | Di Windows, pilih installer atau arsip yang sesuai dari |
| 24 | [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases/latest). |
| 25 | Untuk instalasi biner langsung yang sudah ada: |
| 26 | |
| 27 | ```bash |
| 28 | codewhale update --check |
| 29 | codewhale update |
| 30 | ``` |
| 31 | |
| 32 | Updater menampilkan jalur executable yang diperbarui dan mencoba GitHub lebih |
| 33 | dahulu. Build yang lebih baru tetap dipertahankan; kandidat v0.9.12 tidak diturunkan |
| 34 | ke rilis publik v0.9.11. npm dan Cargo tetap tersedia sebagai pilihan sekunder. |
| 35 | |
| 36 | ### Direktori sudah terisi atau instalasi dikelola paket |
| 37 | |
| 38 | Installer tidak memakai `sudo` otomatis dan menolak berkas berbeda atau symlink |
| 39 | yang sudah ada. Updater juga mempertahankan berkas milik pengelola paket dan |
| 40 | menolak perintah lain di direktori yang sama bila isinya berbeda. Untuk migrasi, |
| 41 | buat direktori pengguna baru tanpa menghapus instalasi lama: |
| 42 | |
| 43 | ```bash |
| 44 | mkdir -p "$HOME/.local" |
| 45 | codewhale_install_dir="$(mktemp -d "$HOME/.local/codewhale-release.XXXXXX")" |
| 46 | curl -fsSL https://codewhale.net/install.sh | CODEWHALE_INSTALL_DIR="$codewhale_install_dir" sh |
| 47 | "$codewhale_install_dir/codewhale" --version |
| 48 | export PATH="$codewhale_install_dir:$PATH" |
| 49 | hash -r |
| 50 | command -v codewhale codew |
| 51 | ``` |
| 52 | |
| 53 | Setelah memverifikasi versi dan jalurnya, simpan direktori tersebut di awal PATH |
| 54 | dalam konfigurasi shell. Pembaruan berikutnya memakai |
| 55 | `"$codewhale_install_dir/codewhale" update`. Gunakan pengelola paket untuk memperbarui |
| 56 | salinan yang tetap dikelola npm atau Cargo. Lihat |
| 57 | [panduan migrasi dan PATH](../INSTALL.md#migrating-from-npm-cargo-or-another-installation) |
| 58 | untuk rincian, termasuk Windows. |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## 2. Platform yang Didukung |
| 63 | |
| 64 | Rilis v0.9.11 menyediakan aset GitHub berikut. Adanya aset bukan bukti pengujian |
| 65 | pada setiap perangkat; Android/Termux tetap berstatus pratinjau. Jalur npm dan |
| 66 | Cargo bergantung pada paket yang diterbitkan dan dukungan platformnya. |
| 67 | |
| 68 | | Platform | Arsitektur | Aset Rilis GitHub | `npm install` | `cargo install` | |
| 69 | | --- | --- | --- | :---: | :---: | |
| 70 | | Linux | x64 (x86_64) | `codewhale-linux-x64`, `codew-linux-x64` | ✅ | ✅ | |
| 71 | | Linux | arm64 | `codewhale-linux-arm64`, `codew-linux-arm64` | ✅ | ✅ | |
| 72 | | Android / Termux | arm64 (aarch64) | `codewhale-android-arm64.tar.gz` (pratinjau) | ⚠️ Pratinjau | ⚠️ Pratinjau | |
| 73 | | macOS | x64 | `codewhale-macos-x64`, `codew-macos-x64` | ✅ | ✅ | |
| 74 | | macOS | arm64 (M-series) | `codewhale-macos-arm64`, `codew-macos-arm64` | ✅ | ✅ | |
| 75 | | Windows | x64 | `codewhale-windows-x64.exe`, `codew-windows-x64.exe` | ✅ | ✅ | |
| 76 | | Windows | arm64 | `codewhale-windows-arm64.exe`, `codew-windows-arm64.exe` | ✅ | ✅ | |
| 77 | |
| 78 | Untuk platform tanpa prebuilt yang kompatibel, periksa dukungan toolchain dan |
| 79 | dependensinya pada [panduan build dari sumber](../INSTALL.md#7-build-from-source). |
| 80 | |
| 81 | --- |
| 82 | |
| 83 | ## 3. Instalasi via npm |
| 84 | |
| 85 | npm adalah pilihan instalasi sekunder yang memakai paket yang sudah diterbitkan: |
| 86 | |
| 87 | ```bash |
| 88 | npm install -g codewhale |
| 89 | ``` |
| 90 | |
| 91 | Bagi pengguna Linux/macOS, pastikan direktori biner global npm berada di dalam `$PATH` Anda. |
| 92 | |
| 93 | --- |
| 94 | |
| 95 | ## 4. Instalasi via Cargo (Kompilasi dari Sumber Kode) |
| 96 | |
| 97 | Jika Anda ingin mengompilasi biner langsung dari sumber kode menggunakan Rust: |
| 98 | |
| 99 | ```bash |
| 100 | cargo install codewhale-cli --locked |
| 101 | ``` |
| 102 | |
| 103 | Persyaratan sistem: |
| 104 | - Rust toolchain (versi stable terbaru) |
| 105 | - Dependensi `libdbus-1-dev` atau `pkg-config` pada Linux untuk integrasi keyring OS. |
| 106 | |
| 107 | --- |
| 108 | |
| 109 | ## 5. Android / Termux |
| 110 | |
| 111 | Termux berjalan di atas Bionic libc Android dan menggunakan `$PREFIX` sebagai |
| 112 | awalan Unix-nya. Dukungan perangkat tetap **pratinjau**. Gunakan arsip Android |
| 113 | `codewhale-android-arm64.tar.gz` dari rilis GitHub yang menyediakannya (termasuk |
| 114 | v0.9.11), verifikasi dengan `codewhale-bundles-sha256.txt` dari rilis yang sama, |
| 115 | lalu jalankan installer arsip dengan `PREFIX="$PREFIX"`. |
| 116 | Ikuti [langkah Android / Termux](../INSTALL.md#android--termux-arm64). |
| 117 | Installer web macOS/Linux dan aset `codewhale-linux-arm64` bukan jalur Android. |
| 118 | |
| 119 | Jika tidak ada arsip Android yang kompatibel atau Anda sedang memvalidasi build |
| 120 | dari sumber, Cargo tetap menjadi pilihan pratinjau di dalam Termux: |
| 121 | |
| 122 | ```bash |
| 123 | pkg install -y rust clang pkg-config make git |
| 124 | cargo install codewhale-cli --locked |
| 125 | ``` |
| 126 | |
| 127 | --- |
| 128 | |
| 129 | ## 6. Migrasi dari `deepseek-tui` |
| 130 | |
| 131 | Jika Anda sebelumnya menggunakan `deepseek-tui` atau menemui |
| 132 | `MISSING_COMPANION_BINARY`, gunakan migrasi GitHub ke direktori baru di atas dan |
| 133 | periksa jalur `codewhale` serta `codew`. Runtime saat ini berada dalam satu biner; |
| 134 | tidak perlu mengunduh runtime pendamping lain. |
| 135 | |
| 136 | Instalasi baru memakai `~/.codewhale/`; konfigurasi dan sesi lama di |
| 137 | `~/.deepseek/` tetap dapat dibaca sebagai fallback dan tidak dihapus otomatis. |
| 138 | Lihat [jalur lama](../LEGACY_PATHS.md) dan [catatan perubahan nama](REBRAND.md). |
| 139 |