Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt

Use this file to discover all available pages before exploring further.

Credentials

1. Create a Slack App

  1. Go to https://api.slack.com/apps
  2. Create New App -> From scratch
  3. Name it (e.g., “Mirage”) and select your workspace

2. Configure Bot Permissions

  1. OAuth & Permissions in the left sidebar
  2. Under Bot Token Scopes, add:
    • channels:history - read messages in public channels
    • channels:read - list public channels
    • groups:history - read messages in private channels (optional)
    • groups:read - list private channels (optional)
    • chat:write - send messages (for write mode)

3. Install to Workspace

  1. Install App in the left sidebar -> Install to Workspace
  2. Authorize the requested permissions
  3. Copy the Bot User OAuth Token (xoxb-...)

4. Set Environment Variables

# .env.development
SLACK_BOT_TOKEN=xoxb-xxxx...

5. Invite the Bot

The bot must be invited to channels it needs to read:
/invite @Mirage
For Python configuration, see the Python Slack Setup guide.