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

# Slack

> Connect Slack with token-backed search, reading, posting, and notifications.

## Recommended setup

Arden currently supports Slack through workspace tokens. The desktop setup
assistant makes the token path explicit and verifies it before saving.

<Steps>
  ### Open Integrations settings

  Go to **Settings → Integrations → Slack**.

  ### Run the setup assistant

  Click **Run setup assistant**.

  Choose the token type:

  * **Bot token** – starts with `xoxb-`; best for posting and notifier-style behavior
  * **User token** – starts with `xoxp-`; useful when you need user-level Slack access

  ### Paste and verify the token

  Paste the token into the assistant and click verify. Arden calls Slack
  `auth.test` and shows the workspace and user details if the token works.

  ### Save the connection

  After verification, save the token from the Integrations card. Arden reloads
  integration clients automatically.
</Steps>

## Manual setup

You can also set tokens through environment/config:

```bash theme={null}
export SLACK_BOT_TOKEN=xoxb-...
export SLACK_USER_TOKEN=xoxp-...
```

Or save the token in **Settings → Integrations → Slack**.

## Available tools

| Tool                         | Description                                |
| ---------------------------- | ------------------------------------------ |
| `slack_search`               | Search Slack messages                      |
| `slack_channel`              | Read channel history                       |
| `slack_thread`               | Read a thread                              |
| `slack_dm` / `slack_dms`     | Read direct messages                       |
| `slack_file`                 | Read Slack file/image content              |
| `slack_post_message`         | Post a message (requires approval)         |
| `slack_post_blocks`          | Post block-kit content (requires approval) |
| `slack_user` / `slack_users` | Resolve Slack users                        |

## Token notes

* `xoxb-` bot tokens usually need the bot to be invited to private channels before it can read or post there.
* `xoxp-` user tokens act as the installing user and should be treated as highly sensitive.
* If verification fails, check the token prefix, workspace, revoked-token state, and Slack app scopes.

## Current limitation

Arden does **not** ship a shared Slack OAuth app yet. The setup assistant is intentionally honest: token setup now, OAuth install later.