Decant#
Decant shows where your coding agents spend tokens, money, and time. It keeps a
searchable archive of Claude Code, Codex, Gemini CLI, OpenCode, Cursor CLI,
GitHub Copilot CLI, Copilot Chat in VS Code, Hermes Agent, and Pi sessions, plus
imported ATIF trajectories. See token and cost breakdowns, context-window
usage, files touched, and tool usage, search prompts and tool calls, and browse
complete transcripts.
Decant is local-first. It makes no outbound network calls at runtime,
and your transcripts never leave your machine. The one exception is an update
check that stays off until you turn it on in Settings or with
DECANT_UPDATE_CHECK=1. Run decant update to install a newer release.
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, including 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.
Built by
Dosu,
Knowledge Infrastructure for Agents. Dosu helps make agents faster, cheaper,
and more effective.
Run without installing#
npx @dosu/decant@latest # start the local web UI
npx @dosu/decant@latest --help
npx @dosu/decant@latest ls
npx @dosu/decant@latest search "auth bug"
npx @dosu/decant@latest db info # what the archive holds and where
npx @dosu/decant@latest doctor # redacted environment report for bug reports
Install globally#
npm install --global @dosu/decant@latest
decant
The package is a small Node-compatible launcher that selects and runs the
matching compiled Decant binary. Node.js 18 or newer is required by the
launcher; Bun is not required.
Published binaries support:
- macOS arm64 and x64;
- Linux arm64 and x64.
Native Windows binaries are not currently available. If the matching optional
platform package was omitted during installation, reinstall without disabling
optional dependencies.
The local UI binds to http://127.0.0.1:3000 by default. Run
decant serve --no-open to keep Decant from opening a browser, or
decant --help for the complete CLI.
Documentation, alternative install methods, source, and issue tracking are at
https://github.com/dosu-ai/decant.
The Docker runtime is distroless and has no shell. It keeps UID/GID 999:999
so existing named volumes stay writable. See Docker setup and debugging.
Apache-2.0