omp (Oh My Pi) + JoinGonka Gateway: agen dengan peran model

Langkah 1: pasang omp. Cara resmi dari README proyek:

# macOS and Linux
curl -fsSL https://omp.sh/install | sh

# Homebrew
brew install can1357/tap/omp

# via Bun (requires Bun 1.3.14 or newer)
bun install -g @oh-my-pi/pi-coding-agent

# Windows (PowerShell)
irm https://omp.sh/install.ps1 | iex

Langkah 2: dapatkan kunci. Daftar di gate.joingonka.ai/register, konfirmasi alamat Anda, dan buat kunci dengan awalan jg- di bagian "Kunci API". Satu kunci dan satu saldo berlaku untuk semua model di jaringan.

Langkah 3: jalankan installer.

npx @joingonka/setup --tool omp

Installer akan menanyakan kunci — kunci tidak diteruskan melalui argumen baris perintah agar tidak tersimpan di riwayat shell — dan melakukan empat hal:

• menuliskan penyedia joingonka ke ~/.omp/agent/models.yml: alamat gateway, protokol openai-completions, kunci sebagai literal, dan tiga model jaringan dengan jendela konteks serta batas respons yang sebenarnya; file akan mendapat izin 600;
• menetapkan model default — modelRoles.default di ~/.omp/agent/config.yml — ke DeepSeek V4 Flash, tetapi hanya jika peran tersebut kosong atau menunjuk ke model yang sudah tidak ada di jaringan: installer tidak mengambil alih pilihan Anda, melainkan memberi tahu cara beralih;
• sebelum menulis, membuat cadangan file sebelumnya, dan membiarkan penyedia, peran, serta komentar lain tetap seperti semula;
• di akhir, mengirim permintaan langsung ke gateway dan memberi tahu secara jelas apakah kunci, alamat, dan model diterima.

Model default lain ditentukan dengan flag --model beserta singkatan deepseek, glm, atau minimax — model yang ditentukan secara eksplisit selalu dituliskan. Untuk dotfile dan server tersedia mode tanpa pertanyaan, di mana kunci diambil dari variabel lingkungan:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool omp --model glm --non-interactive

Installer menangani lokasi konfigurasi nonstandar secara otomatis: profil bernama (OMP_PROFILE) dan direktori agen yang dipindahkan (PI_CODING_AGENT_DIR). models.json warisan akan dipindahkannya ke models.yml sama seperti yang akan dilakukan omp sendiri — penyedia lama tidak akan hilang. Dan jika di sebelahnya terdapat settings.json lama tanpa config.yml, installer tidak akan membuat config.yml agar omp tidak melewatkan migrasi pengaturannya sendiri: installer akan meminta Anda menjalankan omp sekali dan mengulangi perintahnya.

Semua yang dilakukan installer bisa ditulis manual. Ada dua file, masing-masing punya tugasnya sendiri: models.yml mendeskripsikan provider dan model, config.yml menyimpan pengaturan — termasuk model mana yang menempati peran apa.

# ~/.omp/agent/models.yml
providers:
  joingonka:
    baseUrl: https://gate.joingonka.ai/v1
    api: openai-completions
    apiKey: jg-your-key
    models:
      - id: deepseek-ai/DeepSeek-V4-Flash-0731
        name: DeepSeek V4 Flash (Gonka)
        input: [text]
        contextWindow: 380000
        maxTokens: 32768
        reasoning: true
      - id: zai-org/GLM-5.3-Flash
        name: GLM-5.3 Flash (Gonka)
        input: [text]
        contextWindow: 390000
        maxTokens: 8192
        reasoning: true
      - id: MiniMaxAI/MiniMax-M2.7
        name: MiniMax M2.7 (Gonka)
        input: [text]
        contextWindow: 200000
        maxTokens: 8192

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

Kunci secara literal adalah pilihan paling bebas masalah: omp bisa dijalankan dari lingkungan mana pun, dan file cukup diamankan dengan chmod 600 ~/.omp/agent/models.yml. Ingin menyimpan kunci di luar file? Tuliskan nama variabel di apiKey, misalnya JOINGONKA_API_KEY, lalu ekspor variabel itu di shell tempat Anda menjalankan omp: urutan resolusi kunci seperti itulah yang dijelaskan dalam dokumentasi proyek.

Kolom opsional cost (harga per juta token) hanya diperlukan untuk memperkirakan biaya sesi di antarmuka omp. Installer mengisinya dengan harga gateway yang berlaku saat pemasangan; pada konfigurasi manual kolom ini boleh dihilangkan — perkiraan tersebut tidak memengaruhi tagihan Anda, pemakaian sebenarnya terlihat di dasbor.

Selektor model ditulis sebagai provider/model-id. Nama provider dipisahkan pada garis miring pertama, karena itu ID jaringan yang mengandung garis miring sendiri ditulis apa adanya: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731. Alih-alih mengubah config.yml, peran bisa ditetapkan dari antarmuka — lewat perintah /model di dalam sesi atau di wizard omp setup.

Di omp, model tidak dipilih satu untuk segalanya, melainkan berdasarkan peran — inilah tuas pengaturan utama. Peran bawaan untuk dialog: default, smol, slow, plan, commit, task, tiny, memory, advisor, dan vision. Tidak perlu menetapkan semuanya: peran smol dan slow yang tidak diatur secara otomatis mengambil model dari peran default, sub-agen tanpa peran task bekerja menggunakan model sesi saat ini, commit dan tiny mengikuti smol. Konfigurasi satu baris default saja sudah berfungsi penuh.

Membagi peran antar model jaringan dilakukan bukan demi penghematan — harga untuk DeepSeek V4 Flash, GLM-5.3 Flash, dan MiniMax M2.7 sama — tetapi demi perilaku dan kapasitas: model penalaran merencanakan lebih baik, model dengan respons panjang menulis lebih baik, dan hal-hal latar belakang yang sepele tidak perlu mengantre di baris yang sama dengan tugas utama.

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
  slow: joingonka/zai-org/GLM-5.3-Flash
  plan: joingonka/zai-org/GLM-5.3-Flash
  tiny: joingonka/MiniMaxAI/MiniMax-M2.7

retry:
  fallbackChains:
    default:
      - joingonka/zai-org/GLM-5.3-Flash

Blok retry.fallbackChains adalah asuransi untuk jam sibuk: ketika model utama terus-menerus menjawab 429, omp meneruskan sisa langkah ke urutan rantai berikutnya, lalu kembali ke utama setelah jeda. Kunci rantai bisa berupa peran, model tertentu, atau seluruh penyedia (joingonka/*).

Untuk satu kali jalan, peran dapat ditentukan ulang dengan flag: omp --model slow menjalankan sesi pada model peran slow, sementara --smol, --slow, dan --plan mengganti model peran itu sendiri. Di dalam sesi, Ctrl+P menelusuri model peran, dan /model membuka pemilihan; di tab Roles, Anda juga dapat menetapkan peran dan cadangannya.

Anda dapat menambahkan tingkat refleksi pada nilai peran — :low, :medium, :high. Ini adalah sintaks omp, dan bagaimana sebuah model memahami tingkat tersebut bergantung pada model itu sendiri: misalnya, GLM-5.3 Flash menggunakan sakelar biner — detailnya ada di ulasan model. Dan satu detail berguna lainnya: peran dapat didefinisikan ulang untuk satu repositori melalui file <repo>/.omp/config.yml dengan blok modelRoles yang sama. Penyedia dan kunci tetap berada di direktori rumah, sehingga kunci tidak akan masuk ke dalam repositori.

Pertama, pastikan omp mengenali provider-nya:

omp models joingonka

Sebagai balasan, muncul tabel berisi tiga baris dengan jendela konteks dan batas maksimum respons dari models.yml, dibulatkan ke ribuan (output dipersingkat: omp masih punya kolom thinking dan images):

joingonka (3)
model                                context  max-out
deepseek-ai/DeepSeek-V4-Flash-0731      380K      33K
MiniMaxAI/MiniMax-M2.7                  200K     8.2K
zai-org/GLM-5.3-Flash                   390K     8.2K

Berikutnya — uji coba sekali jalan tanpa antarmuka. Letakkan file dengan kesalahan yang jelas di direktori kosong dan minta agent menemukannya:

omp -p "Read calc.py and tell me in one sentence whether it has a bug."

Agent harus memanggil sendiri tool pembaca dan menjawab secara konkret — dengan menyebutkan ekspresi tempat kesalahan berada. Pada uji coba kami tanggal 21 September 2026, siklus ini — permintaan, pemanggilan tool, hasil, jawaban — dilalui dengan bersih oleh DeepSeek V4 Flash dan GLM-5.3 Flash; untuk MiniMax M2.7, lihat baris terakhir tabel di bawah.

Pemeriksaan ketiga — dari sisi gateway: di dashboard pada bagian "Usage", permintaan akan muncul di rincian "By models", dan di blok "By keys" waktu permintaan terakhir akan diperbarui. Jika kosong, berarti omp menghubungi provider lain: periksa apa yang ditetapkan pada role dengan perintah omp config get modelRoles.

Jika ada yang tidak beres, diagnosisnya biasanya langsung terbaca dari pesan errornya:

Alat agen menghabiskan token secara berbeda dibandingkan obrolan: untuk setiap frasa Anda, omp menambahkan prompt sistem dan deskripsi alat, dan tugas biasanya memakan beberapa langkah. Dalam percobaan kami, bahkan dengan satu alat pembaca diaktifkan, setiap langkah memakan sekitar 3,5 ribu token input; dengan set lengkap, jumlahnya akan lebih banyak. Oleh karena itu, harga per token di sini menjadi penentu.

Melalui JoinGonka Gateway, token dihargai $0.0069 per juta di input dan $0.021 per juta di output — harganya sama untuk semua model di jaringan dan ditarik di halaman ini dari sumber langsung.

Estimasi di kolom kanan berdasarkan harga per September 2026. Sebagai perbandingan — bagaimana cara membayar model di omp secara umum:

Bilah status omp menunjukkan estimasi biaya sesi. Dihitung berdasarkan kolom cost dari models.yml: penginstal memasukkan harga gateway saat instalasi, dan harga dolar di jaringan berfluktuasi seiring kurs GNK, jadi estimasi hanyalah referensi. Penggunaan tepat dan sisa saldo ada di dashboard, di bagian «Penggunaan» dan «Penagihan». Mengapa pilihan default jatuh pada DeepSeek V4 Flash dibahas secara mendetail dalam ulasan model.

Mode persetujuan. Secara default, omp berjalan dalam mode yolo: ia menyetujui sendiri pembacaan, penulisan, dan eksekusi perintah. Di proyek Anda sendiri ini praktis, tapi pada kode orang lain — alasan untuk memperketat mode atau pindah ke kontainer:

omp config set tools.approvalMode write

Dalam mode write, agen hanya meminta izin untuk eksekusi perintah; dalam always-ask — juga untuk penulisan. Untuk satu kali jalan, hal yang sama diatur oleh flag --approval-mode. Ini properti omp itu sendiri, tidak bergantung pada penyedia model.

Pi dan omp — kerabat dengan konfigurasi berbeda. Pengaturan satu alat tidak diwariskan ke yang lain: direktori, format, dan nama field-nya masing-masing berbeda.

Beberapa lingkungan. Profil bernama (omp --profile work atau variabel OMP_PROFILE) memindahkan semua pengaturan ke ~/.omp/profiles/<name>/agent — praktis untuk memisahkan kunci kerja dan pribadi. Direktori agen saat ini ditampilkan oleh omp config path.

Jika agen dibutuhkan di editor. omp bisa berjalan di dalam Zed lewat protokol ACP — ini agen yang sama dengan pengaturan yang sama, tak perlu menuliskan ulang penyedia dan peran.