Plugin Overview

The Prism plugin runs inside Claude Code with six automatic hooks and eight slash commands. The hooks run silently in the background; the commands are on-demand.

Automatic hooks

These run without any commands — they’re always active once the plugin is installed:

Hook	Trigger	What it does
`SessionStart`	Session begins	Checks your API key and the OTEL settings, and reports what it found
`UserPromptSubmit`	Before each prompt	Captures the prompt to Prism
`CwdChanged`	You switch working directory	Keeps the session’s project context accurate
`PostCompact`	After `/compact`	Resets the per-compaction session state
`PostToolUse`	After a `SendMessage` tool call	Captures git and prompt “evidence” that links your changes to the prompt that drove them
`Stop`	After each response	Sends the response and the turn’s metadata to Prism

The hooks never block your prompt — if anything fails, the prompt still goes through.

What the plugin does not do in your terminal

It does not score your prompt locally, and it does not print coaching lines or rewrite suggestions. Scoring runs on the server after the prompt is captured, and coaching surfaces on the dashboard.

The one thing it can print is a short realtime summary after a completed turn, and that is off unless you turn it on:

/prism:config set show_realtime_summary true

Slash commands

Run these explicitly during a session:

Command	Purpose
`/prism:setup [key]`	Configure your API key and enable telemetry
`/prism:status`	Connection health, install scope, and what’s configured where
`/prism:config`	Show or update the settings you can change
`/prism:doctor`	Diagnose configuration and connectivity issues
`/prism:realtime`	This session’s live summary (grade, cost, turns)
`/prism:report`	Weekly review — this week vs last week, Prompt Score, habits, worst prompts
`/prism:help`	List all commands
`/prism:uninstall`	Remove Prism’s settings and OTEL config

See Commands for the detailed reference.

Where coaching lives

The plugin does not ship in-terminal prompt coaching, prompt rewrites, or an always-active advisor. Analysis runs on the server after each prompt is captured, and the results surface on the dashboard:

Inline annotations in session replay — which prompt-rubric checks failed, and why
Coaching cards on your personal report
The Task advisor on the Realtime view — per sub-session, with an example rewrite
Advisor & Summaries

Config

The plugin stores its config at ~/.prism/config.json, and that file is the only place it reads settings from. Two values are yours to change:

Field	Purpose
`show_realtime_summary`	Print a short summary in the terminal after a turn. Off by default.
`ingest_url`	Which Prism to talk to. Only relevant if you run your own.

apiKey and dashboard_url are also stored there but managed for you — /prism:setup owns the key, and the dashboard address comes from the server. See Configuration.