🎛️ Switch agents mid-conversation

Run /switch claude, /switch codex, or /switch cursor from any channel to switch agents on the fly — no VibeAround restart needed.

👁️ Live preview

Share dev servers and rendered Markdown/HTML through short-lived links that open on your phone or any browser.

🖥️ One-click setup wizard

The wizard installs agent dependencies, fills in each channel's credentials, and picks a tunnel provider for you. You rarely need to touch a config file manually.

Quick start

cd src
bun install
bun run prebuild
bun run dev

The desktop app opens its setup wizard on first launch: choose agents, configure channels, and set up the tunnel.

Prerequisites: Rust 1.82+, Node.js 20+, Bun 1.1+. On macOS, also run xcode-select --install.

If you don't have them yet, follow the official install guides: Rust, Bun, Node.js.

Supported agents

All agents communicate over stdio via ACP (Agent Client Protocol). Agents distributed through npm are installed automatically on first use.

| Agent | ACP | Session Handover | |---|---|---| | Claude Code | ✅ | ✅ | | Gemini CLI | ✅ | ✅ | | Codex CLI | ✅ | ✅ | | Cursor CLI | ✅ | ✅ | | Kiro CLI | ✅ | ✅ | | Qwen Code | ✅ | ✅ | | OpenCode | ✅ | ❌ |

Channel plugins

Each channel runs as a standalone Node.js plugin built with @vibearound/plugin-channel-sdk.

| Channel | Auth | DM | File/Image | Streaming | Status | |---|---|---|---|---|---| | Telegram | Bot token | ✅ | ✅ | ✅ | ✅ | | Feishu / Lark | App credentials | ✅ | ✅ | ✅ | ✅ | | Discord | Bot token | ✅ | ✅ | ✅ | ✅ | | Slack | Bot + App token | ✅ | ✅ | ✅ | ✅ | | WeChat | QR code login | ✅ | ✅ | ❌ | ✅ | | DingTalk | AppKey + Secret | ✅ | ✅ | ✅ | ✅ | | WeCom | Bot ID + Secret | ✅ | ✅ | ✅ | ✅ | | QQ Bot | App ID + Token | ✅ | ✅ | ❌ | ✅ |

Under the hood

• Built on ACP (Agent Client Protocol) — every supported agent speaks the same protocol over stdio, so adding a new agent is cheap and switching between them feels consistent.
• Built-in tunnels — reach the web terminal and live preview from your phone or any browser. Ships with ngrok, localtunnel, and Cloudflare backends.
• Plugin architecture — every IM channel is a standalone Node.js subprocess published to npm and loaded on demand. Build your own with @vibearound/plugin-channel-sdk without touching the core.
• Native rendering for every channel — each plugin uses the platform's own SDK (Telegraf, Lark SDK, Slack Bolt, …). Messages render in the richest format each platform supports, not a lowest-common-denominator layer.
• Token-gated public URLs — the web terminal and live preview exposed through tunnels require auth, so the URLs are public but only you can open them.
• Multi-agent, multi-channel concurrency — different agents can run on different channels at the same time (e.g. Claude in Telegram, Codex in Slack). Separate routes and separate sessions keep everything isolated.
• Skill + MCP auto-injection — on startup, VibeAround writes its skills (SKILL.md) and MCP endpoint into each enabled agent's global config, so the agent discovers VibeAround automatically.

Commands

Two kinds of slash commands:

• System commands manage the VibeAround session itself (reset, switch agents, hand sessions between channels, …) — the UX layer we add on top.
• Agent relay — /agent <command> forwards any slash command straight to the underlying agent, so agent-native features (e.g. Claude Code's /status) still work inside your IM chat.

| Command | What it does | |---|---| | /help | Show available commands | | /new | Reset the session and start a fresh conversation | | /switch <agent> | Switch agents mid-conversation (claude, gemini, codex, cursor, kiro, qwen-code, opencode) | | /profile <name> | Switch profile | | /close | Close the conversation | | /handover | Export the current session so you can resume it elsewhere | | /pickup <code> | Resume a session handed over from another channel | | /agent <command> | Send a slash command to the agent, for example /agent status |

In Slack, the / prefix is reserved by the client, so use /va or /vibearound instead, for example /va switch claude.

Platforms

The codebase runs on macOS, Linux, and Windows. Prebuilt binaries are currently bundled only for macOS. Linux and Windows users can still build from source, and contributions for cross-platform CI are very welcome.

Documentation

• Wiki Home
• Setup Guide
• Channel Plugins
• Architecture
• Configuration
• FAQ & Troubleshooting

What's next

• One-click CLI launcher — save your API keys in the desktop app and launch Claude Code or Codex pre-wired to your provider of choice (Zhipu, Minimax, Qwen, DeepSeek, …)
• More IM channels — WhatsApp, LINE, Microsoft Teams
• Containerized + sandboxed agents — run each agent in an isolated container / sandbox so file system and network access stay within safe boundaries
• Enhanced web chat — upgrade the built-in web chat with richer rendering, file upload, and history controls
• Workspace isolation — separate agent settings, channel settings, and session history per workspace

License

MIT