Suvadu

<p align="center"> <img src="assets/suvadu-logo.svg" alt="Suvadu" width="180"> </p> <p align="center"><strong>Total recall for your terminal. Shared memory for your AI agents.</strong></p> <p align="center"> <a href="https://github.com/AppachiTech/suvadu/actions/workflows/ci.yml"><img src="https://github.com/AppachiTech/suvadu/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://crates.io/crates/suvadu"><img src="https://img.shields.io/crates/v/suvadu.svg" alt="crates.io"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a> <a href="https://github.com/AppachiTech/suvadu/releases"><img src="https://img.shields.io/github/v/release/AppachiTech/suvadu?label=latest" alt="Latest Release"></a> </p> <p align="center"> <img src="demo/hero.gif" alt="Suvadu — search history, browse AI agent prompts" width="700"> </p>

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.

---

<details> <summary><strong>More demos</strong></summary> <p align="center"> <img src="demo/suvadu-search.gif" alt="Suvadu search TUI" width="700"> <br> <em>Search, stats & settings</em> </p> <p align="center"> <img src="demo/suvadu-agent.gif" alt="Suvadu agent dashboard" width="700"> <br> <em>Agent dashboard — track what your AI agents execute</em> </p> </details>

---

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