v0.3.1

What's New in v0.3.1

suv history — pipeable history dump

Print command history to stdout with all the standard filters. Designed for piping to grep, jq, wc, and other tools.

suv history                        # Last 25 commands (newest first)
suv history -n 100 --json          # Last 100 as JSONL
suv history --here --after today   # Today's commands in current directory
suv history --json | jq '.command' # Pipe to jq

suv doctor — installation diagnostics

One command to check everything: shell version, hooks, config, database health, recording state, MCP registration, and agent hooks. Reports pass/warn/fail with actionable fix hints.

Suvadu Doctor

  Shell ................. ✓ zsh 5.9 (minimum: 5.1)
  Shell hooks ........... ✓ found in ~/.zshrc
  Config ................ ✓ valid (~/Library/.../config.toml)
  Database .............. ✓ healthy — schema v5, 2,345 entries
  Recording ............. ✓ active
  MCP (Claude Code) ..... ✓ registered in ~/.claude.json
  MCP (Cursor) .......... ⚠ not registered (run: suv init cursor)
  Agent hooks ........... ✓ 3 hook script(s) installed

  7 passed, 1 warnings, 0 failed

Configurable search scoring

Tune how fuzzy search results are ranked via suv settings or config.toml:

• length_threshold (10–500, default 80) — command length penalty threshold
• human_boost_percent (0–100, default 33) — boost for human commands over agent commands
• cwd_boost_percent (0–100, default 50) — boost for same-directory commands

pi.dev agent integration

suv init pi installs a TypeScript extension that captures bash commands and prompts from pi.dev sessions.

Other changes

• Session filenames now use the full UUID instead of a truncated 8-character prefix

New Contributors

• @mblarsen made their first contribution in #15

---

Full Changelog: v0.3.0...v0.3.1