FEHM with Codex

Install FEHM's entry skill for Codex, retrieve source evidence and configure optional local MCP tools with the correct client settings.

Install FEHM 1.0.0 from PyPI using the installation guide. npm publication is pending. The assistant needs access to the installed CLI and your checkout in its own execution environment.

Personal skill

Terminal
fehm install --platform codex --dry-run
fehm install --platform codex
fehm integrations --platform codex

Personal path: ~/.agents/skills/fehm/SKILL.md.

Project skill

Terminal
fehm install --platform codex --project
fehm integrations --platform codex --project

Run at your project root. Expected path: .agents/skills/fehm/SKILL.md. Installation protects customized files and does not modify MCP settings or permission lists.

Scan and retrieve

Terminal
fehm scan .
fehm doctor
fehm context "authentication flow" --budget 4000

Reload the assistant and inspect its skill list for Fehm. Ask: “Use FEHM to explain the authentication flow. Identify entry points, trace supported caller/callee relationships, cite source files and lines, and distinguish observed evidence from inference.” Skill discovery and model behavior must be checked in your client; filesystem tests alone do not prove either.

Optional MCP

Terminal
fehm mcp-config --platform codex --root /absolute/path/to/project

This prints exact configuration without writing settings. Review and merge only the FEHM entry into ~/.codex/config.toml. Below is the client-specific shape; replace placeholder paths or use the generated values.

TOML
[mcp_servers.fehm]
command = "/absolute/path/to/bin/fehm"
args = ["mcp","--root","/absolute/path/to/project"]

Approve the server through your client's trust controls. Confirm the connection and the fehm_context and fehm_practices tools, then query a known symbol. See MCP setup and limits.

Update and remove

After installing a replacement wheel, refresh the same scope:

Terminal
fehm install --platform codex --project
fehm integrations --platform codex --project
# To remove the project skill:
fehm uninstall --platform codex --project

Omit --project for personal scope. --force creates a backup before replacing a customized skill. Unrelated files and project graphs remain. Remove only the FEHM MCP entry using the client's own settings. Optional catalog skills retain their separate installation lifecycle.

Compatibility and troubleshooting

Installer paths and configuration shapes are automatically tested. Codex CLI 0.154.0-alpha.6.2 accepted the stdio configuration on macOS ARM64. A model-session connection, context query and skill discovery remain unverified. If discovery fails, check the client version, trust policy, selected scope and runtime PATH. Remote hosts need their own installation. See troubleshooting.