Prism Coder

Fetch the full content of a web page or documentation URL. Use AFTER brave_web_search when you need the complete spec or example from a specific URL. Strips HTML and returns readable text.

Performs in-depth analysis of research papers using Google's Gemini-2.0-flash model. Ideal for academic research, literature reviews, and deep understanding of scientific papers. Can extract key findings, provide critical evaluation, summarize complex research, and place papers within the broader research landscape. Best for long-form academic content that requires expert analysis.

Returns local-model inference metrics — call count, local vs cloud split, token totals, per-model breakdown, and average latency. period: 'session' (default) reports this MCP process's prism_infer delegation only. period: 'all' imports the Synalux VS Code panel spool and reports persisted MCP + panel usage across restarts, including the panel local-serve rate. This does not include the host model's (Claude's) own token spend (use /cost for that).

Downvote a memory entry to decrease its importance. Importance cannot go below 0.

Selectively forget (delete) accumulated knowledge entries. Like a brain pruning bad memories — remove outdated, incorrect, or irrelevant session entries to keep the knowledge base clean and relevant. Forget modes: - **By project**: Clear all knowledge for a specific project - **By category**: Remove entries matching a category (e.g. 'debugging') - **By age**: Forget entries older than N days - **Full reset**: Wipe everything (requires confirm_all=true) ⚠️ This permanently deletes ledger entries. Handoff state is preserved unless explicitly cleared.

Ingest source code or documentation into the knowledge graph. Feed your codebase to Prism so knowledge_search can retrieve it at inference time. Accepts raw source code, file paths, or a git repo URL. The content is chunked, Q&A pairs are generated, and stored in the knowledge graph. Use this when the user says 'learn this code', 'index my repo', or 'ingest this file'.

Search accumulated knowledge across all sessions by keywords, category, or free text. The knowledge base grows automatically as sessions are saved — keywords are extracted from every ledger and handoff entry. Use this to find related past work, decisions, and context from previous sessions. Categories available: debugging, architecture, deployment, testing, configuration, api-integration, data-migration, security, performance, documentation, ai-ml, ui-frontend, resume

Set an automatic data retention policy (TTL) for a project's memory. Entries older than ttl_days will be soft-deleted (archived) automatically on every server startup and every 12 hours while running. **Use cases:** - Set `ttl_days: 90` to auto-expire sessions older than 3 months - Set `ttl_days: 0` to disable auto-expiry (default) **Note:** Rollup/compaction entries are never expired — only raw sessions.

Auto-sync graduated insights (importance >= 7) into your project's IDE rules file (.cursorrules or .clauderules). This bridges behavioral memory with static IDE context — turning dynamic agent learnings into always-on rules. **How it works:** 1. Fetches graduated insights from the ledger 2. Formats them as markdown rules inside sentinel markers 3. Idempotently writes them into the target file at the project's configured repo_path **Requirements:** The project must have a repo_path configured in the dashboard. **Idempotency:** Uses `<!-- PRISM:AUTO-RULES:START -->` / `<!-- PRISM:AUTO-RULES:E…

Upvote a memory entry to increase its importance (graduation). Entries with importance >= 7 become 'graduated' insights that always surface in behavioral warnings.

List files and directories at a path. Use to understand project structure before reading or generating code.

Reports what prism's local serving displaced, in TOKENS: volume handled by a local model instead of the cloud, calls served locally vs routed, and a per-model breakdown. Reports tokens, never money — prism cannot know your host's current rates, which model a call would otherwise have used, or whether you are on a flat plan, so any dollar figure would be invented. period: 'all' (default, durable ledger), 'month'/'week' (trailing 30/7 days), or 'session' (this MCP process); 'days' sets a custom trailing window. Excludes refused calls and states its known undercounts inline.

Reclaim disk space after large purge operations by running VACUUM on the local SQLite database. Best called after `deep_storage_purge` removes many entries — SQLite reclaims page allocations only when explicitly vacuumed, so the file size stays the same until you call this tool. For remote (Supabase) backends, returns guidance on triggering maintenance via the dashboard. **Note:** On large databases this may take up to 60 seconds. The tool runs synchronously so you will know when it is safe to proceed.

Time travel! Restores the project's memory to a specific past version. This overwrites the current handoff state with the historical snapshot, like a Git revert — the version number moves forward (no data is lost). Call memory_history first to find the correct target_version.

View the timeline of past memory states for this project. Use this BEFORE memory_checkout to find the correct version to revert to. Shows version numbers, timestamps, and summaries of each saved state.

Get the latest version, description, and peer dependencies for an npm package. Use when you need the exact API surface of a JavaScript/TypeScript library.

Interactive setup wizard for new Prism users. Provides a step-by-step guided experience to get productive in under 3 minutes. **Actions:** - `start` (default when omitted) — Begin the wizard from step 1 - `next` — Advance past `step` (pass the step number you are on) - `status` — Check current wizard progress - `skip` — Skip to completion Each step returns instructions, code snippets, and progress percentage.

Run inference on a local prism-coder model (Ollama) for stable factual questions: ABA/BCBA concepts, TypeScript/Node.js syntax, math, Prism MCP architecture. Returns answer from local model, costs $0.

Get the latest version and requirements for a Python package from PyPI. Use when generating Python code that depends on specific library versions.

Query memories using natural language instead of structured tool syntax. Searches Prism memory first. When memory has no useful result, paid tiers automatically run one quick Synalux web search, preserve the raw sources, and synthesize a grounded answer through prism_infer. Reserved or uncertain content is cloud-or-refuse and never sent through the local web-grounded path. **Examples:** - "What did we decide about authentication?" - "What's still open on the billing project?" - "What files did we change last week?" - "Show me recent work on the API" Returns the parsed intent, search results,…

Read the contents of a local file. Use to inspect existing code, config files, or docs before generating additions.

Triggers an autonomous research pipeline on a specific topic. Discovers scientific papers and journals with web search (Synalux portal or your BRAVE_API_KEY) or free academic sources, extracts their content, synthesizes a comprehensive markdown report, and saves the result to the Mind Palace ledger. Best for deep clinical research, literature reviews, and evidence-based practice updates.

Abort a running Dark Factory pipeline. The pipeline will be marked as ABORTED and the background runner will stop processing it on the next tick. **Note:** This is a 'kill switch' — the runner detects the status change via the storage status guard and gracefully stops execution.

Repair ledger entries that are missing vector embeddings. This can happen if the Gemini API was temporarily unavailable when the entry was saved. How it works: 1. Scans for active ledger entries where embedding IS NULL 2. Generates embeddings via Gemini text-embedding-004 3. Patches each row with the generated embedding Run this periodically or after known API outages to ensure full semantic search coverage.

Retroactively create graph edges (memory links) for all existing entries in a project. This builds the associative memory graph from your existing session history. Three strategies are run: 1. **Temporal Chaining**: Links consecutive entries within the same conversation 2. **Keyword Overlap**: Links entries sharing ≥3 keywords (bidirectional) 3. **Provenance**: Links rollup summaries to their archived originals All strategies use INSERT OR IGNORE — safe to re-run multiple times. **When to use:** Run once after upgrading to v6.0 to populate the graph for existing memories. New entries are au…

IMPORTANT: On the first user turn of every conversation, including a greeting, call this tool exactly once before any user-facing response, passing the user's verbatim first message as {prompt: "<first user message>"}. The prompt is matched against prompt_keywords ON-DEVICE to load symptom-triggered skills on turn one; it is used for routing only and never leaves the machine. Pass {} only when there is no user message. Do not substitute session_load_context for this startup call. This starts a Prism-backed conversation without host hooks. Prism reads the dashboard's Auto-Load Projects, Context…

Check the status of a Dark Factory pipeline. Returns the current step, iteration count, and any error messages. **Statuses:** - `PENDING` — Queued, waiting for runner pickup - `RUNNING` — Currently executing a step - `COMPLETED` — Successfully finished all steps - `FAILED` — Encountered an error or exceeded limits - `ABORTED` — Manually cancelled

Resolve an HDC compositional state into a nearest semantic concept with policy-gated routing. Returns concept, confidence, distance, ambiguity, convergence steps, and route outcome. Use this for explainable cognitive recall decisions in v6.5.

Auto-compact old session ledger entries by rolling them up into AI-generated summaries. This prevents the ledger from growing indefinitely and keeps deep context loading fast. How it works: 1. Finds projects with more entries than the threshold 2. Summarizes old entries using Gemini (keeps recent entries intact) 3. Inserts a rollup entry and archives the originals (soft-delete) Use dry_run=true to preview what would be compacted without executing.

Detect whether the current agent session has semantically drifted from its original goal. Scores recent ledger entries against the goal using synalux's HRR embedding stack (GloVe → Gemini/Voyage → cosine similarity), then runs the rolling-window drift detector algorithm. **Triggers:** - `goal-drift` — cumulative alignment loss is high and monotonic (not random tangents) - `context-collapse` — average output quality has dropped below floor **Pre-warning:** - `quality-degrading` — quality slope steeply negative before collapse **Returns:** drifted, reason, warning, drift_score (0..1), goal_al…

Export all of a project's memory to a local file. Fulfills GDPR Article 20 (Right to Data Portability) and the 'local-first' portability promise. **What is exported:** - All session ledger entries (summaries, decisions, TODOs, file changes) - Current handoff state (live project context) - System settings (API keys are "**REDACTED**" for security) - Visual memory index (descriptions, captions, timestamps; not the raw files) **Formats:** - `json` — machine-readable, suitable for import into another Prism instance - `markdown` — human-readable, ideal for static archiving - `vault` — Prism-Port:…

Forget (delete) a specific memory entry by its ID. Supports two modes: - **Soft delete** (default): Tombstones the entry — it stays in the database for audit trails but is excluded from all search results. Reversible. - **Hard delete**: Permanently removes the entry from the database. Irreversible. Use only when GDPR Article 17 requires complete erasure. ⚠️ Soft delete is recommended for most use cases. The entry can be restored in the future if needed.

Run integrity checks on the agent's memory (like fsck for filesystems). Scans for missing embeddings, duplicate entries, orphaned handoffs, and stale rollups. Checks performed: 1. **Missing embeddings** — entries that can't be found via semantic search 2. **Duplicate entries** — near-identical summaries wasting context tokens 3. **Orphaned handoffs** — handoff state with no backing ledger entries 4. **Stale rollups** — compaction artifacts with no archived originals Use auto_fix=true to automatically repair missing embeddings and clean up orphans.

Manually trigger the Sparse Distributed Memory (SDM) Intuitive Recall to surface latent patterns and related memories for a given query without blowing up the context window. Uses high-speed JS-space Hamming distance scanning on compressed embeddings.

Load session context for a project. Must be called before session_save_ledger or session_save_handoff. Returns project context and operating boundaries.

Call this at the START of any turn where the user states a NEW task, changes the kind of work, or reports a defect — passing their verbatim message as {prompt: "..."} and the skills you already have as {loaded: [...]}. session_bootstrap routes only the first turn of a conversation; this routes every turn after it, so a long session still picks up the skills its current work requires. The prompt is matched ON-DEVICE against the same table and the same account-scoped frontmatter triggers; it never leaves the machine. Calling it is cheap: when nothing new matches it returns a single line, and any…

Record a typed experience event. Unlike session_save_ledger (flat logs), this captures structured behavioral data for pattern detection. Event Types: - **correction**: Agent was corrected by user - **success**: Task completed successfully - **failure**: Task failed - **learning**: New knowledge acquired - **validation_result**: Verification sandbox passed or failed

Upsert the latest project handoff state for the next session to consume on boot. This is the 'live context' that gets loaded when a new session starts. Calling this replaces the previous handoff for the same project (upsert on project). **v5.4 CRDT Merge**: On version conflict, a CRDT OR-Map engine automatically merges your changes with concurrent work (Add-Wins OR-Set for arrays, Last-Writer-Wins for scalars). Pass expected_version to enable concurrency control. **v0.4.0 OCC**: If you received a version number from session_load_context, /resume_session prompt, or memory resource attachment,…

Save a local image file into the project's permanent visual memory. Use this to remember UI states, diagrams, architecture graphs, or bug screenshots. The image is copied into Prism's media vault and indexed in the handoff metadata. On the next session_load_context, the agent will see a lightweight index of available images.

Save session ledger (what was done this session). Requires session_load_context to have been called first.

Search session history semantically (by meaning, not just keywords). Uses vector embeddings to find sessions with similar context, even when the exact wording differs. Requires pgvector extension in Supabase. Complements knowledge_search (keyword-based) — use this when keyword search returns no results or when the query is phrased differently from stored summaries.

Start an autonomous Dark Factory pipeline. The pipeline runs in the background and executes a PLAN → EXECUTE → VERIFY cycle up to `max_iterations` times. **Requires:** Dark Factory is enabled at startup (enabled by default; the dashboard setting applies when no explicit `PRISM_DARK_FACTORY_ENABLED=true|false` override is present). **How it works:** 1. Call this tool with an objective (what to accomplish) 2. The pipeline is queued and executes autonomously in the background 3. Use `session_check_pipeline_status` to poll for results **Safety:** - Pipelines are scoped to a `working_directory` …

Step 3A Edge Synthesis: Scans recent project entries with embeddings, finds high-similarity but currently disconnected entries, and creates inferred links as 'synthesized_from'. **On-Demand Graph Enrichment**: Use this tool periodically to discover semantic relationships between structurally disconnected memory nodes. It batch processes the newest active entries.

Analyze a coding task and recommend whether it should be handled by the host cloud model or delegated to Prism's local memory-aware worker (Qwen3). The `claw` target value is retained for API compatibility. **How to use:** 1. Call this tool before delegating a bounded subtask 2. Read the `target` field in the response 3. If target is `claw`, call the returned `recommended_tool` (`prism_infer`) with `recommended_args` 4. If target is `host`, handle the task yourself Bounded high-complexity inference may still target `claw`; the forwarded 1-10 complexity selects 4B/9B/27B inside `prism_infer`.…

Retrieve an image from visual memory using its ID. Returns the image as Base64 inline content for the LLM to analyze. Use session_load_context first to see available image IDs.

Run a safe, read-only shell command to verify code syntax or run tests. Allowed commands: node --check, python3 -c (syntax only), tsc --noEmit, npm test, pytest, cargo check, git log/status/diff.

Manage scoped skills and platform-skill activation. Actions: list (your skills, team skills, releases); delete (remove a user/team/local skill — the final content is archived locally first); release (deactivate a PLATFORM skill you never use, freeing host catalog budget — per user, or per team by admins); restore (re-activate a released platform skill; lossless).

Save a skill at one of three scopes: local (this machine only, works signed out), user (your account — follows you to every machine), or team (a workspace — delivered to its members; owner/admin only, optionally targeted with assign_to). Default when signed in is USER; team is never a default. Content must be a SKILL.md body with frontmatter (name, description). To make the skill load automatically when a prompt matches, add prompt_triggers to the frontmatter — a list of up to 5 case-insensitive regexes. They stay as private as the skill itself (matching happens on-device; scoped skills cannot…

Pulls this account's synced handoff for a project from the E2E relay and opens it with THIS machine's device key. The relay stores ciphertext only; a handoff is readable here only if it was sealed to this device. Requires handoff sync enabled (prism handoff enable), a paid plan, and a signed-in account. Push happens automatically on session_save_handoff.

Call BEFORE editing behavioral source files (API routes, ordering logic, billing, auth, migrations). Returns a domain-specific scenario you must answer to demonstrate understanding of the end-user impact. Example: editing a KDS route returns 'A cook has a 3-item ticket. One item is voided. What should the cook see?' Answer the scenario concretely before proceeding with the edit. If the MCP transport is unavailable, use the packaged `prism verify-behavior` CLI fallback; never fabricate a replacement scenario.

Performs a web search using the You.com Search API, ideal for general queries, news, articles, and current events. Returns formatted results with titles, URLs, and descriptions. Configure with the YDC_API_KEY environment variable. Get a key at https://you.com/platform/api-keys