---
title: Slack

sidebar:
  label: Slack
  order: 1
---

Start tasks from Slack without opening Metaphor.

Mention Metaphor with a prompt, choose the repository you want to work on, and Metaphor replies in the thread as the task progresses.

## Mention Metaphor

Mention Metaphor in a channel where the Slack app is available:

```txt
@Metaphor Add rate limiting to the checkout API in acme/checkout
```

You can also include a GitHub repository URL:

```txt
@Metaphor Fix the flaky test in https://github.com/acme/checkout
```

If Metaphor can't determine which repository to use, it asks you to choose one in the thread.

## What happens next

After you start a task from Slack:

1. Metaphor acknowledges the request in the thread.
2. The task starts against the selected repository.
3. Metaphor keeps the task's updates in the same thread.
4. When the work is complete, Metaphor replies with the resulting pull request.

If the task can't complete, Metaphor reports the failure in the thread instead.

You still review and merge the pull request when you're ready.

## Requirements

To start tasks from Slack, you need:

- The Metaphor Slack app installed in your workspace
- The [GitHub App](/github) connected to the repositories you want to use
- Access to those repositories through your Metaphor account