Installation

Marketplace install (recommended)

The simplest way to install Prism:

/plugin marketplace add grumatic/optra-prism-plugin

This downloads the latest version from the Claude Code plugin marketplace and registers it automatically.

Then configure your API key:

/prism:setup gck_YOUR_API_KEY

Shell installer

Alternatively, install and configure in one step:

curl -sL https://optra-ai.com/install-plugin.sh | bash -s -- gck_YOUR_KEY

Team distribution

Add Prism to all team members by committing to your project’s .claude/settings.json:

{
  "plugins": [
    {
      "source": "marketplace",
      "name": "grumatic/optra-prism-plugin"
    }
  ]
}

Each developer runs /prism:setup with their own API key.

Manual install

If you need to install from source or a specific version:

# Clone the plugin repository
git clone https://github.com/grumatic/optra-prism-plugin.git ~/.claude/plugins/optra-prism

# Register in Claude Code settings
# Add to ~/.claude/settings.json under "plugins"

Local development install

For contributors or custom builds, use environment variable overrides:

# Point to your local plugin directory
export CLAUDE_PLUGIN_PATH=/path/to/optra-prism-plugin

# Override service URLs for local development
PRISM_INGEST_URL=http://localhost:9005 PRISM_GATEWAY_URL=http://localhost:3003 claude

Verify installation

After installing, run:

/prism:help

You should see the full list of available commands. If you see “unknown command,” the plugin isn’t registered — try restarting Claude Code.

Requirements

• Node.js 18+ — required for native fetch in hook scripts
• Claude Code — latest version with plugin support
• API key — a gck_* key from dashboard.prism.optra-ai.com
• Network access — the plugin calls a config endpoint on setup and sends telemetry to the ingest service (HTTPS)

How URL resolution works

When you run /prism:setup, the plugin calls a config endpoint with your API key. The server determines the correct environment from the key’s workspace configuration and returns all service URLs (ingest, gateway, dashboard). This is cached locally for 24 hours.

You never need to manually configure environment-specific URLs — the API key handles it.

Updating

The plugin checks for updates on session start. When a new version is available, you’ll see a notification:

[Prism] Updated to v0.3.0 (was v0.2.0)

To manually update from the marketplace:

/plugin marketplace add grumatic/optra-prism-plugin

Debugging

# Tail debug log
tail -f ~/.claude/plugins/data/prism-inline/debug.log

# Enable debug output in session
PRISM_DEBUG=1 claude

Uninstalling

/prism:uninstall

This removes:

• Plugin configuration (~/.prism/)
• OTEL telemetry settings from ~/.claude/settings.json

Restart Claude Code after uninstalling.