Core

Doctor

Verify your setup

npx promptreports-cli doctor

10 diagnostic checks: Node.js, .env.local, services, API key, Claude Code sessions, git, Prisma, CLAUDE.md, skills.

Doctor is your pre-flight check. It verifies everything the other CLI commands depend on: Node version, presence of .env.local, how many providers are configured, whether PROMPTREPORTS_API_KEY is set, session files exist, Git is available, Prisma schema is present, CLAUDE.md exists, skills are installed. Each check is pass/fail with actionable remediation.

Prerequisites

None — doctor is meant to run on brand-new machines to show what's missing

Flags & Options

Flag	Description	Default
--json	JSON output	—
--quiet	Suppress output	—

Examples

Run all checks

npx promptreports-cli doctor

Default — 10 checks with pass/fail.

CI-friendly

npx promptreports-cli doctor --json

Exits non-zero on failure. Use in GitHub Actions.

Output

List of checks with ✓/✗ icon, name, and detail. Overall pass count at bottom.

  ✓ Node.js >= 18              v22.20.0
  ✓ .env.local exists          /c/Projects/Home-1/.env.local
  ✗ Services configured        0/8 services (no API keys detected)
  ✓ PROMPTREPORTS_API_KEY      Set (pr_live_****)
  ✓ Claude Code sessions       12 sessions in ~/.claude/projects/
  ✓ Git available              git version 2.42.0
  ✓ Prisma schema              prisma/schema.prisma (42 models)
  ✓ CLAUDE.md                  Found (1,847 words)
  ✓ Skills installed           8 skills in .claude/skills/
  ✓ MCP config                 .mcp.json present

  9/10 checks passed

What it reads and writes

Reads

.env.local
CLAUDE.md
prisma/schema.prisma
.claude/skills/
~/.claude/projects/
.mcp.json

Writes

Nothing (read-only)

Free vs Pro usage

Free tier

Verify your install worked
Share output in Discord/Slack when asking for help
Add to CI to catch missing configs before deploy

Pro tier

Upgrade

Run doctor on every team member's machine — track setup drift
Auto-remediate common issues (missing .env, missing schema)
Nightly cron on all team machines → dashboard heatmap

Pro tips

--json output is deterministic; great for CI
Run doctor first whenever a CLI command fails unexpectedly

Free to try

Install the whole toolkit.

One command unlocks all 23 tools.

Start Free Back to all tools