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

# Setup

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 — include 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)

### 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: **Account 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](https://claude.ai/chat/starting-a-session.md) 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 — DinoAI will pick it up automatically at the start of every session.

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


## Related topics

- [Pre-commit](/integrations/pre-commit/index.md)
- [Data Mesh Setup](/guides/data-mesh-setup/index.md)
- [Paradime Setup and Configuration](/integrations/pre-commit/paradime-setup-and-configuration.md)
- [PII Anonymization with dbt™ Mesh Setup](/guides/pii-anonymization-with-dbt-tm-mesh-setup.md)
- [Snowflake DinoAI Agent Key-Pair Setup](/guides/paradime-101/getting-started-with-the-dinoai-background-agent/snowflake-dinoai-agent-key-pair-setup.md)