Pollaris CLI
CLI command reference
Pollaris CLI commands, JSON behavior, continuation states, and exit codes.
| Command | Purpose |
|---|
pollaris forms create | Generate or import a form; publish by default. |
pollaris forms list | List forms in the authorized workspace. |
pollaris forms get FORM_ID | Read form metadata and its current draft. |
pollaris forms validate --definition FILE | Validate a canonical form definition. |
pollaris forms save FORM_ID --definition FILE --expected-revision N | Replace exactly the inspected draft revision. |
pollaris forms publish FORM_ID --expected-revision N | Publish exactly the inspected draft revision. |
forms create requires exactly one of --prompt, --prompt-file, or --definition. Definition input also requires --title. Use - as a definition filename to read standard input.
| Command | Purpose |
|---|
pollaris auth login | Begin browser authorization before another command. |
pollaris auth status | Check the current profile. |
pollaris auth logout | Revoke and remove the current profile credential. |
pollaris operations resume OPERATION_ID | Continue the original request after authorization, timeout, or restart. |
pollaris jobs get JOB_ID | Read durable backend job state. |
pollaris jobs wait JOB_ID | Wait for a bounded period. |
pollaris jobs resume JOB_ID | Resume a recoverable job after renewed authorization. |
| Command | Purpose |
|---|
pollaris workspaces list | Show the workspace available to this grant. |
pollaris workspaces use WORKSPACE_ID | Confirm the current granted workspace. |
pollaris connections list | Show the current delegated connection. |
pollaris connections revoke CONNECTION_ID | Revoke the current connection when its ID matches. |
pollaris mcp connect | Authorize and optionally configure a local MCP host. |
pollaris mcp serve | Run the local stdio bridge. Normally launched by the agent host. |
pollaris mcp status | Check a named MCP profile. |
pollaris mcp disconnect | Revoke and remove a managed MCP connection. |
pollaris capabilities | Read server resource URLs, scopes, limits, and schema version. |
pollaris doctor | Check deployment and local credential-store access. |
| Option | Behavior |
|---|
--json | Emit one versioned JSON object on stdout. Logs and progress use stderr. |
--profile NAME | Use a named deployment, account, workspace, or connection context. |
--api-url URL | Choose a trusted Pollaris API origin for a new profile. |
--non-interactive | Never prompt or launch a browser. Agent commands already follow this behavior. |
--wait | Wait for authorization or job progress. |
--timeout SECONDS | Bound one wait from 0 to 300 seconds. |
--idempotency-key KEY | Supply an 8–100 character logical-operation key. Reuse only for the same input. |
| Exit | Meaning |
|---|
0 | Completed. |
10 | Authorization required; resume data is present. |
11 | Operation or job is still pending. |
12 | User declined authorization. |
13 | Authorization expired, was revoked, or lacks scope. |
20 | Generation or validation failed. |
21 | Revision or idempotency conflict. |
22 | Rate or quota limit. |
30 | Temporary network, provider, or server error. |
31 | Local arguments, configuration, installation, or credential storage failed. |
Agents should inspect the JSON status and error.code. A timeout or interrupted process does not mean a submitted backend job was cancelled.