Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Perkakas MCP

omni init mendaftarkan OMNI sebagai server MCP, yang memberi agent perkakas yang bisa ia panggil sendiri tanpa lewat Anda. Halaman ini menjelaskan seluruh 25 perkakas. Host Anda hanya diberi tahu sebagiannya.

Yang diberitahukan ke host Anda

Definisi perkakas berada di awal setiap request, jadi perkakas yang tidak pernah dipanggil akan dibaca ulang pada setiap request di setiap sesi, bukan dibayar sekali saja. Karena itu OMNI hanya mengiklankan set yang bisa dipakai oleh tier host Anda:

tieryang diiklankan
Fullomni_retrieve, omni_explain_savings
Handoff-first, dan host apa pun yang tidak dikenali OMNIdua itu, ditambah omni_remember, omni_recall, omni_run, omni_find_noise, omni_context_breakdown, omni_history
MCP-onlykeempatnya, ditambah omni_run: tanpa hook, output tool milik host tidak pernah ditulis ulang, jadi omni_run satu-satunya jalan agar model membaca lebih sedikit

Host tier Full mendapat daftar terpendek justru karena shell-nya sudah dipasangi hook oleh OMNI. Diukur pada 256 sesi yang terekam, dua perkakas itu membawa 138 dari 149 panggilan dengan 467 byte, sedangkan enam sisanya memakan 1.631 byte untuk 11 panggilan sepanjang korpus. Host Handoff-first tidak pernah mendapat penulisan ulang pada output perkakas bawaannya, jadi MCP adalah satu-satunya pintu OMNI di sana dan tidak ada yang dipangkas.

Di Claude Code, daftar terpendek pun tetap ada ongkosnya, dan byte-nya justru bagian yang lebih kecil: host membuang seluruh cache prompt ketika sebuah server MCP tersambung atau terputus sementara perkakasnya sudah dimuat. Agent yang didukung menjelaskan artinya dan cara menjalankan hook tanpa server MCP.

Perkakas yang tidak diiklankan juga tidak bisa dipanggil di tier itu, jadi jalan kembalinya adalah CLI atau override:

perkakasdi host tier Full
omni_runomni exec <perintah>
omni_rememberomni remember '<fakta>'
omni_context_breakdownomni stats --view context
omni_historyomni stats --view detail, yang menggabung perintah berulang jadi satu baris berhitung, bukan satu baris per panggilan
omni_recall, omni_find_noisetidak ada padanan CLI; OMNI_MCP_TOOLS=all

OMNI_MCP_TOOLS=all mengiklankan seluruh 25 perkakas, dan omni doctor menyebutkan set mana yang sedang berlaku serta host mana yang terdeteksi:

  MCP tools:      2 of 25 advertised to claude_code (OMNI_MCP_TOOLS=all restores the rest)

Pastikan daftarnya terhadap binary Anda sendiri, bukan terhadap halaman ini:

{ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"p","version":"1"}}}'
  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'; } \
| omni --mcp | tail -1 | jq -r '.result.tools[].name'

Mengambil isi kembali

perkakasapa yang ia lakukan
omni_retrieveAmbil isi lengkap yang dihilangkan sebuah penanda, lewat handle-nya
omni_runJalankan perintah shell lalu kembalikan keluaran sulingannya
omni_signal_extractTarik sinyal dari teks mentah, tanpa pipeline hook

omni_run paling penting di host yang tidak bisa menulis ulang tool shell bawaannya. Di sana, ia satu-satunya jalan menuju keluaran sulingan, dan itu sebabnya omni init --cursor memasang sebuah aturan yang menyuruh agent mengutamakannya.

Memahami apa yang dikerjakan OMNI

perkakasapa yang ia lakukan
omni_explain_savingsRute, penyaring, byte masuk dan keluar, persentase hemat per perintah terkini
omni_historyPenyulingan terkini beserta penghematan dan rasio per panggilan
omni_context_breakdownRincian token menurut sumbernya untuk giliran saat ini
omni_densitySeberapa banyak sinyal dibanding kebisingan dalam sepotong teks
omni_budgetPemakaian anggaran token dan efisiensi kompresi untuk sesi ini

Keempat ini jawaban yang tepat untuk “apakah OMNI membantu di sini”. Tarik angkanya, jangan membentuk kesan.

Ingatan

perkakasapa yang ia lakukan
omni_rememberSimpan sebuah keputusan, jebakan atau batasan
omni_recallPencarian semantik lintas engram, pengetahuan dan riwayat penyulingan
omni_knowledgeKueri atau simpan pengetahuan proyek lintas sesi
omni_insightPersoalan dan pola galat berulang teratas di seluruh proyek
omni_adaptive_insightsPola pengambilan kembali, sebagai penilaian atas keefektifan penyulingan
omni_handoffEkspor keadaan sesi sebagai markdown yang bisa dibawa, tanpa perlu jaringan

omni_handoff hanya ada di MCP. Subperintah CLI dengan nama itu sudah dihapus.

Sesi dan pencarian

perkakasapa yang ia lakukan
omni_sessionKeadaan sesi: status, konteks, bersihkan
omni_searchCari di riwayat sesi ini
omni_queryKueri riwayat penyulingan dengan bentuk kueri yang tetap
omni_agentsAgent lain yang sedang aktif di proyek ini

Penyetelan

perkakasapa yang ia lakukan
omni_find_noiseAnalisis jejak mentah terkini untuk mencari kebisingan yang berulang

Sifatnya saran saja, dan pembelajarnya memperlakukan “berulang” sebagai “kebisingan”. Ia pernah menyarankan membuang ^metadata:, ^spec:, pagar blok kode dan ^\[stderr\], yang justru struktur dan kanal galat. Jangan pernah menempelkan keluarannya ke mana pun tanpa membacanya baris demi baris.

Loop

perkakasapa yang ia lakukan
omni_loop_statusCek status sekali panggil untuk orkestrator sebelum tiap iterasi
omni_loop_memoryBaca dan tulis ingatan loop yang selamat dari restart sesi
omni_set_loop_contextPerbarui konteks loop secara dinamis
omni_budget_statusStatus anggaran untuk iterasi ini. Panggil sebelum pekerjaan mahal.
omni_verifySebagai subagent pemeriksa, nilai pekerjaan terkini agent pembuat

Lihat Loop engineering.

Satu perkakas yang bukan perkakas

omni_auto_noise muncul sebagai sebuah string di kode sumber server dan bukan sebuah perkakas. Ia nama penyaring yang diteruskan ke pembangkit TOML. Memanggilnya mengembalikan -32602 tool not found.

Ia pernah salah hitung: grep atas kode sumber untuk "omni_*" mengembalikan 27, jadi 27 salah di mana pun ia muncul. Jalankan panggilan tools/list di atas untuk hitungannya.

Yang keluar dari permukaan

omni_context diiklankan sampai 0.7.7 dan tidak pernah sekali pun dipanggil di 253 sesi yang terekam, jadi ia memakan 189 byte di prefix setiap request untuk kapabilitas yang tidak pernah dijangkau siapa pun. Sekarang ia omni context <file>, yang tidak memakan biaya per request:

omni context src/ledger/mod.rs

Agen tetap bisa menjangkaunya lewat omni_run.