Hermes

Vendor: Hermes Nama instalasi: hermes Status: Pratinjau Konfigurasi native: ~/.hermes/config.yaml

InstalasiCopy Anchor Link

apothem install --harness hermes

Adapter menerjemahkan profil bersama ke berkas konfigurasi global-pengguna Hermes Agent dan memasang kohor pendukung Apothem di bawah akar harness.

Berkas yang ditulis: ~/.hermes/config.yaml, dokumen profil ~/.hermes/apothem/rules/00-apothem-profile.md, dan berkas pendukung di bawah ~/.hermes/.apothem/support/

Dokumen profil diakhiri dengan bagian berkas pendukung Apothem yang menyebutkan direktori absolut di bawah ~/.hermes/.apothem/support/ tempat setiap kutipan bergaya repositori (rules/<name>.md, templates/..., hooks/...) di-resolve.

Pemetaan profil ke konfigurasi nativeCopy Anchor Link

Adapter membaca profil bersama Apothem dan merender konfigurasi YAML native, termasuk inventaris MCP milik profil. Server MCP berasal dari bagian mcp_servers pada profil. Server tersebut dirender ke dalam config.yaml pada setiap pemasangan dan pembaruan, bukan disalin sebagai berkas. Adapter juga menambahkan ~/.hermes/.apothem/support/skills ke skills.external_dirs, daftar direktori skill tambahan yang dibaca Hermes, yang merupakan cara Hermes menemukan skill yang terpasang. Entri ini ditempatkan setelah entri apa pun yang sudah Anda cantumkan, dan kunci Anda yang lain tetap seperti semula. Identitas, preferensi, dan aturan milik profil dimasukkan ke dalam dokumen profil. Command, skill, definisi helper, aturan, templat, dan prompt hook bersama ditempatkan sebagai materi pendukung di bawah ~/.hermes/.apothem/support/.

Catatan kompatibilitasCopy Anchor Link

Adapter pratinjau. Hermes memuat skill Apothem melalui skills.external_dirs, tetapi tidak memuat bagian lain dari pohon pendukung maupun dokumen profil dengan sendirinya: tidak ada hal lain di config.yaml dan tidak ada satu pun berkas konteks yang dibaca Hermes yang menunjuk ke sana, sehingga setelah instalasi Hermes berjalan tanpa aturan atau hook Apothem.

Bentrok nama. Hermes mendokumentasikan urutan prioritas skill berikut: skill proyek (<project>/.hermes/skills/ dan <project>/.agents/skills/), lalu ~/.hermes/skills/, lalu skills.create_dir, lalu folder yang tercantum di bawah skills.external_dirs. Direktori Apothem adalah entri external_dirs, sehingga berada paling akhir. Dokumentasi Hermes yang ditinjau tidak menyatakan salinan mana yang dimuat Hermes ketika dua lokasi memuat skill dengan nama yang sama; Apothem membaca urutan itu sebagai lokasi yang lebih awal yang menang, jadi perkirakan bahwa skill dengan nama yang sama yang Anda simpan di lokasi yang lebih awal akan didahulukan daripada salinan Apothem. Apothem hanya menulis ke config.yaml dan di bawah ~/.hermes/.apothem/support/, tidak pernah ke lokasi-lokasi yang lebih awal itu, sehingga instalasi, pembaruan, dan pencopotan tidak mengganti skill yang Anda simpan di sana.

apothem update mempertahankan kunci yang Anda tambahkan ke config.yaml, termasuk skills.config dan entri skills.external_dirs milik Anda sendiri. Adapter menulis inventaris MCP milik profil di bawah kunci tingkat atas mcp_servers, tempat Hermes membaca server MCP. Rilis Apothem sebelumnya menulisnya di bawah auxiliary.mcp, yang dibaca Hermes sebagai model auxiliary untuk dispatch alat MCP; baik apothem update maupun apothem uninstall menghapus blok tersebut ketika blok itu masih cocok dengan apa yang akan ditulis oleh rilis semacam itu dari profil bersama Anda saat ini (lihat Pencopotan untuk mengetahui kapan blok itu tetap ada). (Perilaku Hermes menurut halaman panduan penggunanya tentang skill, dibaca 2026-10-24, dan MCP, dibaca 2026-10-02.)

Komentar di config.yaml. Apothem menulis ulang berkas tersebut dengan pustaka YAML yang membuang komentar. Ketika berkas itu memuat komentar milik Anda dan entri tersebut tidak ada, Apothem membiarkan berkas itu tidak tersentuh dan instalasi berhenti dengan pesan yang menyebutkan kuncinya. Tambahkan entri itu sendiri, lalu jalankan instalasi lagi:

skills:
  external_dirs:
    - ~/.hermes/.apothem/support/skills

Entri yang Anda tambahkan sendiri dihitung sebagai milik Anda: jika Anda sudah mencantumkan direktori ini, Apothem mempertahankan entri Anda apa adanya dan pencopotan membiarkannya di tempatnya.

VerifikasiCopy Anchor Link

apothem verify --harness hermes

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. skills.external_dirs di konfigurasi native mencantumkan ~/.hermes/.apothem/support/skills. Tanpa entri itu Hermes tidak memuat skill yang terpasang; apothem update menambahkannya kembali.
4. Rutin verifikasi khusus adapter melaporkan keberhasilan.

PembaruanCopy Anchor Link

apothem update --harness hermes

Menurunkan ulang konfigurasi native dari status profil bersama saat ini; entri Apothem di skills.external_dirs tetap tercantum sekali, seberapa sering pun Anda memperbarui. Jalankan setelah menyunting ~/.config/apothem/profile.yaml atau memutakhirkan paket Apothem yang terpasang.

PencopotanCopy Anchor Link

apothem uninstall --harness hermes

Menghapus apa yang ditambahkan adapter: entri mcp_servers dan entri skills.external_dirs yang dicatat oleh instalasinya di config.yaml (kunci milik Anda sendiri tetap ada, termasuk entri external_dirs milik Anda sendiri dan skills.config, dan berkas tersebut dihapus hanya ketika Apothem yang membuatnya dan tidak ada lagi milik Anda yang tersisa di dalamnya), dokumen profil, dan pohon pendukung. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Pada instalasi yang dibuat oleh rilis sebelumnya, yang menulis server milik profil di bawah auxiliary.mcp, blok tersebut juga dihapus ketika blok itu masih cocok dengan apa yang akan ditulis rilis tersebut dari profil bersama Anda saat ini di ~/.config/apothem/profile.yaml. Ini adalah aturan yang sama dengan yang diterapkan apothem update, sehingga mencopot tanpa memperbarui terlebih dahulu tidak meninggalkan blok usang selama server MCP milik profil tidak berubah. Blok yang telah Anda sunting, blok yang tidak lagi cocok dengan server MCP milik profil Anda saat ini, atau blok yang tidak memiliki profil bersama yang dapat dibaca sebagai pembanding, tetap di tempatnya, dan pengaturan auxiliary Anda yang lain selalu tetap ada.

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