production-master

Trigger, stream, and review autonomous production-incident investigations without leaving your editor.

Production Master is a thin client for the Production Master hosted service. You point it at an incident, it starts an investigation on the service, and the results stream back into your IDE in real time. When the investigation proposes an action that changes something, you approve or reject it — nothing runs without your sign-off.

The investigation itself runs entirely on the hosted service. This repository is the thin client: it handles device-code login, starts a run, streams live progress, renders the report, and relays your approve/reject decisions. No investigation logic, model provider SDKs, or credentials for the analysis live here.

Features

• IDE-native investigations — start and follow a run from Claude Code, Cursor, Codex, or OpenCode. No context switch to a separate dashboard.

• Live streaming — progress, findings, and the final report stream over Server-Sent Events (SSE) as the hosted service works.

• Human-gated actions — every proposed action that mutates a system is surfaced for explicit approval; you approve or reject before anything happens.

• Multi-IDE support — one thin client, registered through each editor's native extension mechanism (plugin, MCP config, or config file).

Related MCP server: Debugging MCP Server

Prerequisites

• Node.js 22 (pinned in .nvmrc)

• An account on the Production Master hosted service — the client authenticates to it via device-code login.

• One of the supported editors: Claude Code, Cursor, Codex, or OpenCode.

Quick Start

Across every editor the flow is the same: register the client → log in with a device code → start an investigation. Point the client at your service with PM_SERVICE_URL (default https://api.productionmaster.ai).

Build the client first (workspaces compile the host-neutral core and each adapter):

nvm use && npm ci && npm run build

Claude Code

Claude Code is wired end-to-end. Install the plugin (.claude-plugin/plugin.json + commands/, backed by packages/adapter-claude-code), then use the slash commands:

/plugin install production-master
/login
/investigate PROJ-1234

/connect <id>, /update <id> <tool> [jsonArgs], and /logout are also available. Each command execs the built thin-client binary; nothing about the investigation runs locally.

Cursor · Codex · OpenCode

Each of these editors registers the client as an MCP server that it spawns from the built binary. After npm run build, the config file in this repo points the editor at the client's mcp entry point:

Log in once with node packages/adapter-<editor>/dist/cli.js login, then start investigations from the editor's own agent — it calls the client's investigation tools over MCP. Point the client at your service with PM_SERVICE_URL (default https://api.productionmaster.ai); secrets are ${ENV} references only, never literals.

Full walkthrough: docs/user/quick-start.md.

Architecture

The client is a thin transport-and-render layer. All investigation logic lives on the hosted service; the client talks to it over HTTPS (control) and SSE (streaming).

flowchart LR
    subgraph IDE["Your IDE"]
        C["production-master<br/>thin client"]
    end
    S["Production Master<br/>hosted service"]

    C -- "device-code login (HTTPS)" --> S
    C -- "start / approve / reject (HTTPS)" --> S
    S -- "live progress + report (SSE)" --> C

The client owns four concerns: auth (device-code login + token storage), MCP transport (exposing thin-client commands to the editor), streaming (consuming SSE and rendering progress), and render adapters (per-IDE presentation). It owns none of the analysis.

Documentation

License

MIT — see LICENSE.