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

# VS Code extension

> Start agents and reach their chat from VS Code, Cursor, Windsurf or Kiro.

The `code-it` extension is a shortcut for starting an agent and getting to its chat. The agent still runs on your laptop through the runner and streams to the web app.

## Features

* **New agent.** Pick a project and an Asana task or a git branch. Start it from the `+` in the Agents view title or from `Code-it: New agent`.
* **Connect this laptop.** Opens the web app's connect page. Also reachable from the status bar.
* **Runner status.** A status-bar item reads **Runner connected** or **Runner offline**.
* **Open chat.** Opens the agent's chat in the web app.
* **Agents list.** Each row shows branch, status and links to details, chat, endpoints and pull requests.

## Install

The extension is built from the repo. It is not published to a marketplace.

```bash theme={null}
pnpm --filter code-it package
code --install-extension apps/vscode/code-it.vsix
```

Use `cursor`, `windsurf` or `kiro` in place of `code` for those editors. Kiro may need **Shell Command: Install 'kiro' command in PATH** first, or install the `.vsix` from the Extensions view.

## Configure

Set the deployment URL in `settings.json`:

```jsonc theme={null}
{
  "code-it.host": "https://app.aiml-code-it.automat-it.io",
  "code-it.apiUrl": "https://api.aiml-code-it.automat-it.io"
}
```

`code-it.host` is the URL you open in a browser. Set `code-it.apiUrl` when the API is on a separate origin, which it is on this deployment. Then run **Code-it: Sign in**. The token is stored in the editor's secret storage.


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