English Français العربية

Prism

السجل الرسمي الصحة

Local-first repo intelligence for agents: DNA, health, blast radius, and Dispatch jobs.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Prism؟

  • Prepare, before the agent edits. The files and tests that matter for
  • Match the code, during the edit. Prism points at a file from your repo
  • Lens review, after. Dev, Architect and QA lenses flag the callers the
  • The receipt, when the agent stops. Prism runs the checks the change

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @repo-prism/mcp-server
Claude Code 
claude mcp add prism -e 'PRISM_WORKSPACE=<PRISM_WORKSPACE>' -e 'CURSOR_API_KEY=<your cursor_api_key>' -e 'PRISM_DISPATCH_ROLE=<PRISM_DISPATCH_ROLE>' -- npx -y @repo-prism/mcp-server@1.1.1 '<workspace>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "prism": {
            "command": "npx",
            "args": [
                "-y",
                "@repo-prism/mcp-server@1.1.1",
                "<workspace>"
            ],
            "env": {
                "PRISM_WORKSPACE": "<PRISM_WORKSPACE>",
                "CURSOR_API_KEY": "<your cursor_api_key>",
                "PRISM_DISPATCH_ROLE": "<PRISM_DISPATCH_ROLE>"
            }
        }
    }
}

متغيرات البيئة

  • PRISM_WORKSPACE Optional override when the MCP client starts from a directory outside the project.
  • CURSOR_API_KEY سري Optional override to spawn local Cursor SDK workers. Prefer prism init / first start_job (Cursor.auth.login). Do not put this in mcp.json for normal use.
  • PRISM_DISPATCH_ROLE Set to worker to skip Intelligence tools and hide start_job / start_my_day / init. Dispatch job agents do not attach Prism MCP.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Prism
  2. Get started
  3. What it does
  4. CLI
  5. Privacy
  6. Build from source
  7. License

Prism

Your agent's second pair of eyes. Know before you ship.

Local software intelligence that catches what the agent missed. Prism gives your coding agent the right files before it edits, then flags the code it skipped and the code no test covers. Free, MIT, and it runs on your machine: no account, and your code never leaves it.

Website: prismhq.in · Docs: prismhq.in/docs · Contact: hello@shaileshjha.in

Get started

npm install -g @prismapp/cli && prism install all

Run the second command inside your repository. prism install all connects every agent it finds. Quit the agent and open it again. The first use builds the index under ~/.prism/. One agent only: pass its name to prism install. The install records what it wrote in ~/.prism/install.json, and prism uninstall removes exactly that. A new version is npm install -g @prismapp/cli then prism upgrade. Memories, receipts, and habits stay.

Wiring another MCP host by hand? Use this server entry:

{ "mcpServers": { "prism": { "command": "npx", "args": ["-y", "@prismapp/mcp-server"], "env": { "PRISM_EXTRA_TOOLS": "receipt" } } } }

Then ask your agent in plain language, for example "what breaks if I change src/index.ts?" or "review my changes". You never type tool names.

What it does

  • Prepare, before the agent edits. The files and tests that matter for the task, and the helpers to reuse instead of rewriting.
  • Match the code, during the edit. Prism points at a file from your repo to copy, so the new code looks like the rest.
  • Lens review, after. Dev, Architect and QA lenses flag the callers the change left behind and the code no test covers. Add your own with prism lens.
  • The receipt, when the agent stops. Prism runs the checks the change reaches and gives one verdict: SHIP, NOT PROVEN (with the cheapest check to prove it) or NO-SHIP.

Nine default MCP tools; more are opt-in through extraTools in ~/.prism/config.json. Full list: MCP tools.

You sayThe agent calls
"What is this repo?"repository_overview
"I want to change X"prepare_change
"What breaks if I edit this file?"blast_radius, test_impact
"Where is this symbol, who uses it?"graph
"Review my changes"guard_session (review: true)
"Start my day" (a saved routine)habits
"Did I break anything?"the stop receipt, run by the hook

CLI

Every command answers from the same local index. Highlights:

CommandWhat it answers
prism prepare <task>The files to open and the helpers to reuse
prism review [paths] --lens qaA lens review of a change
prism blast <target>What depends on a file or symbol
prism test-impact <target>Which tests reach a file
prism receiptsThe last stop receipts
prism lens, prism habitYour review lenses and saved routines
prism doctorWhat is wired, and whether it works

Full list: CLI reference.

Privacy

Analysis makes no network requests; a trap test suite fails the build if one appears. The only request Prism makes is a once-a-day update check against the npm registry, which never relaunches anything and is off with PRISM_SKIP_SELF_UPDATE=1. → PRIVACY.md · SECURITY.md

Build from source

git clone https://github.com/Shailesh200/prism
cd prism
nvm use          # the version in .nvmrc
bun install
bun run build
bun run verify:milestone

See CONTRIBUTING.md and the changelog.

License

MIT

الأسئلة الشائعة

ما هو Prism؟

Local-first repo intelligence for agents: DNA, health, blast radius, and Dispatch jobs.

كيف أثبّت Prism؟

يعمل على جهازك. في Claude Code: claude mcp add prism -e 'PRISM_WORKSPACE=<PRISM_WORKSPACE>' -e 'CURSOR_API_KEY=<your cursor_api_key>' -e 'PRISM_DISPATCH_ROLE=<PRISM_DISPATCH_ROLE>' -- npx -y @repo-prism/mcp-server@1.1.1 '<workspace>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Prism إلى مفتاح API؟

نعم. يتطلب CURSOR_API_KEY، وتضبطها في إعداداته.

هل Prism مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Prism؟

ينشره Shailesh200. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.