Skip to main content

​
Global flags

  • --json
  • --plain
  • -q, --quiet
  • -v, --verbose
  • --no-color
  • --no-input
  • --timeout <ms>
  • --config <path>
  • --profile <name>
  • -n, --dry-run

​
Core commands

​
Session

psagent session start [--profile <name>]
psagent session status

​
Documents

psagent doc open <input>
psagent doc manifest [--doc <ref>]

​
Layers

psagent layer list [--match <regex>] [--doc <ref>]

​
Operations

psagent op apply -f <ops.json> [--doc <ref>] [--checkpoint] [--dry-run]

​
Rendering

psagent render --format png|jpg --out <path> [--doc <ref>]

​
Checkpoints

psagent checkpoint list [--doc <ref>]
psagent checkpoint restore <id> [--doc <ref>]

​
Events and diagnostics

psagent events tail [--count <n>]
psagent doctor
psagent capabilities

​
Bridge utilities

psagent bridge daemon [--port 43120]
psagent bridge status
psagent bridge mock [--port 43120]

​
MCP server

psagent mcp-serve

​
Exit behavior

  • Health failures in doctor set process exit code 4.
  • Session start fails if adapter health is not OK.
  • Schema validation errors in op apply are returned as command failures.