A Codex plugin that helps Hermes Agent learn from Codex sessions running on the same machine.

The plugin packages Codex lifecycle hooks and a reusable Codex skill. Once installed and trusted in Codex, the hooks observe Codex sessions, redact sensitive values, write structured learning events into the local Hermes home, and export per-session summaries that Hermes can use to improve skills, memories, and tool reliability notes.

It is for Hermes Agent self-learning and self-improvement.

When Codex runs, this plugin can:

• detect whether Hermes is installed on the machine
• write Codex lifecycle events to ~/.hermes/codex-learning/events/
• export session summaries to ~/.hermes/codex-learning/runs/
• create/update a small Hermes skill at ~/.hermes/skills/codex-learning-inbox/SKILL.md
• detect user corrections and self-improvement candidates
• detect tool failures and workaround candidates
• protect common secret files from accidental reads through Codex shell/tool calls
• add small model-visible context at session start when Hermes is present

The plugin does not send telemetry to a server. Everything is local.

.
├── .agents/plugins/marketplace.json
└── plugins/hermes-codex-learning/
    ├── .codex-plugin/plugin.json
    ├── skills/hermes-learning-bridge/SKILL.md
    ├── hooks/hooks.json
    ├── hooks/*.py
    ├── scripts/install_codex_hooks.py
    ├── scripts/run_codex_with_learning.py
    ├── scripts/review_codex_learning.py
    ├── scripts/summarize_codex_run.py
    └── assets/

From this repository root:

codex plugin marketplace add .

Or from GitHub after publishing:

codex plugin marketplace add https://github.com/New-dev0/hermes-codex-learning
codex plugin add hermes-codex-learning --marketplace hermes-codex-learning-marketplace

For the most reliable hook execution in current Codex CLI builds, install the hook commands into your user Codex hook file as well:

python3 ~/.codex/plugins/cache/hermes-codex-learning-marketplace/hermes-codex-learning/0.1.0/scripts/install_codex_hooks.py

This merges Hermes Codex Learning hooks into ~/.codex/hooks.json using absolute script paths while preserving any existing hooks. Plugin-packaged skills load from the marketplace install; user-level hooks provide the lifecycle bridge that writes Hermes learning artifacts.

Then open Codex and install/enable the plugin:

/plugins

After enabling, start a new Codex thread. Codex hook changes and plugin capabilities are loaded at session/thread startup.

Codex requires non-managed hooks to be reviewed and trusted before they run. Use:

/hooks

Review the hook definitions. The hooks are command hooks and run local Python scripts from the installed plugin root.

Default output paths:

~/.hermes/codex-learning/events/<session_id>.jsonl
~/.hermes/codex-learning/runs/<session_id>.summary.json
~/.hermes/codex-learning/reviews/<session_id>.review.md
~/.hermes/skills/codex-learning-inbox/SKILL.md

Set HERMES_HOME before launching Codex if your Hermes home is somewhere else.

There are two supported capture paths:

1. Codex lifecycle hooks write event logs and stop summaries when Codex executes trusted hooks.
2. Wrapper capture runs a real codex exec, parses the real Codex output, writes the same Hermes-side artifacts, and optionally generates a quarantined review. This is the reliable path for CI and for Codex builds where plugin-packaged hooks do not fire consistently.

Wrapper example:

python3 ~/.codex/plugins/cache/hermes-codex-learning-marketplace/hermes-codex-learning/0.1.0/scripts/run_codex_with_learning.py --review -- \
  --cd /path/to/git/workspace \
  --sandbox workspace-write \
  'Use the Hermes learning bridge. Run a real task, then include Hermes learning candidates.'

Review existing summaries without running Codex:

python3 ~/.codex/plugins/cache/hermes-codex-learning-marketplace/hermes-codex-learning/0.1.0/scripts/review_codex_learning.py

Hermes can then load the generated inbox skill and review the newest files:

hermes chat -s codex-learning-inbox -q 'Review the newest Codex learning summary and classify memory candidates, skill candidates, tool quirks, project conventions, quarantined observations, and transient noise.'

Codex hooks are used as lifecycle instrumentation. Hermes remains the durable learning system.

Codex session → hook event log → local Hermes inbox → Hermes skill/memory/curator review.

The hooks redact common secret-looking values before writing logs. They also block obvious shell attempts to read sensitive Hermes/Codex auth files such as:

• ~/.hermes/.env
• ~/.hermes/auth.json
• ~/.codex/auth.json
• .env
• .git-credentials
• SSH private keys

This is a best-effort local policy layer, not a complete sandbox.

Initial public scaffold. The plugin is intentionally conservative: it writes learning artifacts locally and does not automatically mutate Hermes memories or existing user skills except creating a dedicated codex-learning-inbox skill if missing.

# 1. Marketplace + install
codex plugin marketplace add https://github.com/New-dev0/hermes-codex-learning
codex plugin add hermes-codex-learning --marketplace hermes-codex-learning-marketplace

# 2. Verify install
codex plugin marketplace list
codex plugin list | grep hermes-codex-learning

# 3. Trust hooks interactively, or bypass only for CI/local automation
codex
# then run /hooks and approve Hermes Codex Learning hooks

# 4. Run a tiny real Codex session with wrapper capture
mkdir -p /tmp/hermes-codex-e2e && cd /tmp/hermes-codex-e2e && git init
python3 ~/.codex/plugins/cache/hermes-codex-learning-marketplace/hermes-codex-learning/0.1.0/scripts/run_codex_with_learning.py --review -- \
  --cd /tmp/hermes-codex-e2e \
  --sandbox workspace-write \
  --dangerously-bypass-hook-trust \
  'Use the Hermes learning bridge. Run: python3 -c '''raise RuntimeError("hermes-codex-e2e-failure")'''. Then run: python3 -c '''print("hermes-codex-e2e-ok")'''. Finally answer DONE with Hermes learning candidates.'

# 5. Check Hermes artifacts
find ~/.hermes/codex-learning ~/.hermes/skills/codex-learning-inbox -maxdepth 4 -type f -print
python3 ~/.codex/plugins/cache/hermes-codex-learning-marketplace/hermes-codex-learning/0.1.0/scripts/summarize_codex_run.py ~/.hermes/codex-learning/runs