# Suvadu

Replaces shell history with a SQLite store: every command keeps its exit code, duration, directory and session. Agents query it over MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 121
- Author: AppachiTech
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AppachiTech/suvadu
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/suvadu

## What it does

Suvadu hooks into your shell and writes each command to a local SQLite database. Entries carry context: exit code, duration, directory, executor, session. Inside a git repository it also records the branch the command was typed on. Nothing leaves the machine — no cloud, no telemetry, no account.

The MCP server exposes 22 read-only tools, 8 resources and 6 prompts. Two write tools stay off until you opt in. Through them an agent searches the history, learns from past failures, assesses command risk, and traces a command back to the prompt that triggered it. Configuration lives in `suv settings`.

Install comes from Homebrew, an install script, or Cargo — the last one needs Rust 1.95 or newer. Then the shell hook goes in: `eval "$(suv init zsh)"` in `~/.zshrc`, or the bash equivalent. Without it nothing gets recorded. Up-arrow recall is a separate matter: oh-my-zsh, zsh-history-substring-search, zsh-vi-mode, fzf, atuin and mcfly all bind Up, so the `eval` line has to sit last in `~/.zshrc`. Bash only gets `Ctrl+R` for now.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- find the command that failed yesterday in another directory
- trace a command back to the prompt that caused it
- assess a risky command before running it
- keep Claude and Codex sessions in one searchable place
- recall a recent command from its first few characters

## Example prompts
- Search my history for commands that failed in this project
- Show which prompt triggered the last build command
- Assess the risk of `rm -rf build` based on past runs

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md