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

# Plugin

> Install Helix into the coding agent you already use — Claude Code or Codex — through the mutagent CLI.

The **Plugin** adds Helix to a coding agent you already have. It installs through the
[`mutagent` CLI](/cli/overview), which pulls the Helix skills into your editor.

<Info>
  **Before you start:** a working **Claude Code** or **Codex**, and Node (for the CLI). The Plugin
  upgrades a coding agent you already have — it doesn't give you one.
</Info>

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    npm install -g @mutagent/cli
    ```

    See [CLI installation](/cli/installation) for pnpm / bun and details.
  </Step>

  <Step title="Sign in">
    ```bash theme={null}
    mutagent login
    ```

    Opens a browser to authorize the CLI. Set `MUTAGENT_API_KEY` to skip the browser in CI.
  </Step>

  <Step title="Install Helix">
    ```bash theme={null}
    mutagent install helix
    ```

    Installs the Helix orchestrator and the lifecycle skills into your coding agent's `.claude/`, and
    links `CLAUDE.md` / `AGENTS.md` so the agent boots the orchestrator. Add other skills the same way —
    for example `mutagent install diagnostics`.
  </Step>

  <Step title="Open your coding agent">
    Helix runs **inside** the coding agent you installed it into — **Claude Code** or **Codex**. Open
    it in your project directory. (Helix isn't a shell command; the next step is typed into the
    agent, not your terminal.)
  </Step>

  <Step title="Boot the orchestrator">
    In the agent, invoke the Helix skill:

    ```
    /mutagent-helix
    ```

    Typing `*mutagent` works too. From there you drive Helix in plain English.

    <Note>
      Nothing happened? Boot-on-load is a request to the host agent, not a guarantee. Type
      `boot the orchestrator` to force it.
    </Note>
  </Step>
</Steps>

## Update

Re-run `mutagent install helix` to refresh the orchestrator and skills.

## Remove it

Delete the skill directories the install wrote under `.claude/`, then remove the Helix section from
your `CLAUDE.md` / `AGENTS.md`.

<Card title="Next: your first loop" icon="arrow-right" href="/helix/install/first-loop">
  Run a spec → build → evaluate pass end to end.
</Card>