CLI command reference

Every manage-runners 1.0.1 command with its scopes, safety properties and help text.

This reference is generated from manage-runners itself. Each page lists the command's required token scopes, whether it changes state or creates paid resources, which confirmation it needs, and its full help text. The agent guideexplains how to read these properties.

Commands

general

Command	Summary
`manage-runners commands`	List CLI commands
`manage-runners help`	Show command help
`manage-runners version`	Show CLI version metadata; --check compares it with the latest release
`manage-runners self-update`	Replace this binary with the latest release, or --version, after verifying its SHA-256
`manage-runners completion`	Generate shell completion scripts
`manage-runners setup`	Run the human setup wizard
`manage-runners doctor`	Run read-only diagnostics

config

Command	Summary
`manage-runners config show`	Show effective non-secret configuration
`manage-runners config profiles`	List configured API profiles
`manage-runners config set-api`	Store an API origin after HTTPS validation; the default profile otherwise uses https://api.managerunners.com

setup

Command	Summary
`manage-runners setup skill`	Install or manage the embedded agent skill

auth

Command	Summary
`manage-runners auth login`	Store a PAT from stdin or a named environment variable
`manage-runners auth status`	Show authentication status without printing the token
`manage-runners auth logout`	Remove the local credential; optionally revoke the current PAT
`manage-runners auth profiles`	List local profiles without credentials
`manage-runners auth use`	Select the default profile

runner

Command	Summary
`manage-runners runner list`	List owned runners
`manage-runners runner get`	Get one runner by exact ID or unique name
`manage-runners runner watch`	Poll a runner until a target or terminal state
`manage-runners runner metrics`	Show resource monitoring metrics for one or all monitored runners
`manage-runners runner ssh-keys`	List SSH keys available through the runner provider credential
`manage-runners runner create`	Create one runner; may create paid Hetzner resources
`manage-runners runner update`	Update one runner; product, GitLab host, runner token, concurrency, executor, SSH key or monitoring changes recreate an active runner's VM
`manage-runners runner pause`	Pause a runner and delete its active VM
`manage-runners runner resume`	Resume a paused runner; may create paid Hetzner resources
`manage-runners runner duplicate`	Duplicate a runner; may create paid Hetzner resources
`manage-runners runner delete`	Delete an active or paused runner
`manage-runners runner forget`	Remove only an UNKNOWN dashboard record
`manage-runners runner wait`	Wait for a runner target state after a mutation

schedule

Command	Summary
`manage-runners schedule get`	Read a runner schedule
`manage-runners schedule set`	Create or replace a runner schedule
`manage-runners schedule enable`	Enable an existing schedule
`manage-runners schedule disable`	Disable a schedule without deleting it
`manage-runners schedule delete`	Permanently delete a schedule

product

Command	Summary
`manage-runners product list`	List GitLab runner products
`manage-runners product get`	Get one product by exact ID
`manage-runners product locations`	Show bookable datacenters and prices for a product

provider

Command	Summary
`manage-runners provider hetzner ssh-keys`	Validate a Hetzner token and list SSH keys

profile

Command	Summary
`manage-runners profile show`	Show the current non-sensitive user profile

subscription

Command	Summary
`manage-runners subscription show`	Show the current subscription and schedule entitlement
`manage-runners subscription plans`	List available subscription plans

org

Command	Summary
`manage-runners org list`	List your organizations with role and default marker
`manage-runners org use`	Store the organization for the profile's organization-scoped commands, or clear it

Global flags

These flags work with every command.

      --agent                     agent mode: JSON and non-interactive
      --api-url string            API origin; must match the selected profile
      --credential-store string   credential store: keyring|file, also via $MANAGE_RUNNERS_CREDENTIAL_STORE; file keeps only a scoped, expiring PAT in a 0600 file, never your password or 2FA secret (default "keyring")
      --json                      emit JSON
      --no-color                  disable color output
      --non-interactive           disable prompts
      --org string                organization id or name for runner, schedule, subscription and provider commands; overrides the profile's organization
      --output string             output format: human|json|jsonl (default "human")
      --profile string            configured API profile
      --request-id string         request ID sent to the API
      --timeout duration          maximum command duration (for example 30s)
      --token-env string          named PAT environment variable for this invocation; overrides $MANAGE_RUNNERS_TOKEN; nothing is stored