// Topic graph exploration for agent-memory. Use when asked to "explore topics", "show related concepts", "what themes have I discussed", "find topic connections", or "discover patterns in conversations". Provides semantic topic extraction with time-decayed importance scoring.
| name | topic-graph |
| description | Topic graph exploration for agent-memory. Use when asked to "explore topics", "show related concepts", "what themes have I discussed", "find topic connections", or "discover patterns in conversations". Provides semantic topic extraction with time-decayed importance scoring. |
Semantic topic exploration using the agent-memory topic graph.
| Use Case | Best Approach |
|---|---|
| Explore recurring themes | Topic Graph |
| Find concept connections | Topic relationships |
| Discover patterns | Top topics by importance |
| Related discussions | Topics for query |
| Time-based topic trends | Topic with decay |
| Command | Purpose | Example |
|---|---|---|
topics status | Topic graph health | topics status |
topics top | Most important topics | topics top --limit 10 |
topics query | Find topics for query | topics query "authentication" |
topics related | Related topics | topics related --topic-id topic:abc |
memory-daemon status # Check daemon
memory-daemon start # Start if needed
Before presenting results:
memory-daemon status returns "running"topics status shows Enabled: truetopics status shows Topics: > 0memory-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
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
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
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
Use topics to navigate TOC:
# Find TOC nodes for a topic
memory-daemon topics nodes --topic-id "topic:authentication"
| Error | Resolution |
|---|---|
| Connection refused | memory-daemon start |
| Topics disabled | Enable in config: topics.enabled = true |
| No topics found | Run extraction: admin extract-topics |
| Stale topics | Check extraction schedule |
See Command Reference for full CLI options.
BM25 keyword search for agent-memory. Use when asked to "find exact terms", "keyword search", "search for specific function names", "locate exact phrase", or when semantic search returns too many results. Provides fast BM25 full-text search via Tantivy index.
Query past conversations from the agent-memory system. Use when asked to "recall what we discussed", "search conversation history", "find previous session", "what did we talk about last week", or "get context from earlier". Provides tier-aware retrieval with automatic fallback chains, intent-based routing, and full explainability. Includes command-equivalent instructions for search, recent, and context operations.
Agent retrieval policy for intelligent memory search. Use when implementing memory queries to detect capabilities, classify intent, route through optimal layers, and handle fallbacks. Provides tier detection, intent classification, fallback chains, and full explainability for all retrieval operations.
Semantic vector search for agent-memory. Use when asked to "find similar discussions", "semantic search", "find related topics", "what's conceptually related to X", or when keyword search returns poor results. Provides vector similarity search and hybrid BM25+vector fusion.
Wizard-style configuration guidance for a single-agent agent-memory setup. Shows defaults inline, provides a full sample config, and includes a dry-run config check step. Always confirm before creating or editing files.
Wizard-style installation guide for agent-memory (macOS/Linux). Helps users choose an install path, check prerequisites, and set PATH. Always confirm before any file edits or copying binaries. Provide verification commands only.