Skip to content

armgit / avibe

Public Imported from GitHub
0

Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.

3.5 KB
Raw Blame

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