CodeNomad: Kokpit AI Coding untuk OpenCode yang Lebih Bertenaga

Bagi para developer yang sering berkutat dengan sesi coding AI selama berjam-jam, OpenCode menawarkan mesin yang kuat. Namun, mesin ini membutuhkan "kokpit" yang presisi, cepat, dan jelas untuk mengendalikan setiap aspeknya. Di sinilah CodeNomad: Multi-instance OpenCode Desktop Client hadir. CodeNomad mengubah OpenCode dari sekadar alat berbasis terminal menjadi lingkungan kerja desktop premium, lengkap dengan kontrol, kecepatan, dan kejernihan yang dibutuhkan untuk developer modern.

Apa Itu CodeNomad?

CodeNomad adalah AI Coding Cockpit yang dirancang khusus untuk OpenCode. Jika OpenCode adalah mesin penggeraknya, CodeNomad adalah dasbor kontrol yang memberikan Anda kendali penuh. Ini dirancang bagi Anda yang membutuhkan lingkungan kerja terintegrasi untuk mengelola berbagai sesi coding AI secara bersamaan, mengaksesnya dari jarak jauh, dan berinteraksi dengan alat-alat pendukung lainnya.

Fitur Unggulan CodeNomad

CodeNomad datang dengan segudang fitur yang bertujuan untuk meningkatkan produktivitas Anda:

Multi-Instance Workspace: Kelola berbagai sesi coding secara paralel dalam satu antarmuka.
Remote Access: Akses lingkungan pengembangan Anda dari mana saja.
Session Management: Atur dan kelola sesi kerja Anda dengan mudah.
Voice Input & Speech: Integrasi suara untuk navigasi atau perintah.
Git Worktrees: Dukungan penuh untuk alur kerja Git Worktrees.
Rich Message Experience: Pengalaman pesan yang lebih kaya di dalam lingkungan kerja.
SideCars: Buka alat web lokal di dalam CodeNomad sebagai tab.
Command Palette: Akses cepat ke berbagai perintah melalui palet.
File System Browser: Telusuri sistem berkas dengan mudah.
Authentication & Security: Mekanisme otentikasi dan keamanan yang terjamin.
Notifications: Dapatkan pemberitahuan penting secara real-time.
Theming: Sesuaikan tampilan antarmuka sesuai preferensi Anda.
Internationalization: Dukungan untuk berbagai bahasa.

Memulai dengan CodeNomad

Anda bisa memilih untuk menjalankan CodeNomad sebagai aplikasi desktop atau sebagai server lokal yang dapat diakses melalui browser.

Aplikasi Desktop

CodeNomad tersedia dalam build Electron dan Tauri. Anda bisa memilih versi yang paling sesuai dengan preferensi Anda. Unduh installer terbaru untuk platform Anda dari halaman Releases mereka.

Berikut adalah format yang tersedia untuk setiap platform:

Platform	Format
macOS	DMG, ZIP (Universal: Intel + Apple Silicon)
Windows	NSIS Installer, ZIP (x64, ARM64)
Linux	AppImage, deb, tar.gz (x64, ARM64)

CodeNomad Server

Jika Anda lebih suka pengembangan jarak jauh atau mengakses melalui browser, Anda bisa menjalankan CodeNomad sebagai server lokal. Ini sangat ideal untuk tim atau jika Anda ingin mengakses lingkungan kerja dari perangkat lain.

Untuk memulai server, gunakan perintah berikut:

bash
npx @neuralnomads/codenomad --password <your-password> --launch

Otentikasi: Server ini memerlukan kata sandi saat pertama kali dijalankan. Anda dapat menyediakannya melalui argumen --password, variabel lingkungan CODENOMAD_SERVER_PASSWORD, atau dengan membuat berkas auth.json.

Sertifikat Self-signed: Saat pertama kali diluncurkan dengan HTTPS (pengaturan default), browser Anda mungkin menampilkan peringatan "Koneksi Anda tidak pribadi". Ini wajar karena server secara otomatis membuat sertifikat self-signed lokal. Cukup klik Advanced → Proceed to localhost untuk melanjutkan. Jika Anda hanya ingin menggunakannya secara lokal tanpa peringatan, jalankan dengan --https=false --http=true.

Anda juga bisa mencoba build terbaru dari cabang dev dengan:

bash
npx @neuralnomads/codenomad-dev --password <your-password> --launch

Mengintip Fitur SideCars

Fitur SideCars memungkinkan Anda membuka alat web lokal sebagai tab di dalam CodeNomad. Ini sangat berguna untuk mengintegrasikan alat pengembangan favorit Anda langsung ke workflow CodeNomad.

Konfigurasi umum untuk SideCars mencakup:

Name: Nama tampilan di CodeNomad.
Port: Layanan HTTP atau HTTPS lokal yang berjalan di 127.0.0.1:<port>.
Base path: Jalur yang dipasang di bawah /sidecars/:id.
Prefix mode:
- Preserve prefix: Meneruskan jalur /sidecars/:id/... secara penuh ke hulu.
- Strip prefix: Menghapus /sidecars/:id sebelum meneruskan permintaan ke hulu.

Berikut beberapa contoh konfigurasi SideCar:

VSCode (OpenVSCode Server)

Jalankan dengan Docker:

bash
docker run -it --init -p 8000:3000 -v "${HOME}:${HOME}:cached" -e HOME=${HOME} gitpod/openvscode-server --server-base-path /sidecars/vscode

Tambahkan SideCar sebagai:

Name: VSCode
Port: http://127.0.0.1:8000
Base path: /sidecars/vscode
Prefix mode: Preserve prefix

Terminal (ttyd)

Jalankan dengan:

bash
ttyd --writable zsh

Tambahkan SideCar sebagai:

Name: Terminal
Port: http://127.0.0.1:7681
Base path: /sidecars/terminal
Prefix mode: Strip prefix

Persyaratan Sistem

Sebelum Anda memulai, pastikan sistem Anda memenuhi persyaratan berikut:

OpenCode CLI: Harus terinstal dan berada di PATH sistem Anda.
Node.js 18+: Diperlukan untuk mode server atau saat membangun dari sumber.

Membangun dari Sumber

CodeNomad adalah monorepo yang dibangun dengan beberapa package. Jika Anda tertarik untuk berkontribusi atau sekadar ingin melihat "jeroannya", berikut adalah sekilas strukturnya:

Package	Deskripsi
`packages/server`	Logika inti & CLI, workspaces, proxy OpenCode, API, auth, speech.
`packages/ui`	Frontend SolidJS, reaktif, cepat, dan indah.
`packages/electron-app`	Shell desktop Electron, manajemen proses, IPC, native dialogs.
`packages/tauri-app`	Shell desktop Tauri (eksperimental).

Untuk memulai pengembangan, ikuti langkah-langkah cepat ini:

bash
git clone https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm install
npm run dev

Pemecahan Masalah

Beberapa masalah umum yang mungkin Anda temui dan solusinya:

macOS: "CodeNomad.app is damaged and can't be opened"
- Ini biasanya disebabkan oleh bendera Gatekeeper karena notarization yang hilang. Bersihkan atribut karantina dengan perintah:
```
bash
xattr -dr com.apple.quarantine /Applications/CodeNomad.app
```
- Pada Mac Intel, periksa juga System Settings → Privacy & Security pada peluncuran pertama.
Linux (Wayland + NVIDIA): Aplikasi Tauri segera tertutup
- Ini adalah masalah WebKitGTK DMA-BUF/GBM. Jalankan dengan:
```
bash
WEBKIT_DISABLE_DMABUF_RENDERER=1 codenomad
```

CodeNomad dibuat dengan cinta oleh Neural Nomads dan didistribusikan di bawah Lisensi MIT. Dengan kokpit canggih ini, sesi coding AI Anda akan terasa lebih teratur dan produktif.