cormes

日本語 / English / 简体中文

Codex App のタスクをローカルの Hermes CLI に渡し、返ってきた回答を Codex がレビューしてから処理を続けるための実験的な Codex plugin です。

Cormes は Codex 側の wrapper です。外部の hermes CLI に委譲し、Hermes の回答を untrusted data として扱って Codex がレビューします。

デモ

このデモは、plain hermes と Cormes の違いを示します。plain Hermes は モデル回答を直接返します。一方で Cormes は、その回答を untrusted data として 扱い、ローカルリポジトリと照合してからレビュー済みの最終回答を返します。

最新リリース

• v0.1.2 - Public metadata cleanup for installable-first distribution
• v0.1.1 - Initial verified Codex App <-> Hermes CLI bridge
• まだバイナリや bundle は添付していません。リポジトリのソースを直接使ってください。

必要なもの

• Codex App
• PATH から実行できる hermes CLI
• ローカルに clone したこのリポジトリ

インストール

1. 先にターミナルで Hermes が動くことを確認します。

hermes --help

このコマンドが失敗する場合は、先に Hermes 側を直してください。この plugin は Hermes CLI が使えない環境では Hermes と通信できません。

2. Codex plugin ディレクトリに plugin をインストールします。

$pluginRoot = "$env:USERPROFILE\.codex\plugins\cormes"
Remove-Item -Recurse -Force $pluginRoot -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force -Path $pluginRoot | Out-Null
Copy-Item -Recurse -Force .codex-plugin, skills, commands, scripts, assets, README.md, README.en.md, README.zh-CN.md, LICENSE $pluginRoot

3. Codex App を再起動するか、新しい thread を開いて、plugin skill 一覧を更新します。

4. このリポジトリから validator を実行します。

python scripts/validate-plugin.py

5. このリポジトリで開発する場合は、任意で Git hook を有効にします。

git config core.hooksPath .githooks

開発モード

このリポジトリを Codex workspace として開いている場合、Codex は .agents/skills/cormes/SKILL.md の repo-local skill も検出できます。 これは plugin 開発中には便利ですが、別フォルダから使うには不十分です。

別 workspace から使う場合は、Codex が次の skill を読めるように plugin として インストールしてください。

%USERPROFILE%\.codex\plugins\cormes\skills\cormes\SKILL.md

Hermes 連携のテスト

1. 任意の workspace から、Codex で短いタスクを Cormes skill に渡します。

$cormes say hello

2. 実行が終わるまで待ちます。
3. 出力に次の内容が含まれることを確認します。

• MODEL=...
• SESSION_ID=...
• RESPONSE_BEGIN
• RESPONSE_BEGIN の後に Hermes の返答

Hermes CLI was not found on PATH が出る場合は、CLI がインストールされていないか、 現在の shell から見えていません。

SESSION_ID が出ない場合、Hermes が session marker を返していません。ただし、 返答自体は有効な場合があります。

モデル指定

通常は Hermes の config.yaml にある model.default / model.provider を使います。明示的に変えたい場合は、task の先頭で指定できます。

$cormes -m glm-5.1 -p zai say hello

優先順位は、明示指定、Cormes の model cache、Hermes config.yaml、glm-5-turbo fallback の順です。

互換性

$cormes が主要な Codex skill invocation です。legacy $hermes は別 skill alias としては残しません。残すと wrapper と依存先の名前衝突が続くためです。

外部 CLI binary は引き続き hermes です。legacy env var の CODEX_HERMES_STATE_DIR と CODEX_HERMES_REPO_ROOT は、rename 期間の fallback alias として引き続き受け付けます。

重要なファイル

• .codex-plugin/plugin.json
• skills/cormes/SKILL.md
• .agents/skills/cormes/SKILL.md
• scripts/invoke-cormes.py
• scripts/validate-plugin.py