suvadu 0.3.0

Shell history replacement with AI agent tracking and MCP server. Built in Rust, 100% local.
Documentation

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, 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 stats                   # Stats dashboard with heatmap
suv replay --after today    # Timeline of today's commands
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 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
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
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.

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