Pollaris CLI

Create and publish Pollaris forms from terminal-capable agents. The CLI starts a browser authorization flow when needed, preserves the original operation, and resumes it after the user grants access. It returns an authorization URL; it does not open a browser automatically.

Install the published package:

uv tool install pollaris-cli

Read the CLI documentation.

For the optional local MCP bridge, include its dependencies:

uv tool install 'pollaris-cli[mcp]'

Connect to Pollaris:

export POLLARIS_API_URL=https://api.pollaris.cc
pollaris capabilities --json

Create a form:

pollaris forms create \
  --prompt "Create a short library feedback form" \
  --publish \
  --wait \
  --json

When the command returns requires_authorization, open authorization.url and run the returned next_action.command. The finished result contains form.public_url.

Creation publishes by default. Use --draft-only to create an editable draft. --wait polls for completion up to --timeout seconds (default: 45); a pending job can be checked with pollaris jobs get JOB_ID --json or pollaris jobs wait JOB_ID --json.

To update or publish an existing form, inspect it first with pollaris forms get FORM_ID --json, then pass its current draft_revision as --expected-revision to forms save or forms publish. Saving also requires --definition path/to/definition.json.

Use pollaris --help and each command's --help for options. Credentials use an OS keychain, or encrypted file storage configured by POLLARIS_CLI_SECRET_KEY (a Fernet key) on headless hosts. Local state defaults to ~/.config/pollaris; POLLARIS_CLI_HOME overrides it and --profile selects a separate profile.

See installation, creating forms, and agent connections.