# CLI command reference (/docs/cli/commands)



## Form commands [#form-commands]

| 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.

## Authorization and continuation [#authorization-and-continuation]

| 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.                   |

## Workspaces and connections [#workspaces-and-connections]

| 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.              |

## Global options [#global-options]

| 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. |

## Status and exit codes [#status-and-exit-codes]

| 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.