feat: add tb-session CLI for Claude Code session search

Cargo.toml

@@ -33,7 +33,7 @@ indicatif = "0.18"
 inquire = "0.7"
 
 # Database
-rusqlite = { version = "0.38", features = ["bundled"] }
+rusqlite = { version = "0.38", features = ["bundled", "modern_sqlite"] }
 
 # Error handling
 thiserror = "2.0"
@@ -45,6 +45,7 @@ tb-sem = { path = "crates/tb-sem" }
 tb-prod = { path = "crates/tb-prod" }
 tb-bug = { path = "crates/tb-bug" }
 tb-devctl = { path = "crates/tb-devctl" }
+tb-session = { path = "crates/tb-session" }
 
 # Dev/test (also in workspace.dependencies so crates can inherit them)
 assert_cmd = "2"

crates/tb-session/Cargo.toml

@@ -0,0 +1,32 @@
+[package]
+name = "tb-session"
+version = "0.1.0"
+edition = "2024"
+description = "Claude Code session search CLI"
+authors.workspace = true
+license.workspace = true
+repository.workspace = true
+
+[[bin]]
+name = "tb-session"
+path = "src/main.rs"
+
+[lib]
+doctest = false
+
+[dependencies]
+toolbox-core = { workspace = true, features = ["version-check"] }
+clap.workspace = true
+serde.workspace = true
+serde_json.workspace = true
+chrono.workspace = true
+thiserror.workspace = true
+colored.workspace = true
+rusqlite.workspace = true
+toml.workspace = true
+dirs = "6"
+
+[dev-dependencies]
+assert_cmd.workspace = true
+predicates.workspace = true
+tempfile.workspace = true

crates/tb-session/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: tb-session
+description: Search and manage Claude Code sessions. Use when the user references past sessions, wants to find prior work, or needs to resume a specific conversation.
+---
+
+# tb-session
+
+Claude Code session search CLI. Full-text search across session history with metadata filtering. Built for AI agent consumption but works for humans too.
+
+## Capabilities
+
+- **Search** — full-text search across messages with BM25 ranking, `--pr` filter, metadata filters
+- **List** — browse sessions by metadata (branch, date, project), worktree-aware
+- **Show** — session detail with conversation preview
+- **Resume** — resume a past session in a **new terminal tab** (accepts UUIDs, prefixes, or name search)
+
+## When to use
+
+- User references prior work: "remember when we...", "that session where..."
+- User asks about a specific PR: use `--pr` to find sessions mentioning it
+- User asks to find or resume a past session
+- Before starting work: check if a prior session already started the same task
+- Use `--json` for programmatic access when processing results
+
+## Quick reference
+
+```bash
+# Search by content
+tb-session search "authentication middleware"
+tb-session search "budget calculation" --all-projects
+
+# Search by PR (number or URL)
+tb-session search --pr 557
+tb-session search --pr https://github.com/org/repo/pull/123
+
+# List recent sessions
+tb-session list
+tb-session list --all-projects --limit 20
+
+# Show session details (prefix match works)
+tb-session show bcb7ff
+
+# Resume by UUID prefix or name
+tb-session resume bcb7ffed
+tb-session resume "auth refactor"
+```
+
+## Important
+
+- **Resume opens a new terminal tab** — Claude sessions can't nest inside each other. When called from within Claude Code (non-TTY), `resume` opens a new iTerm/Terminal.app tab, cd's into the original project, and runs `claude --resume`. This is expected — not an error.
+- **Worktree-aware by default** — `list` and `search` include sessions from all git worktrees of the same repo. Use `--all-projects` for everything.
+- **Resume accepts names** — `resume "auth refactor"` searches summary/first prompt and resumes the most recent match. UUID prefixes of any length also work.
+- **URLs work as search queries** — special characters are sanitized automatically.
+
+## Getting started
+
+Run `tb-session prime` for available commands and index status.
+
+## Live context
+
+!`tb-session prime`

crates/tb-session/src/commands/cache_clear.rs

@@ -0,0 +1,27 @@
+use crate::config::Config;
+use crate::error::Result;
+
+pub fn run() -> Result<()> {
+    let config = Config::load()?;
+    let db_path = config.db_path()?;
+
+    if db_path.exists() {
+        std::fs::remove_file(&db_path)?;
+
+        // Also remove SQLite WAL and shared-memory sidecar files if present.
+        let wal = db_path.with_extension("db-wal");
+        if wal.exists() {
+            std::fs::remove_file(&wal)?;
+        }
+        let shm = db_path.with_extension("db-shm");
+        if shm.exists() {
+            std::fs::remove_file(&shm)?;
+        }
+
+        println!("Index cleared: {}", db_path.display());
+    } else {
+        println!("No index to clear.");
+    }
+
+    Ok(())
+}

crates/tb-session/src/commands/config_cmd.rs

@@ -0,0 +1,34 @@
+use crate::config::Config;
+use crate::error::Result;
+
+/// Write default config to disk and print its path.
+pub fn init() -> Result<()> {
+    let config = Config::default();
+    config.save()?;
+    let path = Config::config_path()?;
+    println!("Config initialized at: {}", path.display());
+    Ok(())
+}
+
+/// Load and print all config values and resolved paths.
+pub fn show() -> Result<()> {
+    let config = Config::load()?;
+    let path = Config::config_path()?;
+
+    println!("Config file:    {}", path.display());
+    println!("claude_home:    {}", config.claude_home);
+    println!(
+        "claude_home resolved: {}",
+        config.claude_home_path().display()
+    );
+    println!("projects_dir:   {}", config.projects_dir().display());
+    match config.db_path() {
+        Ok(p) => println!("db_path:        {}", p.display()),
+        Err(e) => println!("db_path:        (error: {})", e),
+    }
+    println!("ttl_minutes:    {}", config.ttl_minutes);
+    println!("ttl:            {}s", config.ttl().as_secs());
+    println!("default_limit:  {}", config.default_limit);
+
+    Ok(())
+}