> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiml-code-it.automat-it.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Runner CLI

> Commands of code-it-runner.

Run `code-it-runner` with no arguments to print the usage.

| Command | What it does |
| - | - |
| `login --api <url>` | Sign in with browser approval and store a runner token. If the LaunchAgent is installed, `--api` can be omitted |
| `aws-profile <slug> <profile>` | Set the AWS profile used for a project's deploys |
| `start [--api <url>] [--root <dir>]` | Hold the uplink open and run agents. The installed LaunchAgent runs this for you |
| `status` | Show runner version, LaunchAgent state, token state, `kiro-cli` path and version, log directory and known agents |
| `doctor` | Report why the laptop may be offline, from launchd state. macOS only. Non-zero exit when unhealthy |
| `repair` | Re-enable and reload the LaunchAgent and the watchdog |
| `logs [--follow]` | Print the runner logs |
| `uninstall` | Remove the LaunchAgent and the installed runner. Keeps workspaces and config |

`ensure-watchdog` also exists. The installer calls it to register the restart watchdog. You do not need to run it.

## Where the token is stored

In the macOS Keychain, or in `~/.config/code-it/runner.json` with mode 0600.

## Environment variables for the installer

| Variable | Purpose |
| - | - |
| `CODE_IT_DOWNLOAD_BASE` | Where `runner-manifest.json` is fetched from |
| `CODE_IT_API_URL` | The API URL used for sign-in and the LaunchAgent |
| `CODE_IT_HOME` | Overrides `~/.code-it` |

These are for manual runs. The copy served by the platform already has the right values.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.