CLI Reference

After installing PhyAgentOS, the available top-level commands are:

paos onboard
paos agent
paos gateway
paos status
paos provider login <provider>

paos onboard

Creates or refreshes ~/.PhyAgentOS/config.json and synchronizes Agent workspace templates. The default Agent workspace is ~/.PhyAgentOS/workspace.

paos onboard

paos agent

Interactive mode:

paos agent

Single-turn mode:

paos agent -m "inspect the enabled runtime targets"

Custom config or workspace:

paos agent --config /path/to/config.json --workspace /path/to/workspace

Use --logs to show Runtime logs.

paos gateway

Long-running gateway with Channels, Cron, and Heartbeat:

paos gateway --port 18790

paos status

Check current configuration and runtime status.

paos status

paos provider login

Login with an OAuth provider:

paos provider login <provider>

See Quick Start and Configuration for details.