# Viewer

> Archie Viewer — Blueprint Inspector

- Skill: `bitraptors/viewer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bitraptors/viewer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bitraptors/viewer/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: BitRaptors (https://skillmd.com/u/bitraptors)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/bitraptors/viewer

---

# 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)

```bash
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

```bash
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)

```bash
python3 .archie/telemetry_sync.py record-event --command viewer --outcome success --project-root "$PWD" 2>/dev/null || true
```