Skip to content

SLACK_SETUP.md

Latest commit

 

History

History
157 lines (122 loc) · 3.36 KB

SLACK_SETUP.md

File metadata and controls

157 lines (122 loc) · 3.36 KB
Raw

Slack Setup Guide

TL;DR

vibe

Browser opens -> Follow the wizard -> Done!

Step 1: Welcome

Run vibe to launch the setup wizard. Your browser opens automatically:

Setup Welcome

Click Get started to begin.

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": "Vibe Remote",
    "description": "AI coding agent runtime for Slack",
    "background_color": "#262626"
  },
  "features": {
    "bot_user": {
      "display_name": "Vibe Remote",
      "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 Vibe Remote.

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 @Vibe Remote
  2. Type @Vibe Remote /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