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 lama | menjadi | yang perlu Anda lakukan |
|---|---|---|
perintah omni | contexere | jalankan 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 | [CONTEXERE | perbarui skrip atau skill buatan Anda yang mencocokkan awalan itu |
direktori ~/.omni | ~/.contexere | tidak 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.