> ## Documentation Index
> Fetch the complete documentation index at: https://alike.help/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported agents

> The 13 coding agents that the installer connects, and what each one gets.

The installer supports 13 coding agents on macOS and Linux. Each agent gets one or both of these connections:

* **Hooks**: small commands that the agent runs at points in a session, for example when a session starts or when you send a prompt. Hooks let Alike record the session and give the agent context without a request.
* **MCP**: an MCP server entry named `alike`. It lets the agent call Alike's tools when it needs them. See [MCP tools](https://alike.help/reference/mcp-tools.md).

An agent with hooks and MCP gets the full experience. An agent with MCP only can use Alike's tools, but Alike cannot add context automatically.

## Agents and connections

| Agent | ID | Hooks | MCP | Notes |
| - | - | - | - | - |
| Claude Code | `claude` | Yes | Yes | |
| Codex CLI | `codex` | Yes | Yes | Approve the one-time **Hooks need review** prompt on the next run |
| Copilot CLI | `copilot` | Yes | Yes | |
| Factory droid | `factory` | Yes | Yes | |
| Antigravity | `antigravity` | Yes (early support) | Yes | |
| JetBrains Junie | `jetbrains` | Session start and end only (early support) | Yes | |
| Cursor | `cursor` | Yes (early support) | Yes (early support) | |
| Cline | `cline` | Yes (early support) | Yes | Hooks are on by default. If they never run, check **Settings → Features → Hooks** |
| VS Code | `vscode` | Yes (early support), through Claude Code's hook file | Yes | The installer turns on `chat.hooks.enabled` |
| Devin CLI | `devin` | Yes (early support), through Claude Code's hook file | No | |
| Windsurf | `windsurf` | Activity only, no context (early support) | Yes | |
| Zed | `zed` | No | Yes | |
| Continue | `continue` | No | Yes | |

"Early support" means that the settings location is not yet confirmed on all versions of the agent. The installer prints `(unverified path — see doctor)` for these agents. Run `npx @alikeai/setup --doctor` to see if the hooks run. See [Check your setup](https://alike.help/help/doctor.md).

> [!NOTE]
>
> Windsurf, Zed, and Continue never get context from hooks. They get Alike's context only when they call an MCP tool. All the other agents also get context automatically, at the points that each agent supports. See [What your agent sees](https://alike.help/use/in-your-agent.md#when-alike-adds-context).

## How the installer finds each agent

The installer looks for the agent's settings folder. If the folder does not exist, the agent shows as "not found". Run the agent once to create its folder, then run the installer again.

| Agent | The installer looks for |
| - | - |
| Claude Code | `~/.claude`, or `$CLAUDE_CONFIG_DIR` |
| Codex CLI | `~/.codex`, or `$CODEX_HOME` |
| Copilot CLI | `~/.copilot` |
| Factory droid | `~/.factory` |
| Devin CLI | `~/.devin`, or `devin` on your `PATH` |
| Cline | Cline's folder in VS Code's global storage |
| VS Code | `~/.vscode`, or VS Code's user settings folder |
| Cursor | `~/.cursor` |
| Windsurf | `~/.codeium/windsurf` |
| Zed | `~/.config/zed` |
| Continue | `~/.continue` |
| JetBrains Junie | `~/.junie` |
| Antigravity | `~/.gemini` |

`CLAUDE_CONFIG_DIR` and `CODEX_HOME` must be absolute paths. The installer ignores relative paths. It saves the folders that it used, so later runs use the same folders.

> [!NOTE]
>
> Gemini CLI also uses `~/.gemini`. On a machine with Gemini CLI, the installer shows Antigravity as found and writes Antigravity's settings in `~/.gemini/config/`.

## Files the installer changes

VS Code's user folder is `~/Library/Application Support/Code/User` on macOS and `~/.config/Code/User` on Linux. It is written as `<VS Code>` below.

| Agent | Hooks file | MCP file |
| - | - | - |
| Claude Code | `~/.claude/settings.json` | `~/.claude.json` |
| Codex CLI | `~/.codex/hooks.json` | `~/.codex/config.toml` |
| Copilot CLI | `~/.copilot/hooks/alike-hooks.json` | `~/.copilot/mcp-config.json` |
| Factory droid | `~/.factory/hooks.json` | `~/.factory/mcp.json` |
| Devin CLI | `~/.claude/settings.json` | None |
| Cline | Scripts in `~/Documents/Cline/Hooks/` | `cline_mcp_settings.json` in Cline's global storage |
| VS Code | `~/.claude/settings.json`, plus `chat.hooks.enabled` in `<VS Code>/settings.json` | `<VS Code>/mcp.json` |
| Cursor | `~/.cursor/hooks.json` | `~/.cursor/mcp.json` |
| Windsurf | `~/.codeium/windsurf/hooks.json` | `~/.codeium/windsurf/mcp_config.json` |
| Zed | None | `~/.config/zed/settings.json` |
| Continue | None | `~/.continue/config.yaml` |
| JetBrains Junie | `~/.junie/config.json` | `~/.junie/mcp/mcp.json` |
| Antigravity | `~/.gemini/config/hooks.json` | `~/.gemini/config/mcp_config.json` |

If you use `CLAUDE_CONFIG_DIR` or `CODEX_HOME`, the files are in those folders instead.

### How to spot Alike's entries

* Hook entries run a command that contains `.alike/runtime/hook.mjs`.
* The MCP server entry is named `alike`. Its URL ends in `/mcp`.
* In TOML and YAML files, Alike's lines are between `>>> alike >>>` and `<<< alike <<<` markers. Codex's `config.toml` also has a region between `>>> alike-root >>>` and `<<< alike-root <<<`.

> [!WARNING]
>
> Hooks run `node` from the `PATH` that the agent sees. Desktop apps that you open from the Dock or a launcher can have a shorter `PATH` than your terminal. This is common when you install Node with a version manager such as `nvm`. If the doctor says that the hooks never ran, see [Hooks never run](https://alike.help/help/troubleshooting.md#hooks-never-run).

## If you already use the Alike plugin for Claude Code

If the Alike plugin for Claude Code is installed, the installer does not change Claude Code's files. It prints `Alike plugin already installed — skipping file wiring (no double-hooks)`. This prevents two sets of hooks in one agent. It still adds the 2-line note to `CLAUDE.md`. To skip the note, add `--no-agent-guidance`.


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