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

# Integrations

> How Helix reads your traces, writes approved fixes, and connects to GitHub, Slack and the cloud platforms around your agents.

Helix, Mutagent's coding agent that evaluates and fixes AI agents ([What is Helix](/helix/what-is-helix)),
connects to the tools around your agent in four ways: it **reads traces** from wherever your
agent runs, it **writes approved fixes** back to your agent's source, it takes requests through
**channels** like GitHub and Slack, and it works with agents that **run in the cloud**.

<Note>
  Helix on your machine **reads** traces where they are; it does not store a copy. A trace source
  you connect to your Mutagent workspace (`mutagent integrations sources add`) is different: there,
  Mutagent pulls the traces into your workspace.
</Note>

<CardGroup cols={2}>
  <Card title="Trace sources" icon="radar" href="/integrations/sources/local">
    Where your agent's runs come from: local transcripts, JSONL files, Langfuse, or OpenTelemetry
    (OTLP/JSON) span files. Dash0: Coming soon.
  </Card>

  <Card title="Apply targets" icon="pen-to-square" href="/integrations/targets/harness">
    Where approved fixes land: markdown agents or agent code, as a GitHub pull request.
  </Card>

  <Card title="GitHub and Slack" icon="https://mintcdn.com/architech/lNudYrm3oSHgdKIT/icons/github.svg?fit=max&auto=format&n=lNudYrm3oSHgdKIT&q=85&s=8820ff86edc474b6a81bb78e3970cdf0" href="/integrations/github" width="24" height="24" data-path="icons/github.svg">
    Pull requests for fixes. Start runs from issues, mentions and CI, or from a Slack mention.
  </Card>

  <Card title="Cloud deployment" icon="cloud" href="/integrations/cloud-deployment">
    Mutagent managed agents, and agents on Paperclip, Mastra Cloud, Vercel or
    the Claude Agent SDK.
  </Card>
</CardGroup>

## Local and hosted

* **Local** integrations need no Mutagent account: Claude Code, Codex and Helix transcripts, JSONL
  files, and pull requests from a checkout you own, with your own git credentials.
* **Hosted** integrations use credentials for another service: an observability backend for traces,
  whose keys Helix reads from environment variables; or the Mutagent GitHub App and the Mutagent
  Slack app, connected once for your organization in the web app (**Configuration › Integrations**)
  or with `mutagent gateway connect`.

## Example: evaluate from Langfuse, fix by pull request

<Steps>
  <Step title="Install Helix with a model key">
    Follow [Install Helix](/helix/install). `helix --list-models` must list at least one
    model.
  </Step>

  <Step title="Write the config">
    Save this as `.mutagent/config.yaml` in your project:

    ```yaml .mutagent/config.yaml theme={null}
    config_version: "0.4.0"
    global:
      sources:
        - name: prod
          platform: langfuse
      targets:
        - name: agents
          platform: local-claude
          mode: local
          root: .claude/agents
          apply:
            kind: markdown
    ```
  </Step>

  <Step title="Export the Langfuse keys">
    Helix reads the Langfuse keys from these fixed variable names (or from the project's `.env`):

    ```bash theme={null}
    export LANGFUSE_PUBLIC_KEY=pk-lf-...
    export LANGFUSE_SECRET_KEY=sk-lf-...
    export LANGFUSE_HOST=https://cloud.langfuse.com   # optional; set it for a self-hosted or regional Langfuse
    ```
  </Step>

  <Step title="Check the setup">
    ```bash theme={null}
    helix -p "/status"
    ```

    `/status` shows the current stage and anything still missing. It needs a working model key.
  </Step>
</Steps>

With this config, `/evaluate` scores the agent on its production traces in Langfuse, and an approved
fix from `/optimize` arrives as a pull request that edits `.claude/agents/`. Helix opens the pull
request with the git and `gh` credentials you already push with.

<Card title="Supported integrations" icon="list-check" href="/get-started/supported-integrations">
  Every LLM provider, sandbox provider, trace source, apply target and channel, with its status.
</Card>


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