How ericaltenburg/claude-toc works
claude-toc is local session memory for Claude Code: it records prompts, extracts dated facts from idle transcripts, indexes facts and prompt history, and exposes an on-demand search. The principal path runs from prompt submission through a silent sweep and extraction to the markdown corpus; queries refresh a disposable SQLite index before searching. The graph also includes documented status and spend reporting. Edges are limited to README statements and relationships visible in the supplied source index or excerpts; unsampled implementation details are not inferred.
Main entry points: extractor.js Fact extractor · search.js Search engine · index.js Command dispatcher · refresh.js Index refresh
Components 18
Capture and extraction
- Prompt hook
hooks/toc-prompt.mjs - Session sweep
src/extract/sweep.js - Session discovery
src/sessions/known-sessions.js - Transcript reader
src/sessions/transcript.js - Fact extractor
src/extract/extractor.js
Fact corpus
- Topic corpus
src/corpus/topics.js - Fact format
src/corpus/format.js - Extraction progress
src/sessions/progress.js
Index and search
- SQLite index
src/index/open.js - Index refresh
src/index/refresh.js - Search engine
src/search/search.js - Search skill
skills/toc-search/SKILL.md
Commands and reporting
- Command dispatcher
src/cli/index.js - Status report
src/status/status.js - Spend tracking
src/extract/spend.js
Other components
- Claude Code
- Amazon Bedrock
- Claude prompt history
Connections 20
- Claude Code → Prompt hook: submits prompt
README.md - Prompt hook → Session sweep: starts sweep
hooks/toc-prompt.mjs - Session sweep → Session discovery: finds sessions
src/extract/sweep.js - Session discovery → Transcript reader: opens transcript
src/sessions/known-sessions.js - Fact extractor → Transcript reader: reads unread slice
src/extract/extractor.js - Fact extractor → Amazon Bedrock: requests extraction
README.md - Fact extractor → Topic corpus: writes facts
src/extract/extractor.js - Fact extractor → Extraction progress: records progress
src/extract/extractor.js - Topic corpus → Fact format: formats facts
src/corpus/topics.js - Search skill → Claude Code: offers on-demand search
README.md - Claude Code → Search engine: requests search
README.md - Search engine → SQLite index: queries index
src/search/search.js - SQLite index → Index refresh: refreshes before query
src/index/open.js - Index refresh → Topic corpus: reads corpus
src/index/refresh.js - Index refresh → Claude prompt history: indexes prompts
README.md - Command dispatcher → Search engine: dispatches search
src/cli/index.js - Command dispatcher → Status report: dispatches status
src/cli/index.js - Command dispatcher → Spend tracking: dispatches spend
src/cli/index.js - Status report → Search engine: checks search
src/status/status.js - Status report → SQLite index: reads index
src/status/status.js