Knowledge graph

Your agent doesn’t just remember facts — it builds a map of how they connect.

graymatter daemon run --kg    # that's it

Every consolidation cycle extracts typed entities (person, organization, project) and links the ones that appear together. No manual tagging. No configuration. The graph builds itself from ordinary use.

Every edge carries receipts: the fact IDs that produced it.

Persist activation

graymatter init --kg

Persists KG activation via a sentinel file so future daemons build the graph without the flag. See ADR-009.

Manual links

memory_reflect with action=link connects two entities explicitly:

{ "tool": "memory_reflect", "args": {
    "action": "link",
    "agent":  "backend-agent",
    "text":   "depends_on",
    "target": "user-database"
}}

Automatic population ships gated and measured — the design history is in ADR-003 and ADR-008.

Inspect the graph

graymatter doctor --graph

Hubs by degree, articulation points, orphans, and a declared connectivity ratio — printed or emitted as JSON.

Export to Obsidian

graymatter export --format obsidian --include-graph

Entities become notes, connections become wikilinks, and the whole graph renders natively in Obsidian’s graph view.