The headless CLI

Unstoppable Code ships a headless CLI, unstoppable-code, that drives the app's core actions — workspaces, worktrees, and pipelines — from the terminal, with no desktop window. It's built for automation and CI. This article covers installing it, the command groups, and running a pipeline.

Install it

The CLI is bundled with the desktop app. Turn on shell integration in Settings → Unstoppable to add it to your PATH as unstoppable-code. Confirm it's available:

unstoppable-code --version

The CLI version tracks the app version. Run unstoppable-code --help, or <command> --help on any command, for the full, current reference.

What it can do

The CLI has two command groups:

• workspace — manage workspaces and their worktrees.
• pipelines — register, inspect, and run pipelines.

workspace

• workspace list · workspace get <workspace-id>
• workspace create — import <repo-path> (a local git repo), remote <url> <dir> (clone and import), or new
• workspace worktrees <workspace-id> — list, create (--branch, --base-branch), get, get-path, delete, and pipeline-executions

pipelines

• pipelines list · get <id> · get-path <id> · validate · register · update · delete
• pipelines executions — run, resume, summary, list, cancel

Run a pipeline headlessly

The main automation use is running a pipeline from the terminal:

unstoppable-code pipelines executions run <pipeline-input> [options]

<pipeline-input> is a path to a pipeline file, or inline pipeline text with --inline. Useful options:

• --input KEY=VALUE — pass a pipeline input (repeatable).
• --env KEY=VALUE — set an environment variable for the run (repeatable).
• --repo-path <dir> — the repository root to act on.
• --stream — stream real-time step output and status (good for CI logs).
• --silent — print only the execution header and the final status line.
• --fast-mode / --no-fast-mode — run supported providers in fast or standard mode.

A typical CI invocation:

unstoppable-code pipelines executions run ./review.pipeline.yaml \
  --repo-path . \
  --input pr=123 \
  --stream

Afterward, inspect or manage the run with pipelines executions summary <execution-id>, list, resume, or cancel.

When to use it

• CI/CD — kick off a review or implementation pipeline from a CI job and stream the result back into your build logs.
• Scripting — create worktrees, run pipelines, and read results without opening the app.
• Headless machines — drive Unstoppable Code where there's no desktop GUI.

Next steps

• Pipelines: overview — what pipelines are and how they run.
• Reading a pipeline execution — the in-app view of a run you can also drive from the CLI.
• Automations & scheduling — schedule work inside the app, as an alternative to external automation.