Somtum

**Local-first memory and prompt-cache layer for Claude Code.**

[**Docs**](https://riz007.github.io/somtum/) · [**npm**](https://www.npmjs.com/package/somtum)

[](https://opensource.org/licenses/MIT) [](https://www.npmjs.com/package/somtum)

Somtum (Thai: ส้มตำ) is named after the vibrant, shredded green papaya salad. Just like its namesake, Somtum blends durable observations from your Claude Code sessions — decisions, bugfixes, learnings, file summaries — stores them in a local SQLite database, and injects the relevant ones back into context the next time you work on the same project.

Zero-config: one `somtum init` and every session end is captured automatically. No server, no cloud account, no mandatory tuning.

---

Table of Contents

• Why Somtum?
• How it works
• Requirements
• Install
• Quickstart
• Verifying the setup
• Dashboard
• CLI Reference
• MCP Server
• Storage Layout
• Configuration
• Privacy
• Token Accounting
• Performance
• Development
• Troubleshooting
• License

**v2.0.0** — Global DB (`~/.somtum/global.db`) · cross-project workspace recall · memory deduplication (`superseded_by`) · `--show-superseded` on `somtum list` · stats instrumentation fix · dashboard dark-mode redesign

**v1.5.0** — Multi-page VitePress docs site · `somtum list` · `somtum reset` · `somtum forget --all` · embeddings timeout safety · config crash-resilience · `injection.max_chars` wired up · warm-start race fix · auth-error hints

**v1.3.0** — Auto-inject memories on every prompt · `update` MCP tool · warm-sta