BitRaptors Archie Viewer — Blueprint Inspector
Open the blueprint viewer in your browser to inspect generated artifacts.
Prerequisites: Requires .archie/viewer.py and a built .archie/viewer/dist/. If either is missing, tell the user to run npx @bitraptors/archie first.
The viewer renders the same React UI the share flow uses (archie-viewer.vercel.app). It works against whatever data exists — once {{COMMAND_PREFIX}}archie-deep-scan has produced a blueprint you'll see health scores, findings, rules, and the architecture diagram.
Update notice (run before launch, silent unless action needed)
python3 .archie/update_check.py check 2>/dev/null
If output is non-empty:
UPGRADE_AVAILABLE old new→ mention once:"Archie {new} is available (installed: {old}). Upgrade: npx @bitraptors/archie@latest \"$PWD\"". Continue.JUST_UPGRADED old new→ say"Archie upgraded {old} → {new}."once, then continue.
Telemetry consent (one-time, run before anything else)
Read and follow {{WORKFLOW_ROOT}}/_shared/telemetry-consent.md. It checks whether this machine has been asked about anonymous usage telemetry and, if not, presents a one-time interactive opt-in. It self-skips after the first answer and on non-interactive sessions.
Launch
python3 .archie/viewer.py "$PWD"
The viewer auto-opens in your default browser at http://localhost:5847/local. Press Ctrl+C to stop.
Optional flags: --no-open (suppress browser), --api-only (JSON endpoint only, for contributors running vite dev separately).
Telemetry (run after the viewer command returns, silent if opted out)
python3 .archie/telemetry_sync.py record-event --command viewer --outcome success --project-root "$PWD" 2>/dev/null || true