Security Policy#
Supported versions#
Security fixes apply to the latest release and current main. Verify issues
against one of those builds before reporting.
Reporting a vulnerability#
Do not open a public issue for security vulnerabilities.
Report privately through
GitHub's private vulnerability reporting flow,
reachable from the repository's Security tab. Include:
- a description of the issue and impact,
- steps to reproduce or a proof of concept,
- affected version/commit and environment,
- any suggested remediation.
We aim to acknowledge reports within a few days and will keep you updated while
we investigate and prepare a fix.
Scope and threat model#
Decant is a local-first tool. It reads CLI session logs that already exist on
disk (by default ~/.claude/projects, ~/.codex, ~/.gemini/tmp, OpenCode's
~/.local/share/opencode, ~/.cursor/chats, ~/.copilot/session-state,
the chat session files in VS Code's User directory, Hermes Agent's
~/.hermes/state.db, Pi's ~/.pi/agent/sessions, and ATIF trajectories in
~/.decant/atif)
and writes a local SQLite archive. Its only outbound network requests are for
updates, and none of them send session or archive data:
- A daily version check against the npm registry. Checks are off by default.
Turn them on in Settings or withDECANT_UPDATE_CHECK=1.
DECANT_UPDATE_CHECK=0turns them off whatever Settings says. decant update, which runs only when you start it. It always asks the npm
registry for the latest version, even with checks off and with--check.
It then updates through npm or Homebrew, or downloads the binary from GitHub
Releases, or from the mirror inDECANT_BASE_URLwhen that is set.
decant serve is intended for local use and binds to 127.0.0.1 by default.
In scope:
- Parser handling of malformed or adversarial session files.
- The local web UI exposing the archive beyond the local machine.
- Another website driving the local web UI, for example by framing it or by
sending cross-origin writes to its API. - Unsafe filesystem access through settings or launcher paths.
- Accidental inclusion of secrets, transcripts, or archive data in the repo.
Out of scope:
- Running the local UI on an untrusted or public network without your own
hardening. - Vulnerabilities in upstream dependencies, though a heads-up is welcome.
- Content readable in the archive by someone who already has read access to your
user account. The archive is protected by filesystem permissions, not
encryption.
Handling your data#
Your session transcripts and archive can contain sensitive content and should
stay on your machine. Never commit a real archive or session data. The committed
fixtures are synthetic, and test/golden/ must stay derived from those fixtures
only.
The archive is a second, durable copy of your transcripts, and it is not
encrypted. ~/.decant/decant.db holds prompts, tool arguments, tool output, the
canonicalized raw records for retained transcript messages, and absolute local
paths. In practice that means source code, file contents, and any credentials
that passed through a session.
Decant creates it at mode 0600, and creates ~/.decant at 0700 when it
creates that directory; an existing directory keeps its own mode. Deleting a
session removes its rows, but deleted text may remain recoverable in freed pages
until decant db vacuum rewrites the archive. See
What the archive stores for
how to inspect and remove it.