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

# Connect Tools to Your Experiments

> Set up GitHub, Linear, and Slack so your experiments automatically link to PRs, tickets, and team conversations.

Every experiment generates artifacts across multiple tools — a PR in GitHub, a ticket in Linear, a thread in Slack. Without linking them, you're context-switching between tabs and copying URLs manually. This tutorial connects your tools so that creating an experiment in Remyx automatically creates a linked ticket, and changes in either direction sync in real time.

## What this sets up

By the end of this tutorial, you'll have:

* **GitHub** connected for PR linking and repo file tree access
* **Linear** connected for automatic ticket creation and bidirectional status sync
* **Slack** connected for the managed AI agent and daily digests

<Note>
  **Starting point:** You have a Remyx account and at least one experiment created. You have admin access to a GitHub org, Linear workspace, and Slack workspace.
</Note>

***

## Step 1: Connect GitHub

GitHub integration gives Remyx access to your repos for launch context generation and PR linking.

1. Navigate to **Connectors** in the sidebar
2. Click **Connect** on the GitHub card
3. You'll be redirected to GitHub to authorize the Remyx app
4. Select the organization and repositories to grant access to
5. Click **Authorize** — you'll be redirected back to Remyx

### Verify

Go to any experiment detail page and check the **Implement** section. You should see the Claude Code command pre-configured with your connected repo.

***

## Step 2: Connect Linear

Linear integration creates tickets automatically when you create experiments.

1. Navigate to **Connectors** in the sidebar
2. Click **Connect** on the Linear card
3. Authorize Remyx when prompted
4. Go to **Project Settings** for your project (click the gear icon from any experiment page)
5. Under **Linear Project**, select which Linear project should receive experiment tickets

### Verify

Create a new experiment. After creation, check:

* The experiment detail page shows a **Linear ticket** link in the sidebar
* Opening the Linear ticket shows the experiment name, hypothesis, and a link back to Remyx

### Bidirectional Sync

Changes in Linear automatically update the experiment in Remyx:

| Action in Linear      | Effect in Remyx                |
| --------------------- | ------------------------------ |
| Change issue status   | Experiment status updates      |
| Add `ship` label      | Decision state updated         |
| Add `abandon` label   | Decision state updated         |
| Comment with `@remyx` | AI agent responds with context |

***

## Step 3: Connect Slack

The Slack integration adds a managed AI agent to your workspace.

1. Navigate to **Connectors** in the sidebar
2. Click **Connect** on the Slack card
3. Install the Remyx AI app to your workspace
4. Select a default channel for digest delivery (e.g., `#ml-experiments`)
5. In Slack, invite the bot: `/invite @Remyx` in your channel

### Verify

In your Slack channel, type:

```
@remyx show me my experiments
```

The bot should respond with a list of your recent experiments.

### Test the Digest

In your Slack channel, ask:

```
@remyx show me today's digest
```

The bot should respond with your latest recommendations grouped by Research Interest.

***

## Step 4: Test the Full Flow

Now let's test everything end-to-end:

<Steps>
  <Step title="Create an experiment">
    Go to **Experiments > New Experiment**. Create an experiment with a hypothesis, target metric, and tags.
  </Step>

  <Step title="Check Linear">
    A ticket should appear in your linked Linear project within seconds. Open it — the description includes the hypothesis and a link back to Remyx.
  </Step>

  <Step title="Update in Linear">
    Change the ticket status in Linear (e.g., move to "In Progress"). Switch back to the Remyx experiment detail page — the status should be synced.
  </Step>

  <Step title="Ask in Slack">
    In your channel, ask: `@remyx what's the status of my latest experiment?` The bot responds with the current experiment state.
  </Step>
</Steps>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tickets aren't being created in Linear">
    Check that your project has a linked Linear project in **Project Settings**. Without this, Remyx doesn't know which project to create tickets in.
  </Accordion>

  <Accordion title="Status changes in Linear aren't syncing">
    Verify the webhook exists: In Linear, go to **Settings > API > Webhooks**. You should see a Remyx webhook. If it's missing, disconnect and reconnect Linear at **Connectors**.
  </Accordion>

  <Accordion title="Slack bot doesn't respond">
    Make sure the bot is invited to the channel (`/invite @Remyx`). Check that the Slack connection shows as active at **Connectors**.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Implement an experiment with Claude Code" icon="terminal" href="/tutorials/get-started/implement-an-experiment">
    Use the MCP server to implement experiments with AI
  </Card>

  <Card title="Integrations Reference" icon="plug" href="/platform/manage/connectors">
    Full integration documentation
  </Card>
</CardGroup>