Poliage

CLI Commands

Complete reference for all Poliage CLI commands and options.

Global Options

Available on all commands:

OptionDescription
--help, -hDisplay help for command
--version, -VOutput version number
--config, -cPath to config file (default: docsync.config.json)
--verboseEnable verbose output
--quietSuppress all output except errors

Setup & Configuration

poliage setup

Unified setup: authenticates, initializes config, and launches Studio.

poliage setup

poliage init

Initialize a new Poliage project.

poliage init [options]
OptionDescription
--force, -fOverwrite existing config

poliage auth

Authenticate with the Poliage Platform.

poliage auth

Recording

poliage chrome

Launch Chrome in debug mode.

poliage chrome [options]
OptionDescription
--portDebug port (default: 9222)
--user-data-dirChrome profile directory

poliage record

Start recording a new scenario.

poliage record <name>

Execution

poliage run

Run recorded scenarios.

poliage run [options]
OptionDescription
--scenarios, -sComma-separated scenario names
--all-variantsRun all variant combinations
--variantSpecific variant (e.g., theme:dark)
--headlessRun in headless mode
--concurrencyParallel browser instances

poliage studio / poliage ui

Launch the Studio interface.

poliage studio
Visual review queue in the dashboard
The Studio local development interface

Publishing

poliage publish

Upload assets to storage.

poliage publish [options]
OptionDescription
--dry-runPreview without uploading
--message, -mCommit message
--force, -fSkip confirmation

poliage pull

Download asset manifest.

poliage pull [options]
OptionDescription
--formatOutput format: json, csv, typescript

CI/CD

poliage ci

Generate CI workflow files.

poliage ci

Supports GitHub Actions, GitLab CI, and CircleCI.

Environment Variables

VariableDescription
POLIAGE_API_KEYAPI authentication token
POLIAGE_CONFIGPath to config file
POLIAGE_HEADLESSForce headless mode (true/false)

Exit Codes

CodeDescription
0Success
1General error
2Configuration error