Kuato

Kuato

Easily recall what you discussed with your favorite coding agents, what decisions you made, and where you left off so you can pick up where you left off as easily as asking "where did we leave off on XYZ..."

This simple, fully local session recall skill works on Claude Code & other coding agents that support skills. Instant use with text search, optional local postgres with faster and more accurate search on larger session histories.

The Problem

Claude Code forgets everything between sessions. You're deep in a feature, close the tab, and the next day ask "where were we?" only to get a blank stare.

**Kuato:** What do you want, Mr. Quaid? **Quaid:** The same as you; to remember. **Kuato:** But why? **Quaid:** To be myself again. **Kuato:** You are what you do. A man is defined by his actions, not his memory.

Kuato gives Claude access to what you *did* - the actions that define your work.

Two Versions

Feature	File-Based	PostgreSQL
Setup time	0 minutes	5 minutes
Dependencies	Bun only	Bun + Postgres
Search speed	~1-5 seconds	<100ms
Full-text search	Basic matching	Weighted, ranked
Fuzzy matching	No	Yes (trigram)
API server	No	Yes
Token tracking	Yes	Yes + per-model
Best for	Quick lookups	Daily use

**Start with file-based.** Upgrade to PostgreSQL when you're running 10+ sessions a day and want faster, smarter search.

Quick Start: File-Based

Zero setup. Works directly with Claude Code's JSONL files.

# Clone the repo
git clone https://github.com/alexknowshtml/kuato.git
cd kuato

# Search your sessions
bun run file-based/search.ts --query "email system" --days 7

# Filter by tools used
bun run file-based/search.ts --tools Edit,Bash --limit 10

# Filter by file patterns
bun run file-based/search.ts --file-pattern "components/"

Output is JSON with all session metadata:

``