Troubleshooting

The command is missing

uv tool list
uv tool update-shell

Open a new terminal. GUI assistants may need a restart to inherit PATH. Check for another Fehm installation shadowing the uv executable.

The assistant cannot find the skill

fehm integrations --platform claude
fehm integrations --platform claude --project

Use your actual platform. These commands check different scopes. Reload the assistant and confirm skills are enabled. Remote terminals require their own installation.

The graph is missing or stale

fehm scan .

Run from the repository root. Graphs contain an absolute source root, so moving the repository requires a rescan. Check that watch mode points at the intended graph and only one writer is active.

The server does not open

Try a different port and confirm the supplied graph exists. A listener permission error can mean your execution environment disallows loopback servers. An API 401 requires the configured token.

Practice audit exits with code 2

Review the reported required gap or lost baseline signal. Do not reset the baseline simply to remove a failing result. Corrupt or edited active policies need a reviewed proposal and fresh approval.

Results miss a relationship

Dynamic behavior, unsupported frameworks, TypeScript aliases/references, and shallow polyglot resolution can leave links unresolved. Compare evidence with the actual source and keep these limitations in the review.