code-session-memory 0.8.0 → 0.8.1

package/README.md

@@ -144,6 +144,40 @@ Retrieve the full ordered content of a specific session message. Use the `sessio
 | `startIndex` | number | no | First chunk index (0-based) |
 | `endIndex` | number | no | Last chunk index (0-based, inclusive) |
 
+### Querying from the CLI
+
+You can search your indexed sessions directly from the terminal without going through the AI agent:
+
+```bash
+npx code-session-memory query "authentication middleware"
+npx code-session-memory query "auth flow" --source opencode
+npx code-session-memory query "migration" --limit 10
+npx code-session-memory query "error handling" --from 2026-02-01 --to 2026-02-20
+```
+
+| Flag | Default | Description |
+|---|---|---|
+| `--source <s>` | none | Filter by tool: `opencode`, `claude-code`, or `cursor` |
+| `--limit <n>` | 5 | Max number of results |
+| `--from <date>` | none | Only include sessions from this date (ISO 8601, e.g. `2026-02-01`) |
+| `--to <date>` | none | Only include sessions up to this date (inclusive) |
+
+Requires `OPENAI_API_KEY` to be set (used to embed the query text).
+
+Example output:
+```
+Found 2 result(s) for "authentication middleware" (limit=5)
+
+1. [1.1665] "Implement auth flow" (opencode)
+   Section: Assistant
+   Chunk 1/3 — session://ses_abc123#msg_def456
+   ────────────────────────────────────────────────────────────
+   [Session: Implement auth flow > Assistant]
+
+   We implemented JWT authentication middleware using Express.js...
+   ────────────────────────────────────────────────────────────
+```
+
 ### Browsing sessions
 
 You can browse, inspect, and delete indexed sessions directly from the CLI:
@@ -240,7 +274,8 @@ code-session-memory/
 │   ├── indexer-cli.ts                    # Node.js subprocess (called by OpenCode plugin)
 │   ├── indexer-cli-claude.ts             # Node.js subprocess (called by Claude Code hook)
 │   ├── indexer-cli-cursor.ts             # Node.js subprocess (called by Cursor stop hook)
-│   ├── cli.ts                            # install / status / uninstall / reset-db commands
+│   ├── cli.ts                            # install / status / uninstall / reset-db / query commands
+│   ├── cli-query.ts                      # query command: semantic search from the terminal
 │   └── cli-sessions.ts                   # sessions list / print / delete / purge (TUI)
 ├── mcp/
 │   ├── server.ts                 # MCP query handlers (testable, injected deps)
@@ -261,9 +296,10 @@ code-session-memory/
     ├── cursor-to-messages.test.ts           # Unit tests: Cursor SQLite reader
     ├── cursor-transcript-to-messages.test.ts # Unit tests: Cursor JSONL parser
     ├── opencode-db-to-messages.test.ts      # Unit tests: OpenCode internal DB reader
+    ├── cli-query.test.ts                    # Unit tests: query CLI command
     ├── e2e-claude.test.ts                   # End-to-end: Claude Code pipeline
+    ├── e2e-cursor.test.ts                    # End-to-end: Cursor pipeline
     ├── e2e-opencode.test.ts                 # End-to-end: OpenCode pipeline
-    ├── e2e-cursor.test.ts                   # End-to-end: Cursor pipeline
     └── fixtures/                  # Committed session files (generated by generate-fixtures)
 ```
 
@@ -306,10 +342,11 @@ Tests use [Vitest](https://vitest.dev) and run without any external dependencies
  ✓ tests/cursor-to-messages.test.ts               (15 tests)
  ✓ tests/cursor-transcript-to-messages.test.ts     (7 tests)
  ✓ tests/opencode-db-to-messages.test.ts           (8 tests)
+ ✓ tests/cli-query.test.ts                        (23 tests)
  ✓ tests/e2e-claude.test.ts                       (18 tests)
  ✓ tests/e2e-cursor.test.ts                        (8 tests)
  ✓ tests/e2e-opencode.test.ts                     (14 tests)
-   Tests  165 passed
+   Tests  188 passed
 ```
 
 To refresh the e2e fixtures (e.g. after changing the indexer or parsers), run:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-session-memory",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Automatically index OpenCode, Claude Code, and Cursor sessions into a shared sqlite-vec vector database for semantic search across your AI coding history",
   "type": "commonjs",
   "main": "dist/src/indexer.js",