CLI - cliq

Reference

New to cliq? Do Get started first, then use this page as the flag bible.

cliq --help
cliq <command> --help
cliq <command> <subcommand> --help

Global: -V, --version · -h, --help

Auth & identity

Authenticate with CliqHub. Saves JWT to settings.

cliq login
cliq login https://internal.corp/registry

`cliq logout`

Clear CliqHub credentials from settings. No options.

`cliq auth token <name>`

Create a user (cliq_tok_…) or daemon (cliq_dt_…) API token.

Option	Description
`--type`	`user` (default) or `daemon`
`--realm`	Realm id (required when `--type daemon`)
`--registry`	Hub API URL override

cliq auth token ci-publish
cliq auth token daemon-enroll --type daemon --realm <realm_id>

`cliq auth daemon-key`

Print the realm-scoped daemon public key (PEM) for CLIQ_DISPATCH_PUBLIC_KEY.

Option	Description
`--realm`	Realm id (required)
`--rotate`	Rotate the key pair and print the new public key

export CLIQ_DISPATCH_PUBLIC_KEY="$(cliq auth daemon-key --realm <realm_id>)"

`cliq hub install <team_ref>`

Download and install a team from CliqHub.

Option	Description
`--force`	Reinstall even if already present

cliq hub install @cliq/feature-dev-js
cliq hub install @acme/my-pipeline --force

`cliq whoami`

Show the local daemon id and Hub user (when logged in). No options.

`cliq setup`

Interactive first-time setup. Creates ~/.cliqrc/ on first run.

Option	Description
`--reset`	Wipe `~/.cliqrc/` and start fresh
`--force`	Skip confirmations (with `--reset` or `--import`)
`--import <path>`	Import a `settings.json` (skips the wizard)
`--non-interactive`	Accept defaults (CI/scripting)

cliq setup
cliq setup --import ~/team-config/settings.json
cliq setup --reset

Workspace & runs

`cliq init [path]` / `cliq workspace init`

Option	Description
`--name <name>`	Workspace name (instance id prefix)

cliq workspace init
cliq workspace init /path/to/project --name my-api
cliq init

`cliq status` / `cliq workspace status`

Show registration, bound team, and last run info.

Option	Description
`--tree`	Show the run tree for the last run
`-w, --workspace <name-or-path>`	Target workspace

cliq workspace status
cliq workspace status --tree
cliq status

`cliq workspace list`

List registered workspaces.

`cliq assemble <ref>` / `cliq workspace assemble <ref>`

Bind a catalog team to a workspace (scope/slug or @scope/slug).

cliq assemble acme/feature-dev
cliq assemble @cliq/parser-builder

`cliq remove`

Deregister the current workspace from the daemon catalog.

Option	Description
`-y, --yes`	Confirm deregister

cliq remove --yes

`cliq clean`

Reset run history (keeps registration + team binding).

`cliq run`

Run the pipeline for the current workspace. Streams events via SSE.

Option	Description
`-i, --input <key=value>`	Input value (repeatable)
`--role <phase=text_or_path>`	Override role for a phase (repeatable)
`--no-stream`	Return without streaming events

cliq run
cliq run -i message="Hello World"
cliq run --role "analyze-pdf=roles/analyze-pdf.md"
cliq run --no-stream

`cliq logs [run_id]`

Show the persistent run log (default: latest run).

Option	Description
`-f, --follow`	Follow continuously (Ctrl+C to stop)
`--last <n>`	Summary of last N runs

cliq logs
cliq logs abc123-def456
cliq logs -f
cliq logs --last 5

Teams (local catalog)

Teams are scope/slug or @scope/slug in the daemon catalog.

`cliq team install <ref>`

Install a team manifest from a local directory.

Option	Description
`--dir <path>`	Directory containing `team.yml`

cliq team install cliq/parser-builder --dir ./examples/parser-builder

`cliq team uninstall <ref>`

Remove a team from the catalog.

`cliq team list [scope]`

List teams, optionally filtered by scope.

`cliq team info <ref>`

Show metadata and manifest.

`cliq team update <ref>`

Replace a team’s manifest from a local directory.

Option	Description
`--dir <path>`	Directory containing the updated `team.yml`

cliq team update cliq/parser-builder --dir ./examples/parser-builder

Builder

Requires a configured LLM provider. One of -f, -m, or --stdin for generate.

`cliq builder generate [path]`

Option	Description
`-f, --file <path>`	Instructions file
`-m, --message <text>`	Inline instructions
`--stdin`	Instructions from stdin
`--name <name>`	Override team name
`--dry-run`	Preview only
`--force`	Overwrite existing `team.yml`
`--provider <name>`	LLM provider override
`--model <model>`	Model override

cliq builder generate -m "TDD pipeline for a Python FastAPI project"
cliq builder generate -f spec.txt --name my-custom-team ./my-team

`cliq builder improve <team>`

Option	Description
`--role <name>`	Role to improve (required)
`--dir <path>`	Local team directory
`--instruction <text>`	Guidance
`--dry-run`	Preview only
`--provider <name>`	Provider override
`--model <model>`	Model override

`cliq builder gaps <team>`

Option	Description
`--provider <name>`	Provider override
`--model <model>`	Model override

`cliq builder capability <team>`

Regenerate A2A metadata.

Option	Description
`--dry-run`	Preview only
`--provider <name>`	Provider override
`--model <model>`	Model override

Instances

`cliq instance list`

List pipeline instances.

`cliq instance info <instance_id>`

Show detailed info for an instance.

`cliq instance stop <instance_id>`

Stop a running instance.

Docker

`cliq docker-build <team_ref>`

Build a self-contained Docker image for a team.

Option	Description
`-t, --tag <tag>`	Image tag
`--push`	Push after building
`--registry <url>`	Registry URL to push to

cliq docker-build @acme/my-pipeline
cliq docker-build @acme/my-pipeline -t my-image:latest --push

Settings & doctor

`cliq settings [key] [value]`

Option	Description
`--global`	Target `~/.cliqrc/settings.json`
`--project`	Target `.cliq/settings.json`
`--unset <key>`	Remove a key
`--add <key>`	Append to an array field
`--stdin`	Value from stdin
`--unmask`	Show secrets

cliq settings
cliq settings agents.git.github.base_branch develop
echo $TOKEN | cliq settings hub.token --stdin
cliq settings agents.git.github.pr_draft --unset

`cliq doctor [team_ref]`

Environment / agent checks.

cliq doctor
cliq doctor @cliq/feature-dev-js

Credentials → Auth
There is no top-level cliq scope — scopes live on Hub
Full narrative reference: Starlight CLI Reference

​Auth & identity

​cliq login [registry_url]

​cliq logout

​cliq auth token <name>

​cliq auth daemon-key

​cliq hub install <team_ref>

​cliq whoami

​cliq setup

​Workspace & runs

​cliq init [path] / cliq workspace init

​cliq status / cliq workspace status

​cliq workspace list

​cliq assemble <ref> / cliq workspace assemble <ref>

​cliq remove

​cliq clean

​cliq run

​cliq logs [run_id]

​Teams (local catalog)

​cliq team install <ref>

​cliq team uninstall <ref>

​cliq team list [scope]

​cliq team info <ref>

​cliq team update <ref>

​Builder

​cliq builder generate [path]

​cliq builder improve <team>

​cliq builder gaps <team>

​cliq builder capability <team>

​Instances

​cliq instance list

​cliq instance info <instance_id>

​cliq instance stop <instance_id>

​Docker

​cliq docker-build <team_ref>

​Settings & doctor

​cliq settings [key] [value]

​cliq doctor [team_ref]

​Related