Reference¶
This section describes angelo's machine-readable surface: the four MCP servers that agents call, plus the two importable Python packages behind them. It is the what, not the why — for design rationale see the feature guides (Coordinator, Memory, Zettelkasten, Synapse), and for task recipes see the How-to guides.
The command cheatsheet is the one hand-curated page: the natural-language phrasings that trigger each tool or workflow, so you can say the thing rather than remember the tool name. Everything else here is generated from the code, so it cannot drift:
- The MCP tool reference is built at
mkdocs buildtime byscripts/gen_mcp_reference.py, which imports each live FastMCP server, enumerates its registered tools, resources, and prompts, and renders the parameter tables straight from the tools' type hints. (Resources are read-only context the model can pull on demand, e.g.zettelkasten://vocabulary; prompts are user-invoked slash-command workflows, e.g.start-session.) - The Code reference (one page per module, e.g.
coordinator) is generated from docstrings byscripts/gen_api_pages.pyvia mkdocstrings.
Because those tables are generated, they are not retyped here. Use the table below to jump to the right entry point.
What's where¶
| Surface | Purpose | Reference entry point |
|---|---|---|
| coordinator (MCP) | Task-graph orchestration: scope a task, design a DAG, execute it in waves of subagents. | MCP tools → coordinator · API |
| memory (MCP) | Persistent research tree, skills library, code graph, and session continuity. | MCP tools → memory · API |
| memory-artifacts (MCP) | DVC/S3 experiment provenance and cloud reruns — a toggleable companion to memory. | MCP tools → memory-artifacts · API |
| zettelkasten (MCP) | Multi-source literature-review knowledge graph (sources, citations, claims, cross-links). | MCP tools → zettelkasten · API |
| Synapse (zettelkasten capability) | Grounded navigation plus practice ↔ canon search, overlays, synthesis, and debate. | Overview · Grounded navigation · MemDSL v1 |
| stream (package) | Live document ingestion that drives a coordinator graph to produce grounded zettelkasten notes. | API → stream |
| angelo_cli (package) | The angelo install CLI: init, update, doctor, kill. |
API → angelo_cli |
The MCP tool reference lists a few tools that are conditionally registered (present only in certain repo states or when a capability is enabled); that page notes them inline.