Suvadu

Total recall for your terminal. Shared memory for your AI agents.

Suvadu replaces your shell history with a SQLite-backed store. Every command gets structured context — exit code, duration, directory, executor, session. AI agents can query it via MCP. 100% local.

• <2ms recording overhead, <10ms search across 1M+ entries
• AI agent tracking — auto-detects Claude Code, Cursor, OpenCode, Antigravity, pi.dev, Codex, Aider
• Prompt Explorer — trace every command back to the prompt that triggered it
• MCP Server — 15 tools + 7 resources. Agent session discovery, project context, failure learning, risk assessment. Configurable via suv settings
• 100% local — no cloud, no telemetry, no account. MIT licensed.

Website & Docs: suvadu.sh · CLI Reference: suvadu.sh/cli · Blog: suvadu.sh/blog

---

Install

# Homebrew (macOS)
brew tap AppachiTech/suvadu && brew install suvadu

# Install script (macOS & Linux)
curl -fsSL https://downloads.appachi.tech/suvadu/install.sh | sh

# Cargo
cargo install suvadu

Then add shell hooks:

# Zsh
echo 'eval "$(suv init zsh)"' >> ~/.zshrc && source ~/.zshrc

# Bash
echo 'eval "$(suv init bash)"' >> ~/.bashrc && source ~/.bashrc

Verify: suv status

---

Quick Start

suv search                  # Interactive search TUI (also Ctrl+R)
suv history                 # Print last 25 commands (pipeable)
suv history --json -n 100   # Last 100 commands as JSONL
suv stats                   # Stats dashboard with heatmap
suv replay --after today    # Timeline of today's commands
suv doctor                  # Check installation health
suv agent dashboard         # Monitor AI agent activity
suv agent prompts           # Browse prompts and their commands

---

AI Agent Setup

suv init claude-code    # Claude Code — hooks + MCP + prompt capture
suv init cursor         # Cursor — hooks + MCP + prompt capture
suv init opencode       # OpenCode — plugin + prompt capture
suv init pi             # pi.dev — extension + prompt capture
suv init antigravity    # Antigravity — auto-detect

Then ask your agent: "What commands failed in this project recently?"

See the full integration guide and MCP server docs.

---

Key Features

Feature	Details
Search	Fuzzy search TUI with filters, Smart mode, detail pane, bookmarks
History	Non-interactive suv history with filters, --json, pipeable to other tools
Agent Dashboard	Timeline, risk assessment, per-agent analytics, exportable reports
MCP Server	15 tools + 7 resources — agent session replay, project context, failure learning, configurable
Prompt Explorer	Trace commands back to the prompt that triggered them
Stats	Heatmap, hourly distribution, top commands, executor breakdown
Doctor	suv doctor checks shell, hooks, config, database, MCP, and agent hooks health
Organization	Tags, bookmarks, notes, alias suggestions
Privacy	Space-prefix exclusion, regex patterns, secret redaction, local-only
Arrow Keys	Frecency-ranked Up/Down that prefers same-directory commands
Vim Bindings	Optional vim-style j/k/Ctrl+U/Ctrl+D navigation in search TUI

Full feature documentation at suvadu.sh/cli.

---

More demos

Search, stats & settings

Agent dashboard — track what your AI agents execute

---

Development

git clone https://github.com/AppachiTech/suvadu.git
cd suvadu
make dev      # Run the app
make test     # Run tests
make lint     # Run clippy + format check

See CONTRIBUTING.md for guidelines.

Security

See SECURITY.md for vulnerability reporting, data storage design, and privacy details.

License

MIT