Global flags
Flags the CLI accepts on any command, before or after the command name.
Output and help
| Flag | Description |
|---|---|
--agent-help | Print the long agent handbook. |
--format | Output format: json or text (default: auto-detect TTY). |
--global-help | Legacy alias for --agent-help. |
--help | Show help. |
--json | Force JSON output. |
--no-config | Ignore the nearest .perpetual.toml. |
--profile | Named profile to use for auth (or PERPETUAL_PROFILE env var). |
--robot-status | Print machine-readable CLI and auth status. |
--text | Force text output. |
--version | Show CLI version. |
Also accepted: -h, -v.
Sign-in flags
These choose who a command signs in as. Each command's page says whether it takes them.
| Flag | Description |
|---|---|
--email | User email (or PERPETUAL_EMAIL env var). |
--org-id | Organization ID for this command; beats PERPETUAL_ORG_ID, .perpetual.toml and the stored org. |
--password | User password (DEPRECATED: visible in ps/history. Use --password-file or --password-stdin). |
--password-file | Read password from a file (first line). |
--password-stdin | Read password from stdin. |
Related
Perpetual CLI 0.5.0