About Suvadu
Suvadu is an MCP server in the Data category: shell history replacement with AI agent tracking and MCP server. Built in Rust, 100% local.
Install
git clone https://github.com/AppachiTech/suvaduThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Suvadu
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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.
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.