01 · MCP tools
Tool catalogue
| Tool | Use |
|---|---|
| Snapshot | |
| generate_snapshot | Extract or refresh a repository graph. append: true adds another repository. |
| Navigation | |
| explore | Summarize a module, file, directory, or symbol. |
| query_facts | Filter facts by kind, name, file, relation, or repository. |
| show_symbol | Return source surrounding a named symbol. |
| Graph analysis | |
| traverse | Walk relations forward or in reverse. |
| find_path | Find a shortest graph path between two nodes. |
| impact_analysis | Return transitive dependents grouped by depth. |
| endpoint_impact | Walk an HTTP endpoint to its controller, models, tables and callers. |
| governing_intent | Find the architectural declarations that apply to a code target, or list the code covered by a declaration. |
| query_insights | Filter computed findings. |
| coverage_report | Report resolved and unresolved cross-repo calls. |
| package_metrics | Rank packages by coupling, instability, and distance from the main sequence. |
| Before the edit | |
| constraints_for | The declared components and rules that apply to a file or fact, plus any violations that name it. The path need not exist yet. |
| plan_check | The constraints and dependencies relevant to an intended change. With a patch, it also reports the violations the patch would introduce using a scratch copy. |
| Change control | |
| set_baseline | Pin the current snapshot. |
| diff_snapshot | Compare the current snapshot with its baseline. |
| snapshot_receipt | Return snapshot provenance and extraction metadata. |
| compare_receipts | Check whether two snapshots can be compared. |
| Code health | |
| find_orphans | Find isolated and unreferenced symbols, with confidence tiers. |
| analyze_performance | Rank parser-derived performance risks with estimated Big-O and evidence. |
| History | |
| architecture_history | Show recorded architectural changes over time. |
| architecture_blame | Find when a fact, relation, or finding entered or left the architecture. |
Exact parameters, defaults, result shapes, and examples are maintained in ARCHITECTURE.md. All twenty-two tools ship in the open-source repository; none requires a licence, an account, or a seat.
02 · CLI
Shell entry points
| Command | Purpose |
|---|---|
| enola --explain | Print a human-readable architecture report without writing snapshot artifacts. |
| enola --generate | Generate persistent snapshot artifacts without starting the MCP server. |
| enola dashboard | Explore the latest snapshot in the read-only local dashboard, without MCP; --open opens the browser. |
| enola cluster init | Write the cluster config for a folder of repositories. |
| enola coverage | Report which cross-repo calls resolved and which did not, per service. |
| enola baseline | pin the comparison baseline, show it, or clear it. |
| enola check | Grade what a change did to the architecture and return a CI-safe exit code. |
| enola constraints | lint validates declared rules against the snapshot; init binds shipped recipes; explain shows why a file belongs to a component; mine proposes candidates; ledger reports exemptions and suppressions. |
| enola plan | List the rules and dependencies relevant to an intended change and, for a patch, the violations it would introduce. |
| enola endpoint | Report what changing an HTTP endpoint reaches, from route to tables and callers. |
| enola log | One line per recorded snapshot: what the architecture did over time. |
| enola show | What one recorded revision added and removed. |
| enola diff | The architecture delta between two recorded points. |
| enola blame | When a fact, relation or finding entered the architecture, and when it left. |
| enola gc | What the recorded history holds, and what can be removed. |
| enola history | Share recorded history between machines: push, pull, verify, gc. |
| enola providers | List the fact providers built into the binary, or fetch one. |
| enola install | Add agent instructions; --hooks adds supported session hooks. |
| enola uninstall | Remove the instructions and hooks written by the installer. |
| enola doctor | Report whether the hooks fired, and baseline state. |
| enola --status | List running servers, repositories, and dashboard URLs. |
| enola upgrade | Install the latest release over the running binary. |
The complete CLI contract is in docs/CLI.md.