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.84.1
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-luna --thinking medium

Compare codex-cli

piagent-benchmark --surfaces piagent,codex-cli \
  --model openai-codex/gpt-5.6-luna --thinking medium

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

Session Hub

piagent dashboard
piagent-webui --no-open

Aliases: piagent-dashboard, piagent-webui and piagent-explain also work as standalone binaries.

Explain a decision

piagent explain 'cat .env*'
piagent explain --scope

Usage and tokens

piagent-usage .
piagent-usage --history . --days 7

Models and routing

piagent-models
piagent-model-scope
piagent-route

Subagents and migration

piagent-subagents --preset safe
piagent-migrate . --apply
piagent-import-instructions

Verification

npm run verify
npm test
npm run typecheck