Terminal commands for operators

Use these commands outside Pi for setup, updates, doctor checks, benchmarks, capabilities, and MCP management.

Global setup

piagent-setup --mcp-preset core --subagents-preset safe

Full update

npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0
npm install -g --ignore-scripts @piagent/platform@X.Y.Z
piagent-install --stable --dry-run
piagent-install --stable

Pi package only

piagent-install --version vX.Y.Z --resolve-tag --dry-run
piagent-install --version vX.Y.Z --resolve-tag

Initialize a project

piagent-init /path/to/project

Doctor

piagent-doctor /path/to/project

Smoke benchmark

piagent-benchmark --dry-run
piagent-benchmark

Production benchmark

piagent-benchmark --production --dry-run
piagent-benchmark --production --surfaces piagent,codex-cli \
  --model openai-codex/gpt-5.6-sol --thinking xhigh

Compare codex-cli

piagent-benchmark --surfaces piagent,codex-cli \
  --model openai-codex/gpt-5.6-sol --thinking xhigh

Trusted run

piagent-auto --read-only -p "Scout payment mapping. Do not edit source."
piagent-auto --full-access -p "Run the trusted local benchmark suite."

Capabilities

piagent-capabilities catalog --check
piagent-capabilities doctor --profile .pi/piagent-profile.json

Verification

npm run verify
npm test
npm run typecheck