Total recall for your terminal.
Replace your shell history with a searchable SQLite database. Know exactly what your AI agents execute. Find any command by date, exit code, directory, or who ran it — in under 10ms. Built in Rust. 100% local. Zero tracking.
v0.1.2 • MIT • macOS & Linux
Like built-in history, but better.
Stop hitting Up arrow 50 times. Start finding what you need.
Interactive Search
Replace Ctrl+R with a powerful TUI. Filters for dates, tags, and status.
SQLite + WAL
<10ms latency. Zero lag, even with millions of records. Constant time lookups.
Context Aware
Smart mode boosts same-directory results. Arrow keys use frecency ranking. Detail pane shows full metadata.
AI Agent Tracking
Know what Claude Code, Cursor, and other AI agents execute. Auto-detected, risk-assessed.
100% Private
Local-only. Zero tracking. Export as JSONL/CSV/JSON anytime. Your data never leaves your machine.
Secrets Redaction
API keys, tokens, and passwords are automatically detected and redacted before storage. Your secrets never touch the database.
Alias Management
Analyze your history to suggest shell aliases. Manage aliases with add, remove, list, and apply.
Session Timeline
Interactive session picker with command-level detail. Browse your workflow narrative across sessions.
AI Agent Tracking
Know exactly which commands were run by you and which were run by AI agents. Suvadu auto-detects Claude Code, VS Code, Cursor, Antigravity, CI/CD pipelines, and more.
Agent Dashboard & Risk Assessment
Monitor every AI agent command in real time. The agent dashboard shows a live timeline with risk levels, success rates, and per-agent breakdowns. Risk assessment automatically classifies commands — so you catch destructive operations before they cause damage.
Timeline
Precision Search & Filter
Don't just search text. Filter by Exit Code (find that failing build), Date Range (what did I run last Tuesday?), or Session Tag.
Instant Search
Stop piping text. Suvadu's fast substring search with filters for date, exit code, executor, and tags puts your most relevant commands at the top.
Smart Arrow Keys
Up/Down arrow keys rank commands using frecency (frequency x recency). Same-directory commands float to the top when Smart mode is on. No more cycling through 50 irrelevant commands.
Smart Context Search
Smart mode automatically boosts commands from your current directory higher in search results. Green-highlighted paths show local matches. Toggle with Ctrl+S.
Same-directory results ranked higher:
cargo test --release ~/project 0.4s
cargo build ~/project 12.3s
cargo fmt ~/other 0.1s
cargo publish ~/crate 3.2s
Stats Dashboard
A dedicated interactive TUI with contribution heatmap, daily sparkline, hourly distribution, and top programs, commands, and directories — with period switching and keyboard navigation.
Activity
Daily Trend
Hourly
Top Programs
Top Commands
Top Directories
Detail Preview Pane
Press Tab in the search TUI to open a side panel showing full metadata for the selected entry: command, path, timestamp, duration, exit code, session, executor, bookmarks, and notes.
Session Replay
Replay commands chronologically as a timeline. Filter by session, date, directory, or tag. Pipe it, grep it, or scroll through your workflow narrative.
── Replay: after yesterday, current dir ─────────
09:00:12 ~/project ✓ 1.2s git pull
09:00:45 ~/project ✓ 45.3s cargo build --release
09:01:31 ~/project ✗1 12.1s cargo test
09:02:33 ~/project ✓ 5m 12s vim src/main.rs
09:15:22 ~/project ✓ 0.8s cargo test
── 47 commands │ 44 passed │ 3 failed │ Avg 2.3s ──
Directory-Scoped Recall
Filter history to the current directory. Launch with --here or toggle mid-search with Ctrl+L. Instantly see what you ran right here.
Showing commands from ~/project only
cargo build --release
cargo test -- --nocapture
git push origin main
Command Bookmarks
Save your go-to commands for instant recall. Toggle bookmarks in search with Ctrl+B — starred commands show a ★ indicator.
Command Label Added
★ docker compose up -d start stack 2025-06-15
★ cargo test --release - 2025-06-14
Command Notes
Annotate any command with context — 'Fixed the SSL bug', 'Don't run on prod'. Notes appear inline in search results and can be added with Ctrl+N.
Note saved for entry 42.
In search TUI:
📝 openssl s_client -connect api.example.com:443
Fixed the SSL cert rotation
Export & Import
Export your entire history as JSONL, CSV, or JSON. Filter by date range. Import on another machine. No lock-in, ever.
Auto-Tagging Context
Suvadu automatically tags sessions based on your directory. Work commands stay in 'Work', side projects stay in 'Hobby'. No manual switching required.
Smart Deduplication
Press Up to cycle unique commands only. Suvadu intelligently hides consecutive duplicates, keeping your flow uninterrupted.
Smart Exclusions
Define Regex patterns to ignore noise. ls, cd, pwd—keep them out of your database entirely.
^ls$Active^pwd$ActiveBulk Delete & Cleanup
Accidentally pasted a secret? Ran ls 50 times? Delete individual entries or bulk-wipe patterns instantly.
The Power of Structure.
Text files were fine in 1990. Your workflow deserves a database.
| Feature | Standard History | Suvadu 👣 |
|---|---|---|
| Search Logic | 🔸Linear Scan (Slow at 50k+ lines) | ✅Indexed Search (<10ms at 1M+ lines) |
| Context Awareness | ❌Timestamp only | ✅Duration, Exit Code, CWD, Session ID |
| Origin Tracking | ❌Unknown | ✅Auto-Detects (VS Code, CI/CD, Bots) |
| Smart Ranking | ❌Most recent only | ✅Context-aware: boosts same-directory results (^S toggle) |
| Arrow Key Intelligence | 🔸Pure recency (most recent first) | ✅Frecency ranking: frequency × recency with CWD boost |
| Filtering | ❌grep / regex (Manual) | ✅UI Filters (Date, Status, Directory) |
| 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 output | ✅suv replay — chronological timeline with filters |
| Privacy | 🔸Manual file editing | ✅Ignore Patterns (Regex) + Toggle |
| Secrets Protection | ❌Manual editing / hope for the best | ✅Auto-redaction of API keys, tokens, passwords |
Ready to upgrade?
Install Suvadu in seconds and start building a better command history today.
# 1. Tap & Installbrew update && brew tap AppachiTech/suvadu && brew install suvadu# 2. Hook into Zsh (includes Ctrl+R)echo '\neval "$(suv init zsh)"' >> ~/.zshrc && source ~/.zshrc
Quick Reference
Everything you need, one command away.
suv searchInteractive search TUIsuv settingsOpen settings TUIsuv bookmarkManage bookmarked commandssuv noteAnnotate history entriessuv statsUsage analytics and trendssuv replaySession replay and timelinesuv deleteBulk delete history entriessuv wrapRecord commands from scripts/agentssuv exportExport historysuv importImport history from filesuv init zshGenerate shell hookssuv init claude-codeSet up Claude Code AI capturesuv aliasManage shell aliasessuv sessionInteractive session timelinesuv gcGarbage collect and compact databasesuv agent dashboardInteractive agent monitoring TUIsuv agent statsPer-agent analytics and risk breakdownsuv agent reportExport agent activity reportFrequently Asked Questions
Everything you need to know about Suvadu.
Ready to upgrade your terminal?
Install in 30 seconds. No account required. 100% local.
Install NowFree. macOS & Linux. Built in Rust.