Orca: Satu Meja Kerja untuk Agen Koding, dari Tugas sampai Review

Beberapa terminal terbuka, agen masih bekerja, tetapi kamu lupa perubahan mana milik tugas yang mana? Orca menaruh agen, file, browser, dan review Git dalam satu tempat. Setiap tugas bisa punya ruang kerja sendiri, lalu kamu memeriksa hasil sebelum menggabungkannya.

Yang dibahas di sini adalah stablyai/orca, aplikasi desktop untuk mengelola agen koding. Bukan model bahasa Microsoft Orca, pembaca layar GNOME, atau proyek kripto.

Untuk apa Orca?

Memisahkan tugas. Perbaikan tombol dan penambahan fitur bisa dikerjakan di worktree berbeda, tanpa saling menimpa file kerja.
Meninjau sebelum menerima. Buka perubahan baris per baris, beri komentar, lalu minta agen memperbaikinya.
Menunjukkan bagian UI yang dimaksud. Design Mode mengirim konteks elemen halaman ke agen, jadi kamu tidak perlu menjelaskan “tombol yang sebelah kanan itu” panjang lebar.
Memantau dari ponsel. Mobile companion menampilkan status dan keluaran terminal, menerima balasan, serta memberi notifikasi selesai. Komputer tetap menjalankan agennya.

Mulai dengan satu hasil kecil: minta agen memperbaiki satu tampilan di satu worktree, lalu periksa diff-nya. Belum perlu lima agen atau otomasi berulang.

Orca bukan agen yang menulis kode

Bayangkan Orca sebagai meja kerja. Claude Code, Codex, OpenCode, atau Pi adalah pekerja yang kamu jalankan di meja itu. Model dan akun yang dipakai tetap mengikuti pengaturan agen.

Agen CLI: menerima instruksi, memakai alat, mengubah file.
Orca Desktop: mengatur terminal, worktree, editor, browser, dan review.
Orca CLI: memberi perintah ke Orca yang sedang berjalan. Ini bukan model AI baru.

Kalau satu terminal sudah cukup, pakai agen langsung juga masuk akal. Orca mulai berguna ketika kamu sering berpindah tugas atau perlu melihat beberapa pekerjaan sekaligus. Di tutorialnya, Lempa memakai Pi sebagai agen, bukan mengganti Pi dengan Orca (bab pengaturan agen, 5:54).

Pahami worktree dulu

Worktree adalah folder kerja lain dari repo Git yang sama, dengan branch dan file kerjanya sendiri. Misalnya:

perbaiki-menu: agen memperbaiki navigasi.
tambah-form: agen membuat formulir.
Branch utama: tetap jadi dasar yang kamu tinjau sebelum menerima perubahan.

Membuka dua terminal di folder yang sama tidak memisahkan file. Dua worktree yang berbeda memisahkannya. Setelah selesai, perubahan tetap harus ditinjau dan digabungkan lewat Git. Konflik saat merge masih mungkin terjadi.

Alur dari repo awal ke dua worktree terpisah, lalu review manusia dan penggabungan perubahan terpilih — Folder kerja terpisah membantu pembagian tugas. Review tetap menjadi pintu masuk ke branch utama.

Worktree bukan sandbox keamanan. Agen masih bisa mengakses file dan jaringan sesuai izin prosesnya. Folder terpisah tidak otomatis melindungi kunci API atau database produksi. Docs juga mengizinkan direktori tertentu dibagikan lewat symlink, jadi periksa pengaturannya sebelum menganggap semuanya terisolasi (docs worktree).

Instal dan siapkan satu agen

Langkah berikut berasal dari dokumentasi, bukan hasil uji instalasi di sini.

Unduh Orca dari halaman resmi. Tersedia untuk macOS Apple Silicon/Intel, Windows, dan Linux. Di Linux ada AppImage, .deb, dan .rpm; pilih paket serta arsitektur yang sesuai. Tidak perlu membangun dari source untuk mulai memakai aplikasi.
Siapkan Git dan satu agen CLI yang sudah bisa berjalan serta login di mesin itu. Pilih agen yang memang kamu gunakan. Kebutuhan runtime tambahan mengikuti CLI agen dan proyekmu, bukan satu versi Node universal untuk semua pengguna Orca.
Buka Orca, lalu periksa izin sebelum menjalankan tugas. Pilih Settings → Agents → Agent Permissions → Manual. Docs saat ini menyebut peluncuran baru memakai argumen bypass permission secara default. Jika kamu pernah mengubah argumen agen sendiri, periksa juga override-nya; perubahan global tidak menimpanya.
Tambahkan repo lewat Add Project. Pilih folder Git lokal. Folder biasa juga bisa ditambahkan, tetapi alur branch dan worktree membutuhkan repo Git.
Pilih agen di pengaturan. Pastikan executable, akun, model, dan batas penggunaan benar. Berhasil membuka terminal belum membuktikan model yang kamu inginkan benar-benar dipakai.

Untuk macOS dengan Homebrew, README menyediakan alternatif:

brew install --cask stablyai/orca/orca

Saat pertama dibuka, Orca meminta akses direktori home dan menawarkan impor pengaturan agen yang sudah ada. Tinjau akses itu. Untuk pengguna aplikasi desktop, jangan tertukar dengan syarat pengembangan repo Orca sendiri (docs instalasi).

Contoh pertama: rapikan satu tombol

Pakai repo latihan, bukan layanan produksi. Alur ini contoh yang disarankan, bukan demonstrasi yang sudah diuji di sini.

Buat worktree bernama rapikan-tombol dari branch dasar yang benar.
Jalankan satu agen di worktree tersebut. Pastikan izin masih Manual.
Beri tugas kecil dengan batas file dan kriteria selesai.
Jalankan preview sesuai petunjuk proyek. Buka URL lokalnya di browser Orca.
Periksa hasil di layar dan diff. Jalankan tes proyek yang relevan.
Jika sudah cocok, commit file yang memang ditinjau, lalu buat pull request. Gabungkan setelah pemeriksaanmu selesai.

Contoh instruksi:

Rapikan tombol kirim pada formulir kontak di worktree ini.
Tombol harus terbaca pada layar ponsel dan bisa dipakai lewat keyboard.
Jangan ubah backend, dependensi, atau konfigurasi deploy.
Sebutkan file yang berubah dan pemeriksaan yang dijalankan.
Jangan push, merge, atau deploy. Tunggu review saya.

Kalau hasilnya belum tepat, aktifkan Design Mode, pilih elemen tombol, lalu tulis koreksinya. Docs menyebut konteksnya mencakup HTML, computed CSS, dan screenshot elemen; lokasi source ikut tersedia bila ada source map. Ini membantu menjelaskan maksud, bukan menjamin hasilnya benar (docs Design Mode). Lempa memakai anotasi untuk mengubah tampilan dalam bab browser, 17:25.

Kapan menambah agen kedua?

Setelah satu agen bisa menyelesaikan tugas kecil dengan baik. Pilih pekerjaan yang jelas batasnya: agen pertama mengubah UI, agen kedua membaca hasil dan menyusun catatan tes.

Beri pemilik yang jelas untuk setiap file atau tugas.
Kalau pekerjaan kedua membutuhkan perubahan pertama, tunggu perubahan itu tersedia. Worktree baru tidak otomatis melihat file yang belum digabungkan dari worktree lain.
Pisahkan tugas menulis dan meninjau bila ingin pemeriksaan yang lebih independen.
Periksa hasil, bukan hanya status “done”.

Orca punya lapisan orchestration dengan Run, task, worker, pesan, dan decision gate. Docs menandainya Experimental. Gunakan bila perlu pelacakan kepemilikan dan ketergantungan tugas; tidak wajib untuk contoh pertama. Baca panduan yang sesuai versi aplikasi lewat orca skills get orchestration --full, jangan menyalin perintah lama orca orchestration run yang sudah dipensiunkan (docs orchestration).

Memantau dari ponsel

Mobile companion tersedia untuk iOS dan Android, masih berstatus beta menurut docs.

Pasang dari App Store atau APK Android resmi.
Buka alur pairing di Orca desktop, lalu masukkan kode sekali pakai di ponsel.
Pilih jalur koneksi yang sesuai. Docs menyarankan Orca Relay bila tersedia; Relay memerlukan sign-in. Pairing LAN membutuhkan alamat jaringan yang bisa dijangkau.
Coba membaca status dan membalas satu prompt sebelum mengandalkannya untuk pekerjaan panjang.

Ponsel adalah pengendali sesi di host, bukan tempat agen desktop tiba-tiba pindah berjalan. Host harus tetap hidup dan terjangkau. Kamu bisa membaca terminal, membalas, melihat perubahan, dan menerima notifikasi; aplikasi ini bukan editor desktop penuh (docs mobile).

Lempa melaporkan tampilan mobile kadang tersangkut loading dalam tutorial Juli 2026. Itu pengalaman presenter di versi saat itu, bukan bukti bug masih ada di versi sekarang (bab mobile, 20:13). Mobile companion ini juga bukan integrasi Telegram.

Skills, konteks, dan ingatan

Skill adalah instruksi agar agen tahu kapan dan bagaimana memakai alat Orca. Skill bukan model baru. Docs menyediakan orca-cli untuk operasi workspace dan orchestration untuk koordinasi worker.

Mulai dari Skills di aplikasi, baca isi serta target pemasangannya. Untuk memahami panduan yang cocok dengan versi aplikasi, setelah CLI terdaftar:

orca skills get orca-cli

Orca menghormati berkas instruksi agen seperti CLAUDE.md dan AGENTS.md, serta memiliki konteks worktree dan riwayat sesi. Itu tidak sama dengan membuktikan adanya memori pribadi global lintas semua pekerjaan atau sistem yang otomatis belajar membuat skill baru. Bukti yang diperiksa belum menetapkan kemampuan tersebut (hooks dan memory, skills).

Tiga peran: manusia menentukan tujuan dan review; Orca menata worktree, terminal dan browser; agen CLI memakai model untuk mengerjakan tugas — Orca mengatur ruang kerjanya. Agen mengerjakan tugasnya. Kamu menentukan batas dan menerima hasilnya.

Kalau ingin memantau lewat CLI

Bagian ini opsional. Daftarkan CLI lewat Settings → General → Orca CLI. Orca harus sedang berjalan untuk perintah status dan terminal berikut.

Linux: pakai orca-ide di shell milikmu. Perintah /usr/bin/orca dapat menunjuk pembaca layar GNOME. Di terminal yang dikelola Orca, docs menyebut shim orca tersedia. Contoh berikut untuk lingkungan yang sudah dipastikan menunjuk CLI IDE:

orca status --json
orca worktree ps --json
orca terminal list --json

Ambil handle terminal dari hasil daftar, lalu baca sebelum mengirim instruksi. Ganti HANDLE dengan handle nyata:

orca terminal read --terminal HANDLE --json
orca terminal wait --terminal HANDLE --for tui-idle --timeout-ms 30000 --json

Di Linux dari shell luar, ganti awal setiap perintah dengan orca-ide. Handle dapat berubah setelah runtime restart. Status idle berarti terminal sedang tidak sibuk menurut deteksi Orca, bukan bukti bahwa tes lolos atau tugas diterima. Cocokkan dengan output, perubahan file, dan hasil pemeriksaan (referensi CLI).

Biaya dan keamanan

Repo Orca berlisensi MIT. Itu tidak membuat penggunaan model gratis. Biaya atau kuota agen tetap mengikuti API atau langganan penyedia, ditambah komputer/server yang kamu gunakan. Lisensi repo juga bukan izin otomatis untuk semua materi pihak ketiga.
Jangan mulai dengan Yolo. Docs menyebut bypass permission sebagai default peluncuran baru. Pilih Manual, periksa argumen kustom, batasi folder dan akun. Jangan meniru saran mematikan pemeriksaan hanya agar agen jarang bertanya.
Jangan beri kunci produksi untuk latihan. Tinjau setup hook dan skill sebelum menjalankan. Worktree baru bisa menyalin berkas yang diabaikan Git, termasuk .env, bila dikonfigurasi begitu.
Pairing adalah akses ke host. Jaga kode dan token perangkat; jangan membuka layanan kendali ke internet tanpa memahami autentikasi dan jalur koneksinya.
Periksa data sebelum berbagi artefak. Terminal, prompt, screenshot, dan file bisa memuat rahasia.
Telemetri punya pengaturan sendiri. Docs menyebut data penggunaan anonim dan pilihan mematikannya di Settings → Privacy, atau environment DO_NOT_TRACK=1 / ORCA_TELEMETRY_DISABLED=1. Itu kebijakan telemetri Orca, bukan jaminan bahwa prompt tidak dikirim ke penyedia model.

Tidak ada benchmark RAM, kecepatan, atau penghematan biaya dalam panduan ini. Aplikasi desktop, setiap agen, browser, dan tes tetap memakai sumber daya.

Kalau ada masalah

Agen tidak mulai: pastikan CLI dan login berfungsi di host tempat agen dijalankan, lalu periksa executable serta akun yang dipilih.
File baru tidak terlihat di tugas lain: cek branch dan worktree. Perubahan yang belum digabungkan memang tidak otomatis muncul di checkout lain.
Preview bentrok: dua proyek bisa memakai port yang sama. Tentukan port berbeda sesuai konfigurasi proyek; jangan mematikan semua proses secara massal.
CLI Linux membuka aplikasi yang salah: pastikan memakai orca-ide, bukan pembaca layar GNOME.
Mobile offline: cek host masih berjalan, jalur jaringan, dan kecocokan versi desktop/mobile. Jika token pairing tidak lagi valid, ikuti alur pair ulang resmi.
Agen kedua memakai model yang salah: periksa konfigurasi agen dan bukti saat peluncuran. Nama workspace bukan bukti model.

Kapan tidak perlu Orca?

Kamu hanya punya satu tugas pendek dan nyaman dengan satu agen di terminal.
Masalah utamamu belum ada instruksi yang jelas atau tes yang bisa dipercaya. Menambah agen tidak menyelesaikan dua hal itu.
Kamu membutuhkan asisten percakapan lintas kanal dan memori pribadi. Panduan ini tidak menetapkan Orca sebagai penggantinya.

tmux cukup bila kebutuhanmu hanya mempertahankan sesi terminal. Orca menambah pengelolaan worktree dan review visual. Kalau yang kamu butuhkan pembagian kerja tim berulang dengan struktur perusahaan, panduan Paperclip membahas kebutuhan yang berbeda. Tidak perlu memasang semuanya sekaligus.

Sumber

Repo resmi stablyai/orca. Sumber yang ditinjau dipatok pada commit 165412b, 26 Oktober 2026. Instalasi sebaiknya mengikuti rilis stabil dan docs yang sesuai versimu.
Instalasi, worktree, agen dan izin, mobile, telemetri.
Christian Lempa, My NEW AI Terminal and Code Editor // Orca Review, 21 Juli 2026. Isi transkrip dibaca; segmen sponsor Morph bukan dasar klaim Orca.

Agent Reach berhasil mengambil teks subtitle Lempa, tetapi menghapus timestamp subtitle. Karena itu tautan waktu di sini adalah pintu masuk bab dari deskripsi, bukan sitasi detik ucapan. Subtitle video pendamping Eric Tech terkena HTTP 429; video itu tidak dipakai untuk mendukung klaim. Tidak ada video yang diunggah ulang. Tidak ada afiliasi dengan Orca atau kreator.