Map your first repository

1. Work from your project

cd /absolute/path/to/project
fehm scan .
fehm stats

The scan writes .fehm/graph.json and supporting state. Common build/dependency directories are excluded, including node_modules, .venv, and dist. General .gitignore matching is not implemented.

2. Ask a specific question

fehm query "authentication flow"
fehm context "change authentication" --budget 4000

The result is a context packet containing source evidence, not a model-generated answer. Read the cited files or ask your assistant to explain the packet. Token budgets are character-based estimates.

3. Follow relationships

fehm relationships authenticate --direction both
fehm what-breaks authenticate

Replace authenticate with a symbol that exists in your repository. Dynamic relationships may remain unresolved; inferred results should be checked against source.

4. Explore in the browser

fehm serve .fehm/graph.json --watch

Open http://127.0.0.1:7331. Watch mode refreshes the graph after source changes. Stop with Ctrl+C.

Next steps

Register an assistant to reuse this workflow, or review engineering practices before making a change.