prism0x2A

Local-first code intelligence dashboard for any project.

Install it. Open it. See what your codebase is actually doing.

Try the live demo → prism0x2a.dev/blue?demo=1 (read-only sample data from a fictional repo — no install required).

Scoring methodology and reference implementations are open and published as the prism-metrics npm package: https://github.com/dadenjo/prism-metrics

Quickstart (recommended)

Zero install — just run it in any project folder:

npx prism0x2a@latest                 # scan the current directory
npx prism0x2a@latest /path/to/repo   # scan a specific folder

The dashboard opens in your browser automatically. Your code never leaves your machine.

One-line installer

macOS / Linux:

curl -sSf https://prism.io/install | sh

Windows (PowerShell):

iwr -useb https://prism.io/install.ps1 | iex

Headless / CI

npx prism0x2a@latest scan --output json > prism.json

Optional: install locally as a dev dependency

npm install --save-dev prism0x2a
npx prism init        # scaffold .prism/config.json + add "prism" script
npm run prism         # open dashboard at http://localhost:3001

Dashboard scans the current directory by default. --target PATH points it anywhere.

CLI Reference

prism [<target>]
    Start the dashboard, scanning <target> (default: cwd).
    Auto-opens the browser and finds a free port starting from 3001.

prism dev [--port N] [--target PATH] [--no-browser]
    Same as the bare command, with explicit flags.
    --port        Port to listen on (default: 3001)
    --target      Directory to scan  (default: cwd)
    --no-browser  Skip auto-opening the browser (for CI / headless)

prism scan [<target>] [--output json|text] [--output-file PATH]
    Headless scan — no dashboard, just a blueprint.
    Writes .prism/blueprint.json in <target> and prints to stdout.
    --output       json (default) or text
    --output-file  Write JSON to this path instead of stdout

prism init
    Initialize prism0x2A in the current project.
    Creates .prism/config.json and adds a "prism" script to package.json.

prism demo
    Launch the dashboard with the bundled NexPay sample project.

prism --version
prism --help

What's Inside

| Layer | What it shows | |-------|--------------| | BLUE | Import cycles, dependency graph, churn hotspots, session replay | | AMBER | Test coverage heatmap, capability registry, coverage trends | | GREEN | Auto-generated insights, custom queries, cross-layer intelligence |

All analysis runs locally. Nothing is sent to a server.

Monorepo Support (Pro)

prism0x2A detects pnpm, npm, yarn, lerna, nx, and turbo workspaces automatically. A workspace switcher appears in the dock. Each workspace gets its own scan state.

Upgrade: Settings → License → Activate.

Architecture

app/
  blue/                  # BLUE layer — cycles, graph, churn
  amber/                 # AMBER layer — coverage, capabilities
  green/                 # GREEN layer — insights, queries
  settings/              # Settings — LLM provider + license
  api/                   # All API routes (scan, config, license, monorepo…)
lib/prism/
  blue/                  # BLUE scan store + types
  amber/                 # AMBER scan store + coverage store
  green/                 # GREEN insight + query stores
  monorepo/              # Monorepo detection (6 detectors)
  license/               # License types, store, validation
  hooks/                 # React hooks: useTargetPath, useActiveWorkspace, useLicense
bin/prism.js             # CLI — dev, init, --version, --help

Debug switches

• Append ?renderer=plain to any Ask GREEN / Ask AMBER / Ask BLUE URL to see the raw markdown the LLM returned (bypasses entity highlighting and any custom remark plugins).

Roadmap

| Phase | Description | |-------|-------------| | 0 | ✅ Scaffold, DS tokens, cycle detection | | 1 | ✅ CLI distribution — npm install --save-dev | | 2.0–2.3 | ✅ BLUE + AMBER + GREEN + Settings | | 2.4 | ✅ Monorepo support (v0.6.0) | | 0.6.1 | ✅ npm publish + License foundation | | 3 | CI integration, persistent scan cache, team features |

Brand

Typography: prism (regular weight) + 0x2A (mono, sky-500).
Always written: prism0x2A in plain text contexts.
CLI binary: prism.

Why "0x2A"? It's hex for 42.