PhantomTrace CLI

Privacy-first product forensic engine — Socratic introspection, product.md generation, strategic drift scans, git hooks, and local (Ollama) or cloud LLMs. PII is scrubbed before any cloud call.

Install

npm install -g phantomtrace
# or run without installing:
npx phantomtrace --help

Requires Node.js 18+. For local-only mode, install Ollama and pull a model (for example ollama pull qwen2.5-coder).

Quick start

cd your-repo
phantomtrace introspect --local   # or omit --local if using OPENAI_API_KEY
phantomtrace init

Then use phantomtrace scan, phantomtrace gate, phantomtrace verify, etc. See the full documentation in the Flow repo for every command and environment variable.

Ship / publish (maintainers)

From the monorepo root:

npm run test -w phantomtrace
npm run typecheck -w phantomtrace
npm publish -w phantomtrace --access public

Or from this directory after npm install:

npm run prepublishOnly
npm publish --access public

Before the first publish, confirm the package name is available: npm view phantomtrace (if the name is taken, change "name" in package.json or use a scoped package @your-scope/phantomtrace).

Monorepo note

This package is developed inside flow-ai under packages/phantomtrace-cli. The Flow web app depends on it via workspace:*; npm consumers only install phantomtrace, not the SPA.