Local-first stash, search, and trace tool for AI agent workflows. Save artifacts, search across them, diff against your code, and connect bugs to the code that owns them — all from one CGO-free binary.
Everything runs locally on your machine. No accounts, no cloud, no telemetry. Just a vault, an index, and the tools to move between them.
Snapshot files and folders into a managed vault with provenance, tags, and hash-verified restores to any directory. One command in, one command out.
14 typed tools, resources, and prompts over stdio. Works with Claude Code, Codex CLI, OpenCode, and any stdio MCP client.
BM25 keyword search built in via veclite. Add Ollama or OpenAI for semantic and hybrid search across every indexed stash.
tar+zstd with automatic 10MB threshold. Save disk without losing data.
Every save is scanned for likely credentials. Remote indexing of flagged stashes is blocked by default.
Compare any stash against a live codebase. See added, missing, and changed files at a glance.
Run vecgrep semantic code search over a codebase using a stashed artifact to surface the file:line most likely responsible for the bug.
Browse, search, restore, and drop stashes from a Bubbletea v2 terminal UI.
fcheap speaks the Model Context Protocol natively. Register it once and any MCP-compatible assistant can save, search, diff, and drop files without you leaving the conversation.
{
"mcpServers": {
"fcheap": {
"command": "fcheap",
"args": ["mcp", "serve"]
}
}
}Agent workflows produce artifacts fast. fcheap keeps them organized, searchable, and connected back to the source that owns them.
Snapshot a file or folder into the vault. Provenance, tags, and source are recorded; secrets are scanned on the way in.
fcheap save ./artifacts --tool vidtraceIndex for BM25 keyword search, or add an embedder for semantic and hybrid search across every stash at once.
fcheap search "columns not showing up"Compare a stash against a live codebase, or run vecgrep to surface the file:line most likely responsible for a bug.
fcheap connect <id> ~/projects/my-appReclaim space when you are done. TTLs and sweep keep the vault tidy automatically.
fcheap drop <id> --forceOne static binary, no runtime dependencies. Pick your platform and stash your first file in under a minute.
brew install --no-quarantine abdul-hamid-achik/tap/fcheapHomebrew tap — --no-quarantine avoids Gatekeeper warnings on the unsigned binary.
Then verify it is healthy: fcheap doctor — and open the vault UI with fcheap studio.
Free, open source, local-first. Your agent's artifacts never leave your machine unless you point an embedder somewhere else.
brew install --no-quarantine abdul-hamid-achik/tap/fcheap && fcheap save . --tag first-stash