Total recall for
your terminal.
Search your shell history. Track AI agent commands.
Keep command context in a local SQLite database. Connect supported AI agents through MCP to query past work.
Already use Homebrew?
brew tap AppachiTech/suvadu && brew install suvaduThen enable shell integration below. Install script and Cargo options are there too.
Earlier interface shown · 0.4.0 search guide
Not just history. Memory.
Three layers that turn your terminal history into a structured, queryable, agent-accessible knowledge base.
Structured History
Recorded commands include exit code, duration, directory, session, and executor. Search and filter your history in a terminal UI.
AI Agent Tracking
Identify supported agents in recorded commands. Configure an agent integration to capture prompts and link them to commands where supported.
MCP Agent Memory
Query history and past sessions through MCP, and share reusable instructions with the new skills library. Sync skills into Claude Code, Cursor, and Codex.
Suvadu stores history locally. When you connect an AI client, that client controls how retrieved history is used.
See it in action
Explore search, agent activity, and prompt history.
These recordings show an earlier interface. See the 0.4.0 CLI docs for current screens and shortcuts.
Interactive Search
Search recorded commands with substring matching, filters, and an optional context-aware Smart mode.
- Substring search across your entire history
- Filter by date, exit code, directory, executor
- Smart mode boosts same-directory results
- Detail pane with full metadata (Tab)
Why switch?
Add structured context and filtering to your shell history.
| Feature | Standard History | Suvadu |
|---|---|---|
| Search | Built-in history search | Substring search with interactive filters |
| Command context | Commands; timestamps depend on configuration | Exit code, duration, directory, session and executor |
| Arrow recall | Usually recent commands first | Zsh: recent commands first, directory as a tiebreaker |
| Filtering | Shell commands and external tools | Date, exit code, directory and executor filters |
| Storage | A shell history file | A local SQLite database |
| Analytics | External tools or scripts | Built-in stats and agent dashboards |
| Recording controls | Shell-specific ignore settings | Ignore patterns, pause and disable controls |
| Secret redaction | Depends on shell and tooling | Pattern-based redaction for recognized secrets |
Shell behavior varies by configuration. Suvadu records commands after integration is enabled; ignore settings apply. Redaction matches known patterns and cannot identify every secret.
Works with your tools
Dedicated integrations and executor detection for supported tools.
Shell recording, prompt capture and MCP access have different setup requirements. Detection alone does not capture prompts. Choose your agent setup.
All trademarks belong to their respective owners.
Install Suvadu
macOS & Linux · Zsh 5.1+ or Bash 4+
Install the CLI, enable recording in your shell, then try a search.
-
Install the CLI
Choose one method. Each installs the
suvcommand.Requirements and manual installationHomebrew
Recommended if you already use Homebrew on macOS or Linux. Update later with brew upgrade suvadu.
brew tap AppachiTech/suvadu && brew install suvaduInstall script
Downloads a binary for your OS and architecture, verifies its checksum, and installs to /usr/local/bin using sudo. Requires curl and an administrator password.
Read the installer sourcecurl -fsSL https://downloads.appachi.tech/suvadu/install.sh | bashCargo
Requires a Rust toolchain. Compiles from source, which can take a few minutes. Make sure ~/.cargo/bin is on your PATH.
cargo install suvadu -
Enable shell integration
Installing the CLI alone does not record commands. Choose the shell you use to enable recording and Ctrl+R search.
Zsh setup
Add this line once to
~/.zshrc. If it is already there, keep the existing line.eval "$(suv init zsh)"Save the file, then run this in your Zsh terminal to activate it:
source ~/.zshrcBash setup
Add this line once to
~/.bashrc. If it is already there, keep the existing line.eval "$(suv init bash)"Save the file, then run this in your Bash terminal to activate it:
source ~/.bashrcBash 4+ is required. For a login shell, make sure
~/.bash_profilesources~/.bashrc, or add the hook to the startup file your shell reads. Shell setup details -
Check your setup and try a search
Check your shell, recording state and database. Agent and MCP setup are optional; follow the diagnostic guidance for any issues.
suv doctorRun
echo hello, then press Ctrl + R and search for it. Select a result to place it in your prompt; press Enter to run it.Need help? Read the diagnostic guide or check shell integration.