Fehm with Codex

Give Codex a repeatable way to map a repository and retrieve source-backed context. Install the Fehm CLI first using the installation guide.

Install and register

fehm install --platform codex

This registers a personal skill at ~/.agents/skills/fehm/SKILL.md. For a project-only setup, run from the repository root:

fehm install --project --platform codex

Project scope writes .agents/skills/fehm/SKILL.md. The installer reports the path and preserves customized files.

Build the graph

Mention $fehm in Codex CLI or the IDE extension. Restart or reload the assistant if it has not discovered the skill.

fehm scan .

The graph is stored in .fehm/graph.json. Run scans from the repository being analyzed, not the skill installation folder.

Ask with context

Use Fehm to explain the authentication flow. Cite source files and distinguish explicit relationships from inferred ones.

You can also retrieve the context in a terminal:

fehm query "authentication flow"

Keep the integration current

Install the next supplied wheel, then refresh the original scope:

fehm install --platform codex
fehm integrations --platform codex

Add --project if that was your installation scope. Once the registry package is released, use uv tool upgrade fehm before re-registering.

Troubleshooting

Confirm the CLI is on the assistant terminal’s PATH and the skill is in the intended scope. Remote hosts need their own Fehm installation. If the skill does not appear, reload your assistant and check that skills are enabled.

More troubleshooting · Connect with MCP instead