rogerchappel/logveil

LogVeil

LogVeil turns agent logs, terminal captures, JSONL transcripts, and chat exports into safe repro bundles you can review and share.

It is built for the awkward moment after an agent run fails: the log has useful evidence, but it may also contain home paths, API keys, tokens, emails, prompts, or private infrastructure details. LogVeil keeps the workflow local, deterministic, and scriptable.

Install

@rogerchappel/logveil is not published to the npm registry yet. Registry installation and npx are therefore unavailable until the first release.

Quick start from source

git clone https://github.com/rogerchappel/logveil.git
cd logveil
npm ci
npm run build
node dist/cli.js redact examples/agent-session.log --out repro-safe.md --json-out evidence.json
node dist/cli.js audit examples/agent-session.log --format json

To test the installable package from a checkout before publication, build a tarball and install it in a disposable directory:

npm run build
package_version="$(node -p "require('./package.json').version")"
package_tgz="/tmp/rogerchappel-logveil-${package_version}.tgz"
npm pack --pack-destination /tmp
consumer_dir="$(mktemp -d /tmp/logveil-example.XXXXXX)"
cd "$consumer_dir"
npm init --yes
npm install "$package_tgz"
./node_modules/.bin/logveil --help
rm -rf "$consumer_dir" "$package_tgz"

For a fuller fixture-backed walkthrough, see docs/tutorials/sanitize-agent-session.md. For a multi-file demo across log, JSONL, and Markdown chat export fixtures, see docs/tutorials/multi-format-agent-capture.md. Promotion-ready launch notes and short post drafts live under docs/promo/. For a gate-oriented recipe, see docs/tutorials/audit-before-sharing.md.

Runnable demos:

bash demo/sanitize-repro-bundle.sh
bash demo/sanitize-chat-export.sh
bash demo/sanitize-support-ticket.sh

The support-ticket demo uses a synthetic incident fixture and is documented in docs/tutorials/sanitize-support-ticket.md.

After installing the local tarball, use the project-local binary directly:

./node_modules/.bin/logveil redact ./session.log --out repro-safe.md
./node_modules/.bin/logveil audit ./session.log --format json --fail-on secret

Commands

redact

Produces a Markdown repro bundle by default.