How dicklesworthstone/coding_agent_session_search works
cass is a local-first TUI and machine interface for aggregating coding-agent histories into a searchable archive. The main workflow is discovering configured sources, parsing provider-specific sessions, persisting canonical conversations, building derived lexical and optional semantic indexes, then searching and viewing results. Supporting branches provide analytics, export/archive operations, and readiness/repair diagnostics. The README documents these capabilities and the SQLite source-of-truth contract; sampled source excerpts are incomplete, so the graph omits uncertain internal call wiring.
Main entry points: sqlite.rs Canonical archive · main.rs CLI entry point · engine.rs Semantic indexing · query.rs Query and retrieval
Components 19
History ingestion
- Source discovery
src/sources/mod.rs - Agent connectors
src/connectors/mod.rs - Conversation model
src/model/mod.rs
Archive and indexes
- Indexer
src/indexer/mod.rs - Semantic indexing
src/indexer/semantic/engine.rs - Canonical archive
src/storage/sqlite.rs
Search and interfaces
- CLI entry point
src/main.rs - Lexical search
src/search/tantivy.rs - Semantic search
src/search/model_manager.rs - Query and retrieval
src/search/query.rs - Robot search service
src/search_service.rs - Interactive TUI
src/ui/tui.rs
Operations and outputs
- Usage analytics
src/analytics/query.rs - Export and rendering
src/export.rs - Logical archives
src/logical_archive/mod.rs - Readiness diagnostics
src/doctor.rs
Other components
- User or agent
- Local histories
- Local model files
Connections 26
- User or agent → CLI entry point: issues commands
- Local histories → Source discovery: provides sources
- CLI entry point → Source discovery: configures sources
- Source discovery → Agent connectors: selects providers
- Agent connectors → Conversation model: parses sessions
- Indexer → Canonical archive: writes conversations
- Indexer → Semantic indexing: builds vectors
- Semantic indexing → Canonical archive: reads conversations
- Semantic indexing → Local model files: loads local model
- Canonical archive → Lexical search: rebuilds lexical index
- Canonical archive → Semantic search: supplies filters
- User or agent → Robot search service: sends requests
- CLI entry point → Query and retrieval: dispatches search
- Query and retrieval → Lexical search: retrieves candidates
- Query and retrieval → Semantic search: refines results
- Robot search service → Lexical search: searches index
- Robot search service → Canonical archive: loads follow-up
- CLI entry point → Interactive TUI: launches interface
- Interactive TUI → Canonical archive: reads archive
- CLI entry point → Usage analytics: dispatches analytics
- Usage analytics → Canonical archive: queries usage data
- CLI entry point → Export and rendering: dispatches export
- Export and rendering → Canonical archive: reads conversations
- CLI entry point → Logical archives: dispatches archive tasks
- CLI entry point → Readiness diagnostics: dispatches diagnosis
- Readiness diagnostics → Canonical archive: checks readiness