VibeAround 命令行

VibeAround 的 npm 包适合从终端开始使用。它会安装 vibearound 和更短的 va 命令，并带上原生 CLI、TUI、launcher、独立 server，以及内置 Web Hub 资源。

Beta 提示：命令行发行包、独立 server、va-launch 和 TUI 目前仍是早期 beta 入口。它们已经可以支持 terminal-first 工作流，但在 server、launch 层、Web Hub、CLI 和 TUI 继续拆分并稳定之前，体验上会比桌面 App 更容易遇到边缘问题。

npm install -g vibearound

核心命令

命令	用途
`va serve`	启动独立的本地 VibeAround server 和内置 Web Hub。
`va tui`	打开终端 dashboard，查看 Agent、Session、运行状态并继续对话。
`va launch --profile NAME`	启动一个已保存的 Agent profile。
`va launch --profile-path PATH`	从 profile JSON 文件启动。
`va status`	显示简洁的运行状态摘要。
`va doctor`	诊断 endpoint、auth 和 server health。

常见路径

用 npm 安装 CLI。
运行 va serve 启动本地 server。
在另一个终端打开 va tui，使用键盘优先的 dashboard。
用 va launch --profile codex 或其他已保存 profile 启动 Agent。
桌面 App、Web Hub、浏览器、手机或消息频道都可以作为同一个本地 hub 的其他入口。

配置文件

默认情况下，VibeAround 的本地 CLI 配置放在 ~/.vibearound。如果想换目录，可以设置 VIBEAROUND_DATA_DIR。

这里有两种不同的 profile 文件：

文件类型	路径	命令
Provider profile	`~/.vibearound/profiles/<id>.json`	`va launch --profile <id>`
Launch profile	任意 JSON 文件路径	`va launch --profile-path <path>`

Provider profile 描述模型凭证和 API Bridge 行为。Launch profile 描述原生启动请求：Agent、Workspace、Terminal、command、args 和 env。

最小 Provider Profile

下面的例子用一个保存好的 xAI / Grok provider profile 启动 Codex。

mkdir -p ~/.vibearound/profiles

~/.vibearound/settings.json

{
  "default_agent": "codex",
  "enabled_agents": ["codex"],
  "workspaces": ["/Users/example/project"]
}

~/.vibearound/profiles/codex-work.json

{
  "id": "codex-work",
  "label": "Codex Work",
  "provider": "xai",
  "auth_mode": "api_key",
  "api_types": ["openai-responses"],
  "credentials": {
    "api_key": "xai-your-key"
  },
  "overrides": {
    "openai-responses": {
      "model": "grok-4.3"
    }
  }
}

id 必须和文件名主干一致。上面的例子必须保存为 codex-work.json。

va launch --profile codex-work --dry-run
va launch --profile codex-work

手写配置时，建议先用 --dry-run。它只校验 profile 并打印 launch plan，不会真正启动 Agent。

最小 Launch Profile

如果你不想走 provider profile 解析，而是想直接指定原生启动参数，可以使用 --profile-path。它适合脚本、冒烟测试，或者显式指定环境变量的场景。

./codex-launch.json

{
  "schemaVersion": 1,
  "agent": "codex",
  "profileId": "direct-codex",
  "workspace": "/Users/example/project",
  "terminal": "terminal",
  "command": "codex",
  "env": {
    "OPENAI_API_KEY": "sk-your-key"
  },
  "args": {
    "native": ["-c", "check_for_update_on_startup=false"]
  }
}

va launch --profile-path ./codex-launch.json --dry-run
va launch --profile-path ./codex-launch.json

terminal 可用值包括 system-terminal、terminal、iterm2、powershell、gnome-terminal、konsole、xfce4-terminal、xterm、kitty、alacritty 和 wezterm。

文件安全

这些文件可能包含 API key。请把 ~/.vibearound 留在本机，不要把 profile JSON 提交到仓库。团队或 CI 场景建议使用环境专属副本。

说明

用户面对的命令是 va serve，不是 va server。npm 包内部也包含原生 vibearound-server binary，但日常启动 server 模式请使用 va serve。