Decant

Decant

[](https://www.npmjs.com/package/@dosu/decant) [](https://www.npmjs.com/package/@dosu/decant) [](https://github.com/dosu-ai/decant/actions/workflows/ci.yml) [](https://scorecard.dev/viewer/?uri=github.com/dosu-ai/decant) [](LICENSE)

Decant turns the Claude Code and Codex session logs on your machine into tangible insights. See where tokens, cost, and agent time go, inspect context usage, find the files and tools agents touch, and search complete transcripts from a CLI or local web UI.

Decant is local-first. It makes no outbound network calls at runtime, and your transcripts never leave your machine.

It does keep a copy of them. To make sessions searchable, Decant writes prompts, tool inputs, tool output, and canonicalized raw records for retained transcript messages into an **unencrypted** SQLite archive at `~/.decant/decant.db`, with a full-text index over the prompt and tool-argument text. Whatever your agents read is in there too — source code, file contents, local paths, and any credentials pasted into a session. Decant creates the archive owner-only (`0600`). If your organization has a retention policy for agent transcripts, this archive is subject to it. See [What the archive stores](docs/data-lifecycle.md#what-the-archive-stores) to inspect, delete, or remove it.

Built by [Dosu](https://dosu.dev?utm_source=decant&utm_medium=github&utm_campaign=attribution&utm_content=readme), Knowledge Infrastructure for Agents. Dosu helps make agents faster, cheaper, and more effective.


Quick start

Run Decant