Nº INSTALL

Install Prism

About five minutes. One engine behind CLI, IDE, and MCP. You do not need to clone this repo.

  1. 01

    Prerequisites

    • Node.js 26+ — node -v should start with v26.
    • A TypeScript / JavaScript folder — open or cd into it.
    • Git is recommended (Dispatch and worktrees) but not required for analysis.
  2. 02

    Pick a surface

    Add the others later — they share the same local index.

    Guide →
    code --install-extension prismhq.repo-prism

    Or search Prism in VS Code / Cursor Extensions

    IDE extension id prismhq.repo-prism.

    MCP: npx -y --prefer-online @repo-prism/mcp-server@latest

  3. 03

    prism init

    In chat, say prism init. The worker matches the host. It never asks you to paste an API key. If Cursor shows a card titled “Authenticating prism…” with Skip, that is host tool-approval — click Skip, then retry init.

  4. 04

    Confirm it works

    SurfaceYou should see
    CLIdoctor prints a workspace path; dna prints a report
    IDEPrism panel opens after indexing
    MCP41 tools listed; the agent answers with repository structure
  5. 05

    What Prism writes

    Derived cache. Let Prism add .prism/ to .gitignore when offered — including dispatch/.

    $npx -y @repo-prism/cli doctor

Surfaces

Compact install paths. Same engine.

  • 01

    CLI

    Terminal and CI. Same Core as every other surface.

    npx -y @repo-prism/cli doctor
    Guide →
  • 02

    VS Code & Cursor

    Map, blast, health, and the Console inside the editor.

    Marketplace: prismhq.repo-prism
    Guide →
  • 03

    MCP server

    41 structural tools for agents, local-first.

    npx -y --prefer-online @repo-prism/mcp-server@latest
    Guide →
  • 04

    Plugin pack

    Skills that compose Prism's tools with the connectors you already have.

    Install “Prism” from your editor's plugins
    Guide →
  • 05

    Core SDK

    Programmatic access for custom surfaces.

    npm install @repo-prism/core
    Guide →

MCP one-click

Add to Cursor
Or paste into `.cursor/mcp.json`
{
  "mcpServers": {
    "prism": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@repo-prism/mcp-server@latest"
      ],
      "env": {
        "NODE_USE_SYSTEM_CA": "1"
      }
    }
  }
}

Project root, or ~/.cursor/mcp.json for every project. Then Settings → MCP → enable prism (41 tools).

Next: Quickstart · Usage · Dispatch · Full install guide