Codex

Vendor: OpenAI Nama instalasi: codex Status: Beta Konfigurasi native: ~/.codex/AGENTS.md, ~/.codex/hooks.json, ~/.codex/hooks/, ~/.codex/agents/*.toml, dan ~/.agents/skills/

InstalasiCopy Anchor Link

apothem install --harness codex

Adapter memasang instruksi dan hook native Codex, mengonversi agen Apothem menjadi agen TOML Codex, dan membungkus prompt command yang dapat digunakan ulang sebagai skill Codex.

Berkas yang ditulis: ~/.codex/AGENTS.md, ~/.codex/hooks.json, ~/.codex/hooks/, ~/.codex/agents/*.toml, ~/.agents/skills/*/SKILL.md, ~/.agents/skills/*/agents/openai.yaml untuk skill yang dipanggil pengguna, dan berkas pendukung di bawah ~/.config/apothem/{rules,templates}/.

Interpreter hook. Sebelum menulis apa pun, pemasangan me-resolve interpreter CPython 3.10+. Di Windows, entri commandWindows pada setiap hook di hooks.json menjalankan path absolut interpreter tersebut, bukan peluncur py -3; entri command POSIX tetap menggunakan python3. Jalankan ulang apothem update --harness codex setelah interpreter dipindahkan atau dihapus. Jika tidak ada CPython 3.10+ yang ditemukan, pemasangan berhenti sebelum menulis berkas apa pun.

Blok Apothem di AGENTS.md diakhiri dengan bagian berkas pendukung Apothem yang menyebutkan direktori absolut tempat setiap kutipan bergaya repositori dalam skill dan aturan yang terpasang di-resolve: rules/<name>.md dan templates/... di bawah ~/.config/apothem/, serta hooks/... di bawah ~/.codex/hooks/. Instalasi Codex tidak menyertakan pohon schemas/ maupun conformity/, sehingga bagian tersebut tidak mencantumkan keduanya.

Skill yang dipanggil pengguna. Codex mengabaikan kunci disable-model-invocation. Untuk setiap skill atau command yang sumbernya menyetel disable-model-invocation: true, adapter menulis agents/openai.yaml di samping SKILL.md milik skill tersebut dengan policy.allow_implicit_invocation: false, sehingga Codex tidak memilih skill itu atas inisiatifnya sendiri; Anda tetap dapat menjalankannya secara eksplisit dengan $skill-name. Lihat dokumentasi skill Codex.

Pemetaan profil ke konfigurasi nativeCopy Anchor Link

Adapter membaca kohor bersama Apothem dan memasang masing-masing ke permukaan Codex yang tepat: instruksi ke AGENTS.md, hook ke hooks.json dan hooks/, agen ke TOML, skill ke ~/.agents/skills/, dan aturan/templat Markdown non-native ke ~/.config/apothem/ sebagai materi pendukung.

Setiap helper yang dikonversi menyetel name, description, dan developer_instructions, yang membawa isi helper tersebut. Tidak ada model atau upaya penalaran yang disetel, sehingga setiap helper mewarisi pilihan sesi. Codex tidak memiliki daftar alat atau batas giliran per helper, sehingga tools dan maxTurns milik helper tidak terbawa.

Helper hanya-baca (lihat referensi agen) menyatakan dalam instruksinya bahwa mereka tidak menyunting apa pun. Sifat hanya-baca ditegakkan oleh sandbox sesi induk, bukan oleh berkas TOML helper: setiap helper berjalan di bawah pengaturan sandbox dan persetujuan dari sesi yang memulainya. Berkas helper tidak dapat menimpa mode sandbox, kebijakan persetujuan, penyedia model, atau server MCP milik sesi, sehingga adapter tidak menulis satu pun di antaranya, dan instruksi helper dapat memintanya menghindari suntingan tanpa menciptakan sandbox hanya-baca tersendiri. Untuk membuat batas hanya-baca mengikat, setel kontrol sandbox dan persetujuan pada sesi Codex itu sendiri. Build Codex yang lebih lama daripada rilis yang menambahkan pembatasan ini mungkin masih menghormati sandbox_mode dalam berkas helper; Apothem belum memastikan rilis mana itu, dan Apothem tidak menulis sandbox_mode dalam kedua kasus.

Catatan kompatibilitasCopy Anchor Link

~/.agents/skills/ adalah direktori akar bersama yang dimiliki Codex: sembilan alat lain yang didukung juga memuatnya (registri harness mencantumkannya), sehingga skill Apothem yang ditulis instalasi Codex di sana juga muncul di alat-alat tersebut. Empat di antara alat-alat itu juga menulis folder tersebut sendiri ketika Anda memasangnya (registri mencantumkannya sebagai co-installer), dengan berkas yang sama yang ditulis instalasi Codex, sehingga skill tersebut ada di mesin yang tidak memiliki instalasi Codex. Hal yang sama berlaku untuk aturan dan templat di ~/.config/apothem/, yang juga ditulis oleh tujuh adapter berlingkup proyek. Folder itu selalu berada di direktori home pengguna Anda, apa pun nilai CODEX_HOME: Codex membaca $HOME/.agents/skills, sehingga CODEX_HOME selain ~/.codex memindahkan berkas Codex tetapi tidak memindahkan skill. Setiap instalasi Apothem yang memakai folder itu menulis berkas yang sama di sana, dan instalasi mencatat instalasi mana yang memakainya, sehingga urutan pemasangan tidak berpengaruh. Pencopotan Codex menghapus skill hanya ketika tidak ada lagi instalasi Apothem lain yang memakainya; jika masih ada, pencopotan mempertahankannya dan menyebutkan instalasi mana yang memakainya (lihat Pencopotan). Pemilik terdaftar adalah alat yang path-nya didokumentasikan oleh vendor. Instalasi yang menempatkan berkas adalah instalasi mana pun yang masih memakainya, dan catatan instalasi menyebutkannya. Folder skill yang tidak ditulis Apothem dan memiliki nama yang sama dengan skill Apothem dibiarkan, dengan peringatan yang menyebutkan namanya. Instalasi mencetak catatan yang menyebutkan alat-alat tersebut. ~/.codex/agents/ adalah direktori akar bersama kedua: alat lain yang didukung mencantumkan folder itu sebagai lokasi kompatibilitas (registri menyebutkannya), dan dokumentasinya tidak menyatakan apakah alat itu membaca berkas TOML yang ditulis instalasi Codex di sana.

Codex mereservasi ~/.codex/rules/ untuk kebijakan eksekusi .rules. Apothem tidak menempatkan aturan perilaku Markdown di sana; Apothem menyimpannya di ~/.config/apothem/ dan merujuknya dari AGENTS.md dan skill yang terpasang.

Plugin CodexCopy Anchor Link

Apothem juga menyediakan plugin Codex, yang ditambahkan dari marketplace plugin repositori (panduan instalasi mencantumkan perintahnya di bawah kanal 7). Plugin ini adalah bootstrap: plugin ini membundel satu skill entri yang menjalankan mesin, dan apothem install --harness codex menulis semua yang tercantum di atas.

Plugin berada di plugins/apothem/. Manifesnya adalah plugin.json di akar, lokasi yang didokumentasikan Codex untuk paket baru. Manifes tidak menyebutkan path skill, karena Codex menemukan direktori skills/ milik plugin dari akar plugin. Berkas .codex-plugin/plugin.json tetap berada di sampingnya sebagai fallback kompatibilitas untuk build Codex yang hanya membaca lokasi lama itu; Codex masih mendukungnya dan memperlakukan manifes akar sebagai kanonis untuk identitas plugin. Kedua berkas membawa versi rilis, dan sebuah tes mengikatnya pada versi mesin.

Plugin tidak membundel agen, hook, maupun server MCP. Codex tidak mendokumentasikan komponen agen kustom untuk plugin, sehingga mesin tetap menulis agen ke ~/.codex/agents/*.toml. Hook yang dibundel dalam plugin terbatas pada plugin yang dipasang secara manual di Codex desktop dan tidak dipercaya secara otomatis, sehingga mesin tetap menulisnya ke ~/.codex/hooks.json.

Entri marketplace menyetel blok policy yang menurut Codex harus selalu disertakan oleh penulis: policy.installation bernilai AVAILABLE dan policy.authentication bernilai ON_INSTALL, nilai default yang didokumentasikan Codex untuk entri baru.

VerifikasiCopy Anchor Link

apothem verify --harness codex

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 codex

Menyegarkan bootstrap Codex, agen yang dikonversi, skill, dan kohor pendukung.

Folder skill di ~/.agents/skills/ ditulis dalam satu bentuk yang sama bagi setiap instalasi Apothem pada folder itu: kunci header SKILL.md version, updated, archetype, dan portability berada di bawah map metadata, dan userInvocable ditulis sebagai user-invocable. Pembaruan pertama setelah pemutakhiran menulis ulang folder yang sebelumnya ditulis instalasi Codex ke dalam bentuk itu, dan mencadangkan setiap folder yang diubahnya. apothem rollback --harness codex memulihkannya.

PencopotanCopy Anchor Link

apothem uninstall --harness codex

Menghapus blok Apothem dari ~/.codex/AGENTS.md dan mempertahankan teks apa pun di luarnya, serta menghapus entri milik Apothem dari ~/.codex/hooks.json dan mempertahankan entri milik Anda. Juga menghapus berkas Apothem di ~/.codex/hooks/, ~/.codex/agents/, ~/.agents/skills/, dan ~/.config/apothem/{rules,templates}/, kecuali instalasi Apothem lain masih memakainya (pencopotan mempertahankan dan mencantumkannya); berkas lain di folder-folder tersebut tetap ada. Skill yang dihapus dari ~/.agents/skills/ juga hilang dari alat lain yang memuatnya (lihat Catatan kompatibilitas). Jika Anda menyetel CODEX_HOME ke folder selain ~/.codex dan memasang dengan rilis sebelumnya, salinan yang ditulis rilis itu di samping folder tersebut (<CODEX_HOME>/../.agents/skills/ dan <CODEX_HOME>/../.config/apothem/) tidak dihapus; hapus salinan itu secara manual. Setiap berkas dicadangkan di bawah ~/.apothem/backups/ sebelum diubah atau dihapus. 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