Gemini CLI

Vendor: Google Nama instalasi: gemini-cli Status: GA Konfigurasi native: GEMINI.md dan .gemini/ lokal-proyek

InstalasiCopy Anchor Link

apothem install --harness gemini-cli --project /path/to/project

Adapter ini berlingkup proyek. Adapter memasang GEMINI.md proyek, mengonversi command Apothem menjadi slash command TOML Gemini, menormalkan definisi helper lokal, dan menempatkan kohor pendukung non-native di bawah .gemini/.apothem/support/. Alat koding lain juga membaca GEMINI.md proyek, sehingga blok Apothem di dalamnya ditulis sebagai panduan untuk seluruh proyek yang tidak menyebut satu alat pun sebagai pembacanya.

Berkas yang ditulis:

GEMINI.md
.gemini/commands/*.toml
.gemini/agents/*.md
.gemini/skills/
.gemini/.apothem/support/

Pemetaan profil ke konfigurasi nativeCopy Anchor Link

Adapter membaca kohor bersama Apothem dan merutekan masing-masing melalui permukaan yang kompatibel dengan Gemini. Aturan Markdown, templat, dan materi hook tetap berada di bawah .gemini/.apothem/support/ karena semuanya adalah materi pendukung, bukan direktori aturan native Gemini. Blok Apothem di GEMINI.md diakhiri dengan bagian berkas pendukung Apothem yang menyebutkan, relatif terhadap akar proyek, direktori di bawah .gemini/.apothem/support/ tempat setiap kutipan bergaya repositori (rules/<name>.md, templates/..., hooks/...) di-resolve. Jalur-jalur tersebut relatif sehingga GEMINI.md yang di-commit tidak membawa jalur khusus mesin.

Setiap command yang dikonversi di .gemini/commands/ memuat sebuah description dan sebuah prompt. Prompt tersebut hanya berisi instruksi command; metadata Apothem di bagian atas berkas sumber (versi, daftar alat, dan bidang serupa) dihilangkan, sehingga model tidak pernah membacanya sebagai instruksi. Gemini menjalankan command kustom hanya ketika Anda mengetikkannya.

Definisi helper di .gemini/agents/ mempertahankan batas alat dan batas gilirannya: izin tools dari sumber, dikurangi disallowedTools, menjadi daftar-izin tools Gemini yang berisi nama-nama alat Gemini, dan maxTurns menjadi max_turns. Karena itu, helper read-only tidak mendapat alat write_file maupun replace. Tidak ada model yang disetel, sehingga setiap helper mewarisi model sesi.

Helper yang dicantumkan oleh kunci agent_mcp_servers milik profil juga mendapat satu entri mcp_<server>_* per server yang disebutkan di daftar-izin tools-nya, sehingga helper itu dapat memanggil alat server tersebut dan tidak ada server lain; tanpa kunci itu setiap helper mempertahankan daftar-izin biasa (lihat Server MCP). Apothem menulis izin di sini hanya untuk nama server yang terdiri dari huruf, angka, dan -, karena Gemini CLI tidak dapat merujuk nama yang mengandung garis bawah; nama lain apa pun dilewati dan dilaporkan, demikian pula izin untuk helper yang sudah menjangkau setiap server MCP.

Catatan kompatibilitasCopy Anchor Link

~/.gemini/ tetap menjadi wilayah lingkup pengguna bagi alat yang menggunakan profil Gemini global. Adapter Gemini CLI hanya menulis ke proyek yang diteruskan melalui --project.

VerifikasiCopy Anchor Link

apothem verify --harness gemini-cli --project /path/to/project

Perintah verify memastikan bahwa:

1. Konfigurasi native ada di jalur yang diharapkan.
2. Setiap target terkelola ada; berkas terkelola tidak kosong, dan konfigurasi JSON atau YAML dapat diurai. Tambahkan --profile PATH untuk juga memastikan bahwa berkas yang terpasang cocok dengan profil tersebut.
3. Rutin verifikasi khusus adapter melaporkan keberhasilan.

PembaruanCopy Anchor Link

apothem update --harness gemini-cli --project /path/to/project

Menyegarkan GEMINI.md, command yang dikonversi, definisi helper lokal, skill yang terpasang, dan pohon pendukung .gemini/.apothem/support/.

PencopotanCopy Anchor Link

apothem uninstall --harness gemini-cli --project /path/to/project

Menghapus blok Apothem dari <project>/GEMINI.md dan mempertahankan teks lain di dalamnya. Berkas itu dihapus hanya jika tidak ada lagi isi lain di dalamnya. Juga menghapus berkas Apothem di <project>/.gemini/commands/, <project>/.gemini/skills/, <project>/.gemini/agents/, dan <project>/.gemini/.apothem/support/; berkas lain di folder-folder tersebut tetap ada. Sebelum perubahan dilakukan, salinan setiap berkas dengan cap waktu disimpan di bawah ~/.apothem/backups/; tidak ada berkas cadangan yang tertinggal di proyek. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Gerbang konformitasCopy Anchor Link

python -m apothem.conformity.gate --all .

Pemecahan masalahCopy Anchor Link

Tombol konfigurasiCopy Anchor Link

Lihat jugaCopy Anchor Link

• Semua harness — katalog lengkap alat yang didukung
• Panduan instalasi — pasang Apothem ke dalam harness ini
• Referensi apothem harnesses — tampilkan daftar dan periksa adapter dari CLI