prism0x2A

Local-first code intelligence dashboard for any project.

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

Install

npm install --save-dev prism0x2a

Quickstart

npx prism init       # scaffold .prism/config.json
npm run prism        # open dashboard at http://localhost:3001

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

CLI Reference

prism dev [--port N] [--target PATH]
    Start the dashboard. Auto-detects a free port starting from 3001.
    --port    Port to listen on (default: 3001)
    --target  Directory to scan  (default: cwd)

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

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

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.