Skip to main content
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

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.