Total recall for
your terminal.
Shared memory for your AI agents.
curl -fsSL https://downloads.appachi.tech/suvadu/install.sh | sh 
Not just history. Memory.
Three layers that turn your terminal history into a structured, queryable, agent-accessible knowledge base.
Structured History
Every command stored in SQLite with exit code, duration, directory, session, and executor. Search 1M+ entries in <10ms.
AI Agent Tracking
Auto-detects Claude Code, Cursor, Antigravity. Captures prompts, exit codes, risk levels. Trace every command back to the prompt that triggered it.
MCP Agent Memory
AI agents query your history directly. 11 tools + 5 browsable resources. assess_risk checks commands before execution. Shared memory across all agents.
See it in action
Built for power users. Designed to stay out of your way.
Interactive Fuzzy Search
Find any command instantly with real-time fuzzy matching, frecency ranking, and multi-filter TUI.
- Fuzzy 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?
Text files were fine in 1990. Your workflow deserves a database.
| Feature | Standard History | Suvadu |
|---|---|---|
| Search Logic | ~ Linear scan (slow at 50K+) | ✓ Indexed search (<10ms at 1M+) |
| Context Awareness | ✗ Timestamp only | ✓ Duration, exit code, CWD, session ID |
| Origin Tracking | ✗ Unknown | ✓ Auto-detects Claude Code, Cursor, VS Code, CI/CD |
| Smart Ranking | ✗ Most recent only | ✓ Context-aware: boosts same-directory results |
| Arrow Key Intelligence | ~ Pure recency | ✓ Frecency: frequency x recency with CWD boost |
| Filtering | ✗ grep / regex (manual) | ✓ UI filters (date, status, directory, executor) |
| Storage Engine | ~ Plain text file (.zsh_history) | ✓ SQLite + WAL (structured DB) |
| Usage Analytics | ✗ wc -l ~/.zsh_history | ✓ suv stats — trends, success rate, hourly activity |
| Session Replay | ✗ Scroll through terminal | ✓ suv replay — timeline with filters |
| Privacy | ~ Manual file editing | ✓ Ignore patterns (regex) + toggle |
| Secrets Protection | ✗ Manual / hope for the best | ✓ Auto-redaction of API keys, tokens, passwords |
Works with your tools
First-class integrations for AI agents. Auto-detect for everything else.
All trademarks belong to their respective owners.
Get started in 30 seconds
Three commands. That's it.
curl -fsSL https://downloads.appachi.tech/suvadu/install.sh | sh echo 'eval "$(suv init zsh)"' >> ~/.zshrc source ~/.zshrc && suv status
Also available via brew tap AppachiTech/suvadu && brew install suvadu,
cargo install suvadu, and
manual install.