> For the complete documentation index, see [llms.txt](https://docs.paradime.io/app-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paradime.io/app-help/products/dino-ai/slack-agent/setup.md).

# 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 →](/app-help/integrations/slack.md)

### 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 →](/app-help/integrations/github.md)

### 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` →](/app-help/products/dino-ai/dino-rules.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.paradime.io/app-help/products/dino-ai/slack-agent/setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.