Kiro CLI has a first-party Chorus integration with tools, workflow skills, reviewer agents,
and hooks. Kiro is also a supported Chorus daemon backend.

Before you begin, install Kiro CLI v2 and create an agent key by following
[Prepare agent access](/guides/administrator-setup/).

## Install the integration

Install the Chorus integration with the `chorus` CLI:

```bash
npm install --global @chorus-aidlc/chorus
chorus agents add --agents kiro
```

Enter the Chorus URL and agent key when prompted. `chorus agents add` downloads the Kiro
integration files from your connected Chorus instance into `~/.kiro` (skills, reviewer
agents, and hooks) and merges the Chorus MCP server into `~/.kiro/settings/mcp.json`. Set
`KIRO_DIR` before running to install into a different Kiro directory. Restart Kiro after
installation.

## Enable remote start

Skip this section if you only use Chorus from an interactive Kiro session. Otherwise,
follow [Connect an agent runtime](/guides/operator-onboarding/) and select `kiro` as the
backend. Verify the connection in the foreground before using
[Operate the Chorus daemon](/guides/daemon-operations/) to keep it online.

## Verify the connection

Run `kiro-cli --agent chorus`, then ask Kiro to `check in to chorus`. Confirm that the
response shows the expected agent identity and permissions. Run `/chorus-idea` to confirm
that Chorus skills are available.

For daemon mode, open **Settings → Agents** in Chorus and confirm that the expected host
and working directory are online.

## Capabilities and limits

- The integration provides Chorus MCP tools, workflow skills, reviewer agents, and hooks.
- Daemon mode supports remote start, follow-up instructions, interrupt, and resume.
- Workspace configuration takes precedence over user-wide Kiro configuration.
- Remote work inherits the local user's access. Register only trusted working directories.

Use [Start work on a remote agent](/guides/remote-control/) and
[Interrupt and resume a session](/guides/session-recovery/) for shared operating procedures.

## Resume from the terminal

To take over a live conversation from your own terminal, copy its session ID from the chat
UI (**Copy session ID** in the transcript header) and run, from the conversation's working
directory:

```bash
kiro-cli chat --resume-id <sessionId>
```

The copied ID is the same ID Chorus passes to Kiro CLI when it resumes a session. See
[Interrupt and resume a session](/guides/session-recovery/#take-over-from-a-terminal) for
the full flow.

## Common issues

- **Kiro CLI is not found:** install Kiro CLI v2 and re-run `chorus agents add`.
- **Skills are missing:** check whether a workspace installation is overriding the
  user-wide installation, then restart Kiro.
- **Check-in is unauthorized:** re-run `chorus agents add` so `mcp.json` and the credential
  are refreshed; for daemon mode the daemon supplies the key per wake.
- **Daemon is offline:** run `chorus daemon status`, then see
  [Troubleshoot agent connections](/guides/troubleshooting/).