Skip to content

SLACK_SETUP.md

Latest commit

 

History

History
157 lines (122 loc) · 3.54 KB

SLACK_SETUP.md

File metadata and controls

157 lines (122 loc) · 3.54 KB
Raw

Slack Setup Guide

TL;DR

vibe

Browser opens -> Follow the wizard -> Done!

Step 1: Pick an agent backend

Run vibe to open the browser wizard. Click Get started on the welcome screen, then the next step detects installed agents (Claude Code, OpenCode, Codex) and asks you to sign in or paste a key. The same config also lives at Settings -> Backends:

Backend Settings

Enable at least one backend, then continue.

Step 2: Slack Configuration

The wizard guides you through creating a Slack App:

Slack Configuration

  1. Click Create Slack App - opens Slack with manifest pre-filled
  2. Select your workspace and click Create
  3. Follow the accordion steps to get Bot Token (xoxb-) and App Token (xapp-)
  4. Click Validate Tokens to verify
Manual Setup (if needed)

Go to api.slack.com/apps and create app with this manifest:

{
  "_metadata": {
    "major_version": 1,
    "minor_version": 1
  },
  "display_information": {
    "name": "Avibe",
    "description": "AI coding agent runtime for Slack",
    "background_color": "#262626"
  },
  "features": {
    "bot_user": {
      "display_name": "Avibe",
      "always_online": true
    },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "channels:history",
        "channels:read",
        "chat:write",
        "app_mentions:read",
        "users:read",
        "commands",
        "groups:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "files:read",
        "files:write",
        "reactions:read",
        "reactions:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "app_mention",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true
    },
    "org_deploy_enabled": true,
    "socket_mode_enabled": true,
    "token_rotation_enabled": false
  }
}

Step 3: Review & Finish

Review your configuration and click Finish & Start:

Review & Finish

The wizard shows quick tips on how to use Avibe.

Step 4: Dashboard

Once setup is complete, you'll see the Dashboard:

Dashboard

From here you can:

  • Start/stop the service
  • Configure message handling options
  • Manage channel settings

Using in Slack

  1. Invite bot to channel: /invite @Avibe
  2. Type @Avibe /start to open control panel
  3. To use the bot in DM, send bind <code> with a bind code from the web UI (/bind <code> is also supported)
  4. Start coding!

Tips:

  • Each Slack thread = isolated session
  • Start multiple threads for parallel tasks
  • Use AgentName: message to route to specific agent

Troubleshooting

Problem Fix
Bot not responding Check vibe status, ensure bot is invited to channel
Permission error Reinstall app to workspace
Socket error Verify xapp- token has connections:write scope

Logs: ~/.vibe_remote/logs/vibe_remote.log

Diagnostics: vibe doctor