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

Pasang

Instalasi yang sudah ada tetap berfungsi dengan nama omni, yaitu program yang sama dengan contexere.

Ambil binary-nya

macOS dan Linux, lewat Homebrew:

brew install fajarhide/tap/contexere

macOS, Linux, WSL:

curl -fsSL omni.weekndlabs.com/install | bash

Windows, PowerShell:

irm omni.weekndlabs.com/install.ps1 | iex

Dari sumber, yang butuh toolchain sesuai pin di rust-toolchain.toml:

git clone https://github.com/fajarhide/contexere
cd contexere
cargo build --release

Dari dalam Claude Code, kalau Anda lebih suka agent yang mengurus sisanya:

/plugin marketplace add fajarhide/contexere
/plugin install contexere@omni

Di agent mana pun yang membaca skill, skill yang sama bisa dipasang lewat CLI direktori skill:

npx skills add fajarhide/contexere --skill contexere

Lewat jalur mana pun, yang terpasang adalah sebuah skill, bukan binary-nya. Skill tersebut membawa perintah pemasangan di bawah, langkah verifikasinya, dan cara membaca penanda, supaya agent berhenti menebak-nebak ketiganya. Semua di halaman ini tetap berlaku; plugin hanya berarti ada orang lain yang mengetiknya.

Sambungkan ke agent Anda

contexere init            # host tempat Anda berjalan, atau sebuah menu kalau Anda punya terminal
contexere init --claude   # atau --cursor, --codex, --gemini, dan 11 lainnya
contexere init --all      # semua host, plus .vscode/mcp.json di direktori saat ini

contexere init menulis hook dan mendaftarkan server MCP. Ia idempoten, jadi menjalankannya lagi setelah upgrade adalah langkah yang benar, bukan risiko.

Di Claude Code, bagian yang memendekkan keluaran adalah hook-nya, sedangkan server MCP adalah kemudahan yang ada ongkos cache-nya. Membiarkannya terpasang tidak masalah; yang perlu Anda tahu ongkosnya ada di Agent yang didukung.

Tanpa terminal untuk bertanya, yang memang begitulah cara agent menjalankannya, contexere init menyetel host tempat ia berjalan alih-alih gagal karena menunya tidak ada. Ia menyebut host mana yang ia pilih. Kalau ia tidak bisa menyebut host-nya, misalnya di shell biasa, ia berhenti dan meminta sebuah flag ketimbang memasang ke tempat yang tidak diminta siapa pun.

Semua flag yang didukung ada di init. Host mana dapat apa ada di Agent yang didukung, dan halaman itu lebih penting daripada kedengarannya: host yang tidak bisa menulis ulang keluaran tool shell-nya sendiri tidak akan menunjukkan byte hasil sulingan ke agent, sebaik apa pun pipeline-nya bekerja.

Verifikasi

contexere doctor

Ini bukan seremoni opsional. Ia memeriksa binary-nya ada di PATH, basis datanya bisa dibuka, hook-nya benar-benar terpasang di tempat host membacanya, dan server MCP-nya terdaftar. contexere doctor --fix memperbaiki yang bisa ia perbaiki.

Codex CLI butuh satu langkah tambahan. Ia hanya menjalankan hook yang sudah dinyatakan tepercaya dan melewati sisanya diam-diam. Setelah contexere init --codex, jalankan codex sekali lalu setujui hook-nya di bagian “Hooks need review”. contexere doctor akan terus gagal sampai Anda melakukannya.

Pastikan ia benar-benar jalan

contexere doctor bilang sambungannya benar. Yang berikut bilang sambungannya sedang dipakai:

cat berkas-panjang.txt     # lewat agent Anda, bukan shell ini
contexere diff                  # mentah dibanding hasil sulingan, untuk perintah terakhir
contexere stats

Kalau contexere stats menampilkan baris dan contexere diff menampilkan perbedaan, hook-nya hidup.

Satu jebakan yang lebih baik diketahui sekarang daripada nanti: angka di contexere stats dipisah menurut agent_id, dan baris yang tercatat di bawah terminal adalah keluaran TTY yang tidak pernah dibaca model mana pun. Ketika Anda menilai apakah Contexere layak berada di sana, lihat baris untuk host Anda yang sebenarnya.

Perbarui

contexere update      # untuk pemasangan Homebrew
brew upgrade contexere

Dipasang sebelum 0.8.2 sebagai omni? Formula-nya kini bernama contexere, dan Homebrew melewati formula yang berganti nama dari sebuah tap sampai kamu mempercayainya. brew upgrade lalu tidak berkata apa-apa dan tetap di versi lama. Jalankan sekali:

brew trust --tap fajarhide/tap && brew upgrade fajarhide/tap/contexere

Jalankan ulang contexere init sesudahnya kalau sebuah rilis mengubah kontrak hook-nya. Changelog menyebut kapan itu terjadi.

Pindah dari nama omni

Contexere bernama OMNI sampai 0.8.0, dan nama lamanya masih berfungsi. Nama lama berhenti berfungsi di 0.9.0 (#1067):

nama lamamenjadiyang perlu Anda lakukan
perintah omnicontexerejalankan contexere init --<host> untuk setiap agent yang Anda pakai (--claude, --codex, --cursor dan seterusnya); setiap kali jalan, ia menulis ulang hook dan entri MCP agent itu
setelan OMNI_*CONTEXERE_*ganti namanya di profil shell atau CI; CONTEXERE_* sudah menang kalau keduanya diset
tool MCP omni_*contexere_*tidak ada, setelah contexere init mengganti entri MCP-nya
marker [OMNI[CONTEXEREperbarui skrip atau skill buatan Anda yang mencocokkan awalan itu
direktori ~/.omni~/.contexeretidak ada; riwayat Anda tetap utuh

Direktorinya pindah saat pertama kali jalan, dalam satu rename, termasuk database dan arsipnya, dan ~/.omni ditinggal sebagai link ke sana supaya rilis omni tetap menemukan datanya. Database-nya tetap bernama omni.db. Kalau pemindahan tidak bisa, Contexere tetap membaca ~/.omni di tempatnya.

contexere doctor menampilkan semua yang di mesin Anda masih memakai nama lama, jadi Anda tahu agent mana yang tersisa.

Cabut

contexere init --uninstall   # hook dan pendaftaran MCP untuk satu host
contexere reset --all        # semua integrasi, dan menawarkan menghapus database

contexere reset tanpa flag memberi menu interaktif. Keduanya tidak menyentuh konfigurasi shell Anda, karena Contexere memang tidak pernah menulis apa pun di sana.