Appendix | Quick Reference & Config Templates

Don't memorize — just open this page when you need it.

---

Appendix A. MCP Tool Quick Reference

Memory Search Tools

Tool	Parameters	Description
search	query(req), type, date_from, date_to, project, limit	Search memory index, return lightweight list
timeline	observation_id or query	View event chain around an Observation
get_observations	ids[](req)	Batch fetch full Observations by ID
list_projects	none	List all recorded project names

Smart Explore Tools

Tool	Parameters	Description
smart_search	query(req), path(req), file_pattern	AST-based semantic code search
smart_outline	filepath(req)	Return file's function/class/interface skeleton
smart_unfold	filepath(req), entity_name(req), line_start(req)	Expand one function's complete code

Knowledge Agent Tools

Tool	Parameters	Description
build_corpus	corpus_name(req, snake_case), query_tags[](req)	Build topic knowledge vault
prime_corpus	corpus_name(req)	Activate vault in current context
query_corpus	corpus_name(req), question(req)	Query a knowledge vault

---

Appendix B. Config Templates

~/.claude-mem/settings.json (Recommended)

{
  "CLAUDE_MEM_MODE": "code",
  "WORKER_PORT": 37777,
  "LOG_LEVEL": "info",
  "CONTEXT_OBSERVATION_LIMIT": 50,
  "CONTEXT_SESSION_LIMIT": 10
}

claude_desktop_config.json (MCP Setup)

{
  "mcpServers": {
    "mcp-search": {
      "command": "node",
      "args": [
        "/Users/YOUR_USERNAME/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs"
      ]
    }
  }
}

.claude-mem.json (Project-Level, Optional)

{
  "version": "2.0.0",
  "project_name": "my-blog",
  "smart_explore": {
    "ignored_directories": ["node_modules", "dist", ".git", ".next"],
    "parsers": { "typescript": "tree-sitter-typescript" }
  },
  "make_plan": {
    "require_verbatim_snippets": true,
    "allow_skipping_tests": false
  }
}

---

Appendix C. Observation Types

Type	Meaning	Search Syntax
decision	Architecture/design choice	type:decision
bugfix	Bug fix	type:bugfix
feature	New feature	type:feature
refactor	Code refactoring	type:refactor
discovery	New learning/discovery	type:discovery
change	General change	type:change

---

Appendix D. Token Economics Comparison

Operation	Without Claude-Mem	With Claude-Mem	Savings
Understand a 500-line file	read_file: ~8,000 tk	smart_outline: ~350 tk	95%
Search for a past bug	grep entire repo: ~15,000 tk	search: ~150 tk	99%
Inject 10 sessions of context	Dump all: ~100,000 tk	3-layer retrieval: ~2,600 tk	97%
Summarize 3 months of history	Manual scrolling: ∞	prime_corpus: ~600 tk	∞

---

Appendix E. Quick Troubleshooting

# 1. Worker running?
curl http://localhost:37777/api/health

# 2. Database exists?
ls -la ~/.claude-mem/claude-mem.db

# 3. Hooks registered?
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/hooks/

# 4. Config correct?
cat ~/.claude-mem/settings.json

# 5. Any errors in logs?
tail -20 ~/.claude-mem/logs/worker.log

---

(End of series)