Technology

Mengenal Oh My Pi (omp.sh) dan Pi Agent (pi.dev): Arsitektur, Cara Install, dan Analisis Lengkap

By Husni Mubarok August 15, 2026

Dua Pendekatan AI Coding: Gateway & Ekosistem vs Minimal Agent Harness

Saat membangun alur kerja coding berbasis AI di terminal, kita biasanya dihadapkan pada dua kebutuhan teknis yang berbeda:

  1. Sisi Akses, Quota Pooling & Integrasi IDE: Mengelola multi-akun OAuth, rotasi token agar tidak terkena rate limit, serta integrasi tool IDE langsung di CLI (LSP, DAP debugger, sub-agents, dan engine berbasis native Rust).
  2. Sisi Minimal & Extensible Harness: Menjalankan runtime coding agent yang ringan, modular, dan berbasis primitives sederhana yang mudah diekstensi via TypeScript tanpa beban bloatware.

Dua tool open-source yang merepresentasikan pendekatan ini secara solid adalah Oh My Pi (omp.sh) dan Pi Agent (pi.dev). Berikut bedah arsitektur, metode instalasi resmi, dan analisis perbandingannya.

Website & Repositori Resmi:

Oh My Pi (OMP)

Coding agent dengan built-in IDE tooling & multi-account gateway

Website: https://omp.sh

GitHub: github.com/can1357/oh-my-pi

Pi Coding Agent

Terminal-based minimal agent harness

Website: https://pi.dev

GitHub: github.com/earendil-works/pi

npm: @earendil-works/pi-coding-agent


1. Oh My Pi (OMP): A Coding Agent with the IDE Wired In

Oh My Pi (OMP) (omp.sh), dikembangkan oleh can1357, adalah coding agent terminal yang mengintegrasikan kapabilitas IDE secara langsung serta didukung engine native Rust untuk performa tinggi.

Fitur Utama Oh My Pi (OMP):

  • Integrasi LSP & DAP Bawaan: Memiliki client LSP (Language Server Protocol) dan DAP (Debug Adapter Protocol) langsung di dalam agent, memudahkan navigasi simbol, type-checking, dan debugging saat eksekusi kode.
  • Subagents & Plan Mode: Mendukung delegasi tugas modular ke sub-agent terisolasi serta mode perencanaan terstruktur sebelum agent melakukan perubahan berkas.
  • Hindsight Memory & Time-Traveling Syntax Rules (TTSR): Sistem memori kontekstual antar-sesi dan rule rewrite AST untuk memastikan kode hasil generasi sesuai standar codebase.
  • Auth Broker (Port 8765) & Auth Gateway (Port 4000 di /v1): Mengelola pooling akun OAuth (Google CloudCode/Antigravity, Anthropic, dsb.), auto-refresh token, dan menyediakan endpoint reverse-proxy yang kompatibel dengan protokol OpenAI / Anthropic.
  • Stats Engine Dashboard (Port 3847): Dashboard web lokal untuk memantau metrik penggunaan token harian, latensi per model, serta status kesehatan akun terhubung.

Cara Install & Menjalankan Oh My Pi:

OMP menyediakan script installer resmi dan opsi instalasi global via runtime Bun:

# Opsi 1: Script installer resmi omp.sh (Linux / macOS)
curl -fsSL https://omp.sh/install.sh | sh

# Opsi 2: Install global via Bun dari repository GitHub
bun install -g https://github.com/can1357/oh-my-pi

# 1. Login akun provider (misal Google / Anthropic)
omp auth login

# 2. Jalankan service Auth Broker
omp auth-broker serve

# 3. Jalankan Auth Gateway (Port 4000)
omp auth-gateway serve --no-auth --bind=0.0.0.0:4000

# 4. Buka antarmuka TUI agent di terminal
omp

2. Pi Agent (pi.dev): Minimal & Extensible Coding Agent Harness

Pi Agent (pi.dev), dimaintain di github.com/earendil-works/pi oleh tim Earendil Works / Mario Zechner, adalah coding agent terminal yang mengusung filosofi "minimal agent harness". Moto proyek ini: "There are many agent harnesses, but this one is yours."

Fitur dan Karakteristik Pi Agent:

  • Minimal Core & Primitives: Core CLI dirancang sangat ramping tanpa dependensi berlebih. Semua fungsionalitas tambahan (sub-agents, custom tools, reviewer khusus) dibuat via extension TypeScript modular.
  • Tree-Structured & Shareable History: Riwayat percakapan disimpan dalam bentuk graph/tree. Anda bisa bercabang (branch) antar state diskusi dengan /tree, mengekspor sesi ke HTML (/export), atau membagikannya langsung ke web viewer pi.dev/session/ via /share.
  • Multi-Provider & Fast Switching: Mendukung 15+ provider LLM (Anthropic, OpenAI, Google, Bedrock, Groq, Cerebras, xAI, OpenRouter, Ollama) dengan shortcut navigasi cepat (Ctrl+L / Ctrl+P).
  • Context Engineering Terstruktur: Mendukung AGENTS.md, SYSTEM.md, compaction otomatis saat konteks hampir penuh, serta custom prompt template via /name.
  • 4 Mode Operasi Fleksibel: TUI Interaktif, Print/JSON mode (pi -p "query"), JSON-RPC (stdin/stdout untuk integrasi tool lain), dan TypeScript SDK.

Cara Install & Menjalankan Pi Coding Agent:

Instalasi melalui paket npm resmi atau script installer:

# Opsi A: Install global via npm
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# Opsi B: Installer resmi pi.dev (Linux / macOS)
curl -fsSL https://pi.dev/install.sh | sh

# Menjalankan Pi Agent di workspace proyek
pi

# Mode one-shot print untuk automasi / pipe terminal
pi -p "Cek potensi vulnerability di package.json"

Perbandingan Kelebihan & Kekurangan

Oh My Pi (omp.sh)

Kelebihan:

  • Fitur IDE Terintegrasi: Bawaan LSP, debugger DAP, sub-agents, dan runtime native Rust.
  • Multi-Account Pooling: Menggabungkan kuota dari banyak akun untuk menghindari rate limit harian.
  • Universal Gateway: Berfungsi sebagai proxy backend untuk client luar (Cursor, VS Code, Zed, Pi Agent).

Kekurangan:

  • ✗ Memerlukan setup service lokal (manajemen port, auth-broker, gateway daemon).
  • ✗ Footprint instalasi lebih besar karena menyertakan engine IDE dan gateway.

Pi Agent (pi.dev)

Kelebihan:

  • Ramping & Transparan: Basis kode minimal, mudah diaudit dan dimodifikasi.
  • Ekstensibilitas TypeScript: Penambahan tool, hook, dan custom logic dapat dibuat dengan cepat.
  • Manajemen Sesi Tree: Branching riwayat diskusi sangat rapi dan mudah dibagikan via link web.
  • Dukungan Multi-Provider Luas: Terhubung langsung ke 15+ provider LLM tanpa perantara khusus.

Kekurangan:

  • ✗ Fitur kompleks seperti integrasi LSP membutuhkan extension tambahan.
  • ✗ Tidak memiliki fitur pooling multi-akun bawaan (memerlukan gateway seperti OMP jika ingin rotasi token).

Tabel Perbandingan Teknis

Kategori Oh My Pi (omp.sh) Pi Agent (pi.dev)
Website Resmi https://omp.sh https://pi.dev
Repositori GitHub github.com/can1357/oh-my-pi github.com/earendil-works/pi
Perintah Install curl -fsSL https://omp.sh/install.sh | sh npm i -g @earendil-works/pi-coding-agent atau curl -fsSL https://pi.dev/install.sh | sh
Filosofi Inti IDE-in-terminal, engine native Rust, multi-account gateway Minimal agent harness, primitives-first, ekosistem extension TypeScript
Dukungan LSP / Debugging Terintegrasi secara native (LSP & DAP built-in) Melalui modul extension

Panduan Memilih Tool Sesuai Kebutuhan

Gunakan Oh My Pi (omp.sh) jika:

  • Anda menginginkan coding agent terminal lengkap dengan integrasi LSP, DAP debugging, dan sub-agents tanpa harus menyusun extension sendiri.
  • Anda memiliki beberapa akun provider AI dan ingin mengagregasi kuota token agar proses coding tidak terhenti karena limit harian.
  • Anda memerlukan reverse proxy lokal serbaguna yang dapat melayani beragam editor sekaligus.

Gunakan Pi Agent (pi.dev) jika:

  • Anda menyukai arsitektur harness yang bersih, transparan, dan ingin membangun tooling atau workflow custom sendiri menggunakan TypeScript.
  • Anda membutuhkan fitur branching percakapan interaktif (tree history) dan kemudahan berbagi sesi debugging via web viewer.
  • Anda ingin menghubungkan agent ke alur automasi CLI, pipe terminal, atau backend Node.js SDK.

Kombinasi Praktis

Kedua tool ini dapat digunakan bersamaan secara efektif: jalankan Oh My Pi sebagai Auth Gateway lokal di port 4000 untuk menangani pooling akun dan rotasi token, lalu arahkan Pi Agent ke gateway tersebut sebagai provider OpenAI-compatible. Dengan cara ini, Anda memperoleh fleksibilitas harness Pi Agent dengan keandalan suplai token dari OMP.