# CLI command reference

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

Source: https://managerunners.com/docs/cli/reference/

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 guide](https://managerunners.com/docs/cli/agents/) explains how to read these properties.

## Commands

### general

| Command | Summary |
| --- | --- |
| [`manage-runners commands`](https://managerunners.com/docs/cli/reference/commands/) | List CLI commands |
| [`manage-runners help`](https://managerunners.com/docs/cli/reference/help/) | Show command help |
| [`manage-runners version`](https://managerunners.com/docs/cli/reference/version/) | Show CLI version metadata; --check compares it with the latest release |
| [`manage-runners self-update`](https://managerunners.com/docs/cli/reference/self-update/) | Replace this binary with the latest release, or --version, after verifying its SHA-256 |
| [`manage-runners completion`](https://managerunners.com/docs/cli/reference/completion/) | Generate shell completion scripts |
| [`manage-runners setup`](https://managerunners.com/docs/cli/reference/setup/) | Run the human setup wizard |
| [`manage-runners doctor`](https://managerunners.com/docs/cli/reference/doctor/) | Run read-only diagnostics |

### config

| Command | Summary |
| --- | --- |
| [`manage-runners config show`](https://managerunners.com/docs/cli/reference/config-show/) | Show effective non-secret configuration |
| [`manage-runners config profiles`](https://managerunners.com/docs/cli/reference/config-profiles/) | List configured API profiles |
| [`manage-runners config set-api`](https://managerunners.com/docs/cli/reference/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`](https://managerunners.com/docs/cli/reference/setup-skill/) | Install or manage the embedded agent skill |

### auth

| Command | Summary |
| --- | --- |
| [`manage-runners auth login`](https://managerunners.com/docs/cli/reference/auth-login/) | Store a PAT from stdin or a named environment variable |
| [`manage-runners auth status`](https://managerunners.com/docs/cli/reference/auth-status/) | Show authentication status without printing the token |
| [`manage-runners auth logout`](https://managerunners.com/docs/cli/reference/auth-logout/) | Remove the local credential; optionally revoke the current PAT |
| [`manage-runners auth profiles`](https://managerunners.com/docs/cli/reference/auth-profiles/) | List local profiles without credentials |
| [`manage-runners auth use`](https://managerunners.com/docs/cli/reference/auth-use/) | Select the default profile |

### runner

| Command | Summary |
| --- | --- |
| [`manage-runners runner list`](https://managerunners.com/docs/cli/reference/runner-list/) | List owned runners |
| [`manage-runners runner get`](https://managerunners.com/docs/cli/reference/runner-get/) | Get one runner by exact ID or unique name |
| [`manage-runners runner watch`](https://managerunners.com/docs/cli/reference/runner-watch/) | Poll a runner until a target or terminal state |
| [`manage-runners runner metrics`](https://managerunners.com/docs/cli/reference/runner-metrics/) | Show resource monitoring metrics for one or all monitored runners |
| [`manage-runners runner ssh-keys`](https://managerunners.com/docs/cli/reference/runner-ssh-keys/) | List SSH keys available through the runner provider credential |
| [`manage-runners runner create`](https://managerunners.com/docs/cli/reference/runner-create/) | Create one runner; may create paid Hetzner resources |
| [`manage-runners runner update`](https://managerunners.com/docs/cli/reference/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`](https://managerunners.com/docs/cli/reference/runner-pause/) | Pause a runner and delete its active VM |
| [`manage-runners runner resume`](https://managerunners.com/docs/cli/reference/runner-resume/) | Resume a paused runner; may create paid Hetzner resources |
| [`manage-runners runner duplicate`](https://managerunners.com/docs/cli/reference/runner-duplicate/) | Duplicate a runner; may create paid Hetzner resources |
| [`manage-runners runner delete`](https://managerunners.com/docs/cli/reference/runner-delete/) | Delete an active or paused runner |
| [`manage-runners runner forget`](https://managerunners.com/docs/cli/reference/runner-forget/) | Remove only an UNKNOWN dashboard record |
| [`manage-runners runner wait`](https://managerunners.com/docs/cli/reference/runner-wait/) | Wait for a runner target state after a mutation |

### schedule

| Command | Summary |
| --- | --- |
| [`manage-runners schedule get`](https://managerunners.com/docs/cli/reference/schedule-get/) | Read a runner schedule |
| [`manage-runners schedule set`](https://managerunners.com/docs/cli/reference/schedule-set/) | Create or replace a runner schedule |
| [`manage-runners schedule enable`](https://managerunners.com/docs/cli/reference/schedule-enable/) | Enable an existing schedule |
| [`manage-runners schedule disable`](https://managerunners.com/docs/cli/reference/schedule-disable/) | Disable a schedule without deleting it |
| [`manage-runners schedule delete`](https://managerunners.com/docs/cli/reference/schedule-delete/) | Permanently delete a schedule |

### product

| Command | Summary |
| --- | --- |
| [`manage-runners product list`](https://managerunners.com/docs/cli/reference/product-list/) | List GitLab runner products |
| [`manage-runners product get`](https://managerunners.com/docs/cli/reference/product-get/) | Get one product by exact ID |
| [`manage-runners product locations`](https://managerunners.com/docs/cli/reference/product-locations/) | Show bookable datacenters and prices for a product |

### provider

| Command | Summary |
| --- | --- |
| [`manage-runners provider hetzner ssh-keys`](https://managerunners.com/docs/cli/reference/provider-hetzner-ssh-keys/) | Validate a Hetzner token and list SSH keys |

### profile

| Command | Summary |
| --- | --- |
| [`manage-runners profile show`](https://managerunners.com/docs/cli/reference/profile-show/) | Show the current non-sensitive user profile |

### subscription

| Command | Summary |
| --- | --- |
| [`manage-runners subscription show`](https://managerunners.com/docs/cli/reference/subscription-show/) | Show the current subscription and schedule entitlement |
| [`manage-runners subscription plans`](https://managerunners.com/docs/cli/reference/subscription-plans/) | List available subscription plans |

### org

| Command | Summary |
| --- | --- |
| [`manage-runners org list`](https://managerunners.com/docs/cli/reference/org-list/) | List your organizations with role and default marker |
| [`manage-runners org use`](https://managerunners.com/docs/cli/reference/org-use/) | Store the organization for the profile's organization-scoped commands, or clear it |

## Global flags

These flags work with every command.

```text
      --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
```