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

# Slack Agent setup

> Set up the DinoAI Slack Agent by connecting Slack, GitHub, and your warehouse to Paradime so DinoAI can run dbt™ jobs and open pull requests from Slack.

The Slack Agent requires three connections before it can run. Complete these in order.

### 1. Connect Slack

DinoAI communicates entirely through Slack. Progress updates, results, and errors all land in your connected workspace.

Navigate to: **Workspace Settings > Integrations > Paradime Slack App > Connect**

You'll be redirected to Slack to authorise the app. Sign in and approve the required permissions.

> **Already have Slack connected?** Disconnect and reconnect to pick up the new background agent permissions required by the Slack Agent.

[Learn more about the Slack integration →](/integrations/slack)

### 2. Install the GitHub App

DinoAI needs GitHub access to push branches and open PRs against your connected repo.

Navigate to: **Workspace Settings > Integrations > GitHub > Connect**

1. Authenticate with GitHub when redirected
2. Select the repositories to connect, including the repo tied to your Paradime workspace
3. Click **Install and authorize**

> **Not a GitHub organisation owner?** Click **Authorize & Request**. This sends an automated approval request to your org owner, who will need to approve it before the integration activates.

[Learn more about the GitHub integration →](/integrations/github/github-app)

### 3. Set Up the Agent Environment

This is the warehouse connection DinoAI uses at runtime when executing models or running queries on your behalf.

Navigate to: **Workspace Settings > Connections > DinoAI Background Agent Environment**

Select your warehouse and follow the configuration guide for your platform.

> **Recommended:** Create a dedicated service user with its own permissions for the background agent. Read-only access to your production database is a good starting point.

### You're Ready

Once all three connections are active, DinoAI can run fully in the background. Head to [Starting a Session](/products/dino-ai/slack-agent/starting-a-session) to send your first task.

### Customise Agent Behaviour with `.dinorules`

Want DinoAI to follow your team's conventions, coding standards, or workflow preferences? Add a `.dinorules` file to the root of your repository and merge it into your default branch, and DinoAI will pick it up automatically at the start of every session.

[Learn how to configure `.dinorules` →](/products/dino-ai/dino-rules)


## Related topics

- [Slack Agent](/products/dino-ai/slack-agent/index.md)
- [Customize the Slack Agent](/products/dino-ai/slack-agent/customize-agent.md)
- [Starting a Slack Agent session](/products/dino-ai/slack-agent/starting-a-session.md)
- [Customize the DinoAI Slack agent](/changelog/2026-07-22/customize-slack-agent.md)
- [July 28 improvements: Bolt, Slack agent, Catalog](/changelog/2026-07-28/other-improvements.md)