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

# Mills Slack installation and demo

> Screenshots of Mills authorization, channel setup, and issue investigations in Slack.

Mills brings production issue investigations into Slack: recorded signals,
investigation findings, an evolving timeline, and downloadable context for coding
agents. The Slack app is currently named **Sawmills**; the agent is **Mills**.

## 1. Start in Mills

Sign in at [app.agentmills.ai](https://app.agentmills.ai), select your organization,
then open **Integrations** and connect Slack. Choose whether Mills may automatically
join public notification channels. With automatic joining disabled, invite Mills
to each notification channel yourself.

<img src="https://mintcdn.com/sawmills/wnkw2MGeYo5gcm8f/images/mills-slack/connect.png?fit=max&auto=format&n=wnkw2MGeYo5gcm8f&q=85&s=78d12a6f791dc556c7ba61b88cbb1048" alt="Mills Connect Slack authorization options" width="1160" height="725" data-path="images/mills-slack/connect.png" />

## 2. Authorize your Slack workspace

Slack opens a consent screen. Select the workspace where you want to install
Mills, review the permissions and linked terms, then choose **Allow**. Return to
Mills to finish the connection.

The screenshot shows the consent screen for an existing internal installation.
Use your own workspace when installing.

<img src="https://mintcdn.com/sawmills/wnkw2MGeYo5gcm8f/images/mills-slack/oauth.png?fit=max&auto=format&n=wnkw2MGeYo5gcm8f&q=85&s=78f6a1a61b0690407e6b73dc89cdedeb" alt="Slack OAuth workspace selection and consent screen" width="1800" height="1399" data-path="images/mills-slack/oauth.png" />

## 3. Configure and validate the channel

Open the Slack account configuration, choose a notification channel, and save.
Use **Validate** to check the token and channel membership. Use **Send test
message** to confirm delivery. Configure escalation and resolution notifications
and the minimum severity appropriate for your team.

The captured connection passed validation. Delivery is a separate check; this
capture does not show a successful test-message delivery.

<img src="https://mintcdn.com/sawmills/wnkw2MGeYo5gcm8f/images/mills-slack/configured.png?fit=max&auto=format&n=wnkw2MGeYo5gcm8f&q=85&s=7ae03baed4eafe37099bc6c3ee7fe70e" alt="Configured Slack account with successful token and channel validation" width="768" height="1499" data-path="images/mills-slack/configured.png" />

Reconnect refreshes access to the existing workspace. To switch workspaces,
disconnect the current account first, then connect Slack again. This changes
the notification destination for the selected Mills organization.

## 4. Investigate issues from Slack

An issue notification includes its severity, recorded signals, and an **Open
issue** link to the full investigation in Mills. The investigation timeline records
changes as the issue develops. The thread's **agent-context.json** attachment
provides investigation context for a coding agent.

The following image is a sanitized, illustrative example of the Slack issue
layout. Its text and timestamps have been replaced; it is not a live delivery
record or customer telemetry.

<img src="https://mintcdn.com/sawmills/wnkw2MGeYo5gcm8f/images/mills-slack/issue-example.png?fit=max&auto=format&n=wnkw2MGeYo5gcm8f&q=85&s=9ac3468d22176bd0f287d0feab9b384e" alt="Sanitized illustrative Mills issue notification with timeline and agent context" width="1600" height="1000" data-path="images/mills-slack/issue-example.png" />

## 5. Continue the conversation

Following **Open issue** opens the investigation in Mills. This screenshot shows
an existing Acme demo issue with its findings, triggered monitors, and timeline.
It is historical demo data, not evidence of a currently running investigation.

<img src="https://mintcdn.com/sawmills/wnkw2MGeYo5gcm8f/images/mills-slack/investigation.png?fit=max&auto=format&n=wnkw2MGeYo5gcm8f&q=85&s=04b36aafc84a4b75d7d514787f0204fa" alt="Historical Acme demo issue findings, monitors, and investigation timeline" width="1260" height="1138" data-path="images/mills-slack/investigation.png" />

Mention **@Mills** in a channel it has joined, or send a direct message. Ask for an
issue summary, then continue in the same thread to preserve conversation context.
See [using Mills in Slack](/docs/sawmills-agent-slack) for conversation guidance.

For setup or review assistance, contact [support@sawmills.ai](mailto:support@sawmills.ai).
