> ## 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.

# The runner

> code-it-runner runs kiro-cli on your laptop over one outbound connection to the API.

`code-it-runner` is the small program that connects your laptop to Code-it. It holds one outbound WebSocket (the uplink) to the API. There is no inbound port and no remote machine.

When you start an agent, the API sends a launch message down the uplink. The runner then:

1. Clones the repo and the ticket branch with your `gh` login (plain `git clone` for non-GitHub remotes).
2. Writes the rendered `.kiro/` workspace.
3. Starts `kiro-cli` through ACP on the launch brief.
4. Reports heartbeats, interactions and credits back to the API.

## What stays on your laptop

* Your Kiro login. Credits are billed to your own Kiro plan.
* Your named AWS profile and its credentials. The runner exports `AWS_PROFILE` to child processes and checks the session with the `aws` CLI. It never reads AWS credentials in-process.
* The cloned workspace.

## Where things live

| Path | Contents |
| - | - |
| `~/.code-it/runner` | The installed runner |
| `~/.code-it/logs` | `runner.out.log`, `runner.err.log` |
| `~/.code-it/bin` | The `code-it-runner` launcher, added to your PATH |
| `~/.config/code-it` | Runner token and AWS profile settings. Kept across reinstalls |
| `~/code-it/<project>/<ticket>` | Agent workspaces |
| `~/Library/LaunchAgents/io.codeit.runner.plist` | Starts the runner at login |

## Updates

The runner updates itself. It downloads the new release over HTTPS, checks its sha256 against the digest the API published, swaps it in, and restarts through launchd. It waits while any agent is mid-turn.

Commands are in the [runner CLI reference](https://docs.aiml-code-it.automat-it.io/reference/runner-cli.md).


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