Topic Graph

Topic Graph Skill

Semantic topic exploration using the agent-memory topic graph.

When to Use

When Not to Use

• Specific keyword search (use BM25)
• Exact phrase matching (use BM25)
• Current session context (already in memory)
• Cross-project queries (topic graph is per-project)

Quick Start

Prerequisites

memory-daemon status  # Check daemon
memory-daemon start   # Start if needed

Validation Checklist

Before presenting results:

• Daemon running: memory-daemon status returns "running"
• Topic graph enabled: topics status shows Enabled: true
• Topics populated: topics status shows Topics: > 0
• Query returns results: Check for non-empty topic list

Topic Graph Status

memory-daemon topics status

Output:

Topic Graph Status
----------------------------------------
Enabled:           true
Healthy:           true
Total Topics:      142
Active Topics:     89
Dormant Topics:    53
Last Extraction:   2026-01-30T15:42:31Z
Half-Life Days:    30

Explore Top Topics

Get the most important topics based on time-decayed scoring:

# Top 10 topics by importance
memory-daemon topics top --limit 10

# Include dormant topics
memory-daemon topics top --include-dormant

# JSON output for processing
memory-daemon topics top --format json

Query Topics

Find topics related to a query:

# Find topics matching query
memory-daemon topics query "JWT authentication"

# With minimum similarity
memory-daemon topics query "debugging" --min-similarity 0.7

Topic Relationships

Explore connections between topics:

# Get related topics
memory-daemon topics related --topic-id "topic:authentication"

# Get similar topics (by embedding)
memory-daemon topics similar --topic-id "topic:jwt-tokens" --limit 5

Topic-Guided Navigation

Use topics to navigate TOC:

# Find TOC nodes for a topic
memory-daemon topics nodes --topic-id "topic:authentication"

Error Handling

See Command Reference for full CLI options.