Skip to main content

Install

The installer supports macOS only. You need Node 20 or newer and kiro-cli on your PATH. Use the exact command shown on the Connect your laptop page:
The script is HTTPS-only, verifies the runner tarball against a published sha256 and refuses to install on a mismatch. It then:
  • installs into ~/.code-it/runner and puts a code-it-runner launcher in ~/.code-it/bin,
  • adds ~/.code-it/bin to your PATH in ~/.zprofile (and ~/.bash_profile if it exists),
  • opens a browser page to approve this laptop,
  • registers a LaunchAgent io.codeit.runner that starts at login and restarts on crash,
  • registers a second small agent, a watchdog, that runs every two minutes and re-registers the runner if launchd has dropped it.
Open a new terminal afterwards, or run source ~/.zprofile. If you do not use AWS in the agent, you are done. Otherwise choose the AWS profile per project:
The profile name and its credentials stay on your laptop.

Check it

Shows the runner version, whether the LaunchAgent is installed, whether a token is stored, the kiro-cli path and version, the log directory and the agents the runner knows.

When the laptop shows offline

1

Run the doctor

It reads launchd’s state and lists problems. It exits non-zero when the runner is not healthy.
2

Repair

Re-enables and reloads the LaunchAgent and the watchdog. This fixes the case where launchd marked the runner disabled or dropped it.
3

Read the logs

4

Sign in again if the token is rejected

Uninstall

Removes the LaunchAgent and ~/.code-it/runner. It keeps your ~/code-it workspaces and ~/.config/code-it so a reinstall does not force a new sign-in.

Common problems