Prism

Local-first Software Intelligence Engine for humans and AI agents.

Website: https://www.prismhq.in · Docs: https://www.prismhq.in/docs · Get started: https://www.prismhq.in/docs/start/get-started

Maps, graphs, blast radius, health — on your machine. No account. Nothing uploaded for core analysis.

Prism is not an AI coding assistant. It is the intelligence layer behind an IDE extension, a CLI, and an MCP server that agents can call.

Table of contents

1. Get started in 60 seconds
2. Install — step by step
   • A. CLI
   • B. MCP (agents)
   • C. IDE extension
3. CLI — commands
4. MCP — tools & how agents use them
5. Docs
6. Privacy
7. Build from source
8. License

Get started in 60 seconds

Needs Node.js 22+. No need to clone this repository.

# 1) Go to your project
cd /path/to/your/project

# 2) CLI — no --workspace; uses git root from where you run
npx -y @repo-prism/cli doctor
npx -y @repo-prism/cli dna
npx -y @repo-prism/cli health

# 3) MCP once (Claude Code), then ask in plain English — no tool names:
#    claude mcp add prism -- npx -y @repo-prism/mcp-server
#    “How healthy is this repo?” / “What breaks if I change src/index.ts?”

All surfaces call the same Core SDK. None re-implements analysis.

Install — step by step

A. CLI — @repo-prism/cli

1. cd into your project.
2. Run doctor:
   Terminal

   Copy

   npx -y @repo-prism/cli doctor
   

3. Confirm Workspace points at your repo (from git root is normal). A warn on Index cache on first run is expected.
4. Analyse:
   Terminal

   Copy

   npx -y @repo-prism/cli dna
   npx -y @repo-prism/cli health
   npx -y @repo-prism/cli blast src/index.ts --fail-on high
   

5. Optional global install:
   Terminal

   Copy

   npm install -g @repo-prism/cli
   prism doctor
   prism health --verbose   # shows workspace + index timing
   

Package: npmjs.com/package/@repo-prism/cli · Guide: CLI docs

B. MCP — @repo-prism/mcp-server

Set up once. Then ask the agent in plain language — never type tool names like repository_health. The server tells the agent which tools to call.

One-click (Cursor)

Add to Cursor · Install guide · Benchmarks

Copy-paste config (Cursor / Claude Desktop)

{
  "mcpServers": {
    "prism": {
      "command": "npx",
      "args": ["-y", "@repo-prism/mcp-server"]
    }
  }
}

Save as .cursor/mcp.json (project) or add to Claude Desktop config. Enable in Settings → MCP (~40 tools).

Claude Code

1. cd /path/to/your/project
2. claude mcp add prism -- npx -y @repo-prism/mcp-server
3. Restart Claude Code if it was already running.
4. Ask: “What is this repository?” or “How healthy is this codebase?”

Cursor (manual)

If the one-click link above does not work:

1. Open the project folder in Cursor.
2. Create .cursor/mcp.json:
   config.json

   Copy

   {
     "mcpServers": {
       "prism": {
         "command": "npx",
         "args": ["-y", "@repo-prism/mcp-server"]
       }
     }
   }
   

3. Settings → MCP → enable prism → wait for ~40 tools.
4. In Agent chat, ask normally (no tool names).

Claude Desktop / Codex

Same npx / @repo-prism/mcp-server config — no --workspace. Full numbered steps for every client: MCP install.

Only add --workspace / PRISM_WORKSPACE if auto-detection picks the wrong folder.

Package: npmjs.com/package/@repo-prism/mcp-server

C. IDE extension (Prism)

1. Install Prism (Marketplace / Open VSX id prismhq.repo-prism):
   • VS Code — Marketplace or search Prism
   • Cursor — Open VSX or Install from VSIX
2. Open Folder on your project.
3. Command Palette → Prism: Open Prism.
4. Wait for indexing; use the UI.
5. (Cursor) Also complete B. MCP so the agent shares the same analysis — IDE install.

CLI — commands

Global flags: -w/--workspace, --json, --no-color, -q/--quiet, --verbose, -y/--yes.

Exit codes: 0 ok · 1 gated finding (--fail-on) · 2 usage error · 3 Prism failed.

Diagnostics

Understand

Assess a change

Structure

Reports

CI sketch:

- uses: actions/setup-node@v4
  with:
    node-version: "26.5.0"
- run: npx -y @repo-prism/cli review --base origin/main --fail-on high
- run: npx -y @repo-prism/cli cycles --fail-on any

MCP — tools & how agents use them

28 read-only tools + 3 optional prompts (orient, before_edit, review_diff). No network. No consent APIs for agents.

You do not type tool names. After MCP is connected, ask in plain language — the server’s instructions tell the agent when to call which tool.

Setup steps: MCP install · Full tool list: MCP tools.

Demo — with vs without Prism

Side-by-side script: plans/notes/M-063-demo.md · measured savings: prismhq.in/benchmarks

1. Ask “What is this repository?” — Prism returns DNA + landmarks in 2–3 calls; a naive agent walks directories.
2. Ask “Is this edit safe?” on a file — blast_radius replaces scanning the tree for imports.

Reproduce numbers: bun run bench:orientation (after bun run build).

Docs

Site: https://www.prismhq.in/docs

Markdown sources also live in docs/ in this repo. Local preview: bun run docs:dev

Privacy

Core analysis makes no network requests (proven by a trap test suite). Optional features (GitHub, PageSpeed, Gravatar, …) are off by default and gated per purpose in ~/.prism/workspaces/<key>/consent.json. Agents cannot grant consent.

→ PRIVACY.md · SECURITY.md

Build from source

For contributors (not required to use CLI/MCP):

git clone https://github.com/Shailesh200/prism
cd prism
nvm use          # Node 26.5.0
bun install
bun run build
bun run verify:milestone

See CONTRIBUTING.md.

Published npm packages under this org: @repo-prism (cli, mcp-server, core, and engine libraries).

License

MIT