Security Policy#
Supported versions#
Decant is pre-1.0 and under active development. Security fixes apply to the
latest main. Until a stable release line exists, verify issues against current
main 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, offline tool. It reads CLI session logs that already
exist on disk (~/.claude, ~/.codex), writes a local SQLite archive, and makes
no outbound runtime network requests. 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.
- 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.
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.