Skip to content

codex

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

codex

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
bin
bin
 
 
scripts
scripts
 
 
src
src
 
 
tests
tests
 
 
README.md
README.md
 
 
package.json
package.json
 
 

README.md

@everme/codex

Native EverMe lifecycle hook source for Codex. The release build bundles this package and @everme/agent-sdk into plugins/everme/bin/hook.mjs, which is shipped inside the EverMe Codex marketplace plugin and uses the stable /api/v1/mem/* BFF contract.

Lifecycle

  • SessionStart: inject the EverMe profile snapshot.
  • UserPromptSubmit: sanitize the prompt, search top 10 memories, and inject recall without passive profile rows by default.
  • Stop: stream the Codex rollout, save only the latest user turn, and flush extraction every five turns.
  • PreCompact: send a flush-only request.

All hook failures are fail-open and credentials are redacted from diagnostics. evercli plugin install codex writes credentials to ~/.codex/everme.env with mode 0600; the user reviews and trusts the commands in /hooks. Hook execution does not install or download an npm package at runtime.

Marketplace build

npm run build:marketplace

The generated ../everme/bin/hook.mjs is committed with the marketplace plugin. npm test --workspace @everme/codex rebuilds it before running the isolated runner test.

Configuration

The shared hook knobs are EVERME_INJECT_TOPK, EVERME_INJECT_PROFILE, EVERME_INJECT_MIN_SCORE, EVERME_FLUSH_EVERY_TURNS, EVERME_FLUSH_MODE, and EVERME_STATE_DIR.

License

Apache-2.0.