Install
The installer supports macOS only. You need Node 20 or newer andkiro-cli on your PATH. Use the exact command shown on the Connect your laptop page:
- installs into
~/.code-it/runnerand puts acode-it-runnerlauncher in~/.code-it/bin, - adds
~/.code-it/binto your PATH in~/.zprofile(and~/.bash_profileif it exists), - opens a browser page to approve this laptop,
- registers a LaunchAgent
io.codeit.runnerthat 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.
source ~/.zprofile.
If you do not use AWS in the agent, you are done. Otherwise choose the AWS profile per project:
Check it
kiro-cli path and version, the log directory and the agents the runner knows.
When the laptop shows offline
1
Run the doctor
2
Repair
3
Read the logs
4
Sign in again if the token is rejected
Uninstall
~/.code-it/runner. It keeps your ~/code-it workspaces and ~/.config/code-it so a reinstall does not force a new sign-in.