convez.ai
Agente
jazzenchen

VibeAround

jazzenchen/VibeAround

Ver no GitHub
BomPluginScore · de 0 a 100

Keep your AI coding agents around. Launch Claude Code, Codex CLI, Gemini CLI, Pi Agent, and more from one place — side by side, connected, reachable, and ready to work across web, mobile, and messaging.

Instalação

$npx convez-ai jazzenchen/VibeAround

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
539
Forks
56
Acompanhando
3
Saúde
42%
Último commit
há 2 meses
Versão
v0.7.25
Issues abertas
6
Contribuidores
6

README

A tradução para o português deste README ainda está na fila.

VibeAround

Your AI coding agents, always around.

Run AI coding agents side by side on your computer. Control them from anywhere, continue previous sessions, and preview what they build.

Download | Demo | Wiki | Discord | WeChat | 简体中文

VibeAround is a unified AI Agent workspace.

Launch Claude Code, Codex CLI, Gemini CLI, Pi, OpenCode, Claude Desktop, Codex Desktop and more directly or with 3rd party AI APIs. Start or continue previous sessions from the command line, browser, mobile messaging apps, or a Web Terminal. Preview what agents build, from dev servers to Markdown, HTML, and generated artifacts.

Why VibeAround

AI coding work is split across agents, model APIs, terminals, messaging apps, browsers, and preview URLs. VibeAround keeps the work together while the agents still run on your computer.

  • Start the right agent with the right model profile, without editing each agent's config files.
  • Keep Claude Code, Codex CLI, Gemini CLI, Pi, OpenCode and more reachable from one workspace.
  • Continue the same sessions from desktop, web, mobile, messaging apps, or a Web Terminal.
  • Preview local dev servers, Markdown, HTML, and generated artifacts without moving execution to a cloud server.

Agent Launch

Launch the right agent with the right model.

Pick an AI agent, model profile or API endpoint, and workspace. VibeAround launches Claude Code, Codex CLI, Gemini CLI, Pi, OpenCode, Claude Desktop, Codex Desktop and more with 3rd party AI APIs, without changing each agent's own config files, skills, MCP servers, workflow, or project context.

  • Launch AI coding agents and desktop apps like Claude and Codex from one desktop UI.
  • Choose agent, model profile, API endpoint, workspace, terminal, and session before launch.
  • Start new sessions or continue previous sessions.
  • Use direct launch or profile-based launch, including profile overlays for Claude Desktop and Codex Desktop.
  • Keep each agent's own config files, workflow, and project context.

API Profiles & Bridge

Use more model providers with the AI agents you prefer. Save provider keys, base URLs, models, and aliases as profiles; when an agent and a provider speak different API shapes, VibeAround's local bridge translates between them.

Agent-facing API shapes             VibeAround API Bridge               Provider API shapes
+-------------------------+         +-----------------------------+      +-------------------------+
| OpenAI Responses        | ----\   | profile-scoped local routes |  /-> | OpenAI Responses        |
| OpenAI Chat Completions | -----\  | model aliases and metadata  | /--> | OpenAI Chat Completions |
| Anthropic Messages      | ------> | request/response translate  | ---> | Anthropic Messages      |
| Gemini Generate Content | -----/  | va-ai-api-bridge (VAAAB)    | \--> | Gemini Generate Content |
+-------------------------+         +-----------------------------+      +-------------------------+

The bridge is powered by va-ai-api-bridge, the standalone VAAAB project behind VibeAround's API translation.

API shapeCommon endpoint
OpenAI Responses/v1/responses
OpenAI Chat Completions/v1/chat/completions
Anthropic Messages/v1/messages
Gemini Generate Content/v1beta/models/{model}:generateContent

Built-in provider presets include DeepSeek, Alibaba DashScope, Moonshot / Kimi, MiniMax, Xiaomi MiMo, xAI / Grok, NVIDIA NIM, Z.AI / GLM, Google Gemini, OpenRouter, Azure OpenAI, and custom endpoints.

  • Save API settings with keys, base URLs, models, aliases, and metadata.
  • Bridge OpenAI Responses, OpenAI Chat Completions, Anthropic Messages, and Gemini Generate Content shapes.
  • Run the same AI agent with different API profiles across sessions.

Unified Workspace

One workspace for every AI agent.

Coordinate agents and sessions from a single workspace. Run agents side by side, or as a team.

  • Manage agents and sessions from a single place.
  • Switch between workspaces and agents.
  • Continue, archive, and hand over sessions.
  • Coordinate agents in parallel, team, and roundtable modes. (coming soon)
  • View status for agents, channels, tunnels, and runtime health.
  • Access the same workspace from desktop, web, mobile, messaging, or terminal.

Remote Messaging & Web Terminal

Step away, stay in control.

Continue your latest session from messaging apps, desktop browsers, or mobile browsers. Switch workspaces and agents with /switch, and preview results remotely when an agent finishes a task. You can also control AI agents directly through a Web Terminal.

  • Chat directly with AI agents from messaging apps such as Feishu/Lark, Discord, and Slack.
  • Continue the same session remotely without losing context.
  • Quickly switch between workspaces and agents.
  • Access local AI agent through a Web Terminal.
  • Use tunnels for remote access while execution stays on your own computer, without using any cloud server.

Live Preview

Preview what AI agents are building.

VibeAround turns dev servers, Markdown files, HTML files, and generated artifacts into previewable links you can open from desktop browsers, mobile browsers, or messaging apps.

  • Generate owner links and scoped short-lived share links.
  • Use tunnels to access preview links remotely.
  • Preview dev servers, Markdown files, and HTML files.

Supported AI Agents

AgentLaunchContinue / handoverProfile routing
Claude Code✅✅✅
Claude Desktop✅—✅
Codex CLI✅✅✅
Codex Desktop✅—✅
Pi✅✅✅
Gemini CLI✅✅✅
OpenCode✅⚠️✅
Cursor CLI➜✅—
Kiro CLI➜✅—
Qwen Code➜✅—

✅ Supported · ⚠️ Partial · ➜ Direct launch · — Not supported

Supported Providers

Preset profiles cover common official and compatible providers. Custom endpoints are available when your provider speaks a supported API shape.

ProviderNotes
DeepSeekOpenAI-compatible and bridge routes, model aliases, Claude suffix normalization
Alibaba DashScopeCoding Plan and Token Plan endpoints
Moonshot / KimiOpenAI-compatible and Anthropic-style bridge flows
MiniMaxOpenAI-compatible and Anthropic-style bridge flows
Xiaomi MiMoToken Plan and regional endpoints with provider quirks handled
xAI / GrokResponses and Chat variants
NVIDIA NIMOpenAI-compatible Chat Completions
Z.AI / GLMBuilt-in compatible endpoint
Google GeminiNative Gemini API profile
OpenRouterOpenAI-compatible profile
Azure OpenAIResponses and Chat deployment routing
Custom endpointBring your own base URL, headers, models, and API kinds

Messaging Channels

Channel plugins are installed and managed by VibeAround.

ChannelSetup styleTypical use
TelegramBotFather tokenPersonal bot and mobile chat
Feishu / LarkApp credentialsTeam IM and enterprise bot
DiscordBot tokenServer and DM workflows
SlackBot/App token with Socket ModeWorkspace DM workflows
WeChatQR login through OpenClaw-compatible bridgeChinese personal chat
DingTalkStream API credentialsEnterprise chat
WeComWebSocket bot credentialsEnterprise WeChat workflows
QQ BotGuild bot credentialsQQ bot workflows

Local-first Security

VibeAround keeps AI coding work on your computer by default.

  • Agents run on your computer.
  • Provider credentials stay in local VibeAround settings/profile storage.
  • The daemon listens on loopback unless you explicitly enable a tunnel.
  • Dashboard APIs and WebSocket routes require a local auth token.
  • Public tunnel URLs require browser pairing.
  • Preview links are scoped and short-lived.
  • Agent CLIs use your local project permissions.

Quick Start

  1. Download the latest desktop package for your platform.
  2. Open VibeAround and complete onboarding.
  3. Enable the agent CLIs you use.
  4. Add API profiles if you want VibeAround to route model traffic.
  5. Pick an agent, model profile, terminal, workspace, and session from Launch.
  6. Continue from desktop, Web Chat, Web Terminal, or a configured messaging channel.

Detailed guides live in the Wiki.

Download

Latest release: VibeAround v0.7.4.

PlatformRecommended download
macOS Apple SiliconVibeAround_0.7.4_arm64.dmg
Windows x64Setup EXE, MSI, or portable ZIP
Linux x64AppImage or deb

Windows and Linux packages are built by GitHub Actions. The macOS package is currently Apple Silicon only.

Migration Guide From 0.6.x

v0.7.3 changes Startkit state, detected agent sources, desktop launch targets, and profile launch settings. If you are upgrading from 0.6.x, do a clean local-state migration:

  1. Quit VibeAround.
  2. Make a full backup of the old ~/.vibearound directory.
  3. Remove the old ~/.vibearound directory.
  4. Restore only durable state from the backup.
  5. Launch VibeAround v0.7.3 and rerun onboarding / Startkit setup if Launch, profile, Startkit, or desktop-agent settings look stale.

Restore these durable items only: settings.json, profiles/, google-oauth/, agents.json, launcher.json, state/, sessions/, launch-session-archive.json, workspaces/, and worktrees/.

Do not restore generated or runtime data such as .cache/, cache/startkit/, agents.detected.json, desktop-apps.detected.json, profile-state/, api-bridge/launches/, logs/, npm-global/, plugins/, bin/, runtime/, or auth.json.

macOS / Linux:

set -euo pipefail

BACKUP="$HOME/vibearound-0.6-full-backup-$(date +%Y%m%d%H%M%S)"
SOURCE="$HOME/.vibearound"

if [ -d "$SOURCE" ]; then
  cp -a "$SOURCE" "$BACKUP"
  rm -rf "$SOURCE"
fi

mkdir -p "$SOURCE"

for item in settings.json profiles google-oauth agents.json launcher.json state sessions launch-session-archive.json workspaces worktrees; do
  [ -e "$BACKUP/$item" ] && cp -a "$BACKUP/$item" "$SOURCE/"
done

Windows PowerShell:

$ErrorActionPreference = "Stop"

$Backup = Join-Path $env:USERPROFILE ("vibearound-0.6-full-backup-" + (Get-Date -Format "yyyyMMddHHmmss"))
$SourceRoot = Join-Path $env:USERPROFILE ".vibearound"

if (Test-Path $SourceRoot) {
  Copy-Item $SourceRoot $Backup -Recurse -Force
  Remove-Item $SourceRoot -Recurse -Force
}

New-Item -ItemType Directory -Force -Path $SourceRoot | Out-Null

$Items = @(
  "settings.json", "profiles", "google-oauth", "agents.json", "launcher.json",
  "state", "sessions", "launch-session-archive.json", "workspaces", "worktrees"
)

foreach ($Item in $Items) {
  $Source = Join-Path $Backup $Item
  if (Test-Path $Source) { Copy-Item $Source $SourceRoot -Recurse -Force }
}

Develop Locally

cd src
bun install
bun run prebuild
bun run dev

Prerequisites: Rust 1.82+, Bun 1.3+, and Node.js 24 LTS recommended. macOS also needs Xcode command line tools; Linux needs the WebKitGTK/Tauri system dependencies for your distribution.

Documentation

Community

Ask questions, share workflows, or which agent/provider/channel should be smoother next.

Discord Product Hunt

Friendly community: LINUX DO

WeChat group for Chinese-language discussion:

This WeChat QR code is valid until June 19, 2026. Use Discord or GitHub Issues to ask for the latest one if it has expired.

License

MIT

Ver o original no GitHub

Bom para

Relacionados