chromadb

# chromadb · Memory Storage **ChromaDB** is the vector database that powers Shokunin's persistent AI memory. It stores embeddings for semantic search across sessions. Built on SQLite with an ONNX embedding model for local-first, offline-capable operation. ## Workflow ### Step 1: Check storage status ```powershell python ~/.shokunin/scripts/chroma-helper.py count ``` Output: total entries, collection count, disk size on disk, last write timestamp. ```powershell python ~/.shokunin/scripts/chroma-helper.py stats ``` Output: entries per type (decision, file, command, checkpoint, session_end), per project, per date range. ### Step 2: Search stored entries ```powershell python ~/.shokunin/scripts/chroma-helper.py search "query text" "project-name" 10 ``` Searches via vector similarity + BM25 keyword hybrid. Results sorted by relevance with metadata attached. ```powershell python ~/.shokunin/scripts/chroma-helper.py search "error handling" "" 20 --type decision ``` Filter by entry type. Leave project empty to search all projects. ### Step 3: List recent entries ```powershell python ~/.shokunin/scripts/chroma-helper.py recent 10 ``` Shows the 10 most recently inserted entries across all projects. Use for quick audit. ```powershell python ~/.shokunin/scripts/chroma-helper.py recent 50 --project myproject ``` Filter recent entries to a specific project. ### Step 4: Backup the database ```powershell $backupDir = "$env:USERPROFILE\.shokunin\backups\chroma-$(Get-Date -F...