AI导哈

CLI工具包

Vibecodr CLI是一个多功能命令行工具包，提供浏览器工具、计算机工具、Pulse生命周期管理以及应用集成功能。

  • by BradenHartsell
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Braden-sui/Vibecodr-MCP-CLI

使用说明

Vibecodr命令行界面

官方Vibecodr CLI。一个软件包，一个安装命令，一个连贯的界面，用于：

  • 托管浏览器工具（渲染、屏幕截图、PDF、抓取、快照、代理浏览器会话和人工身份验证切换）。
  • 托管计算机工具（运行、测试、工作跟踪、工作提交、证明）。
  • 胶囊上传（zip+图像）到Pulse和托管的MCP网关。
  • 脉冲生命周期（设置、发布、列表、获取、状态、运行、存档、恢复、创建、部署）。
  • 将Vibecodr添加到人们实际使用的应用程序中：Codex、Cursor、VS Code、Windsurf、Claude Desktop和Claude Code。
  • 直接OAuth登录、设备代码登录、状态、医生、诊断。

安装

npm install -g @vibecodr/cli

这将安装三个bin条目，它们都指向同一个调度器：

  • vibecodr --规范名称。完整的统一指挥界面。
  • vibecodr-mcp --来自的用户的兼容性别名 @vibecodr/cli@0.2.x.
  • vc-tools --来自的用户的兼容性别名 @vibecodr/vc-tools@0.1.x。在每个托管的代理计算机命令上，为独立的vc工具二进制文件生成字节等效输出。

您还可以安装旧版tombstone软件包；它转发给同一调度器：

npm install -g @vibecodr/vc-tools

固定到特定版本（推荐用于CI）：

npm install -g @vibecodr/cli@1.0.0

快速开始

如果你还不确定你需要什么，从这里开始：

vibecodr status
vibecodr doctor

默认的人工体验故意简单：CLI应该告诉你 连接了什么，缺少什么，以及下一个要运行的命令。底层 表面保持显式，用于脚本编写、调试和版本验证。

# 1. Sign in for publishing, uploads, Pulses, and MCP Gateway tools.
vibecodr login

# 2. Add Vibecodr to Codex. Other supported apps: Cursor, VS Code, Windsurf,
#    Claude Desktop, and Claude Code.
vibecodr install codex

# 3. Set up the hosted Agent Computer when you want browser/computer work.
vibecodr start
vibecodr browser screenshot https://example.com --local
vibecodr browser session open https://example.com
vibecodr browser session live job_...
vibecodr browser session auth job_...   # when the owner needs to sign in or steer
vibecodr browser session close job_...
# Use --debug or --view devtools only when the inspector panel is needed.
vibecodr browser session live job_... --debug

高级用户和自动化应该更喜欢显式曲面和稳定的JSON：

vibecodr mcp tools --json --non-interactive
vibecodr mcp call get_account_capabilities --input-json '{}' --json --non-interactive
vibecodr status --json --non-interactive

服务器上的代理（无头，无浏览器）

在服务器（SSH、CI、无头VM）上运行的AI代理应驱动托管 通过CLI使用工具，而不是将托管的MCP URL连接到自己的MCP中 客户端——MCP URL是OAuth门控的，其浏览器登录无法在 无头盒子。

# Sign in once with no browser (approve the printed code from your phone).
# Set VC_TOOLS_CREDENTIAL_STORE=file first if the box has no system keyring.
export VC_TOOLS_CREDENTIAL_STORE=file
vibecodr login agent --no-browser

# Then run the hosted tools directly; the CLI holds the credential.
vibecodr doctor --json            # the "agent" field lists the full recipe
vibecodr browser screenshot https://example.com --local
vibecodr computer run "npm test"
vibecodr mcp call <tool> --input-json '{}'

跑 vibecodr status 或 vibecodr doctor （或其 --json)任何时候 食谱和无头登录步骤。

表面

CLI与两个托管端点进行通信。每个命令都只针对其中一个：

端点 命令
tools.vibecodr.space start, setup, login agent, logout agent, agent, connect, try, browser, computer, work, proof, jobs, artifacts, usage, limits, grants, retention, scheduled-qa, plans, dashboard, inspect
openai.vibecodr.space/mcp login mcp, logout mcp, mcp tools, mcp call, tools, call, feedback, upload, pulse, pulse-setup, pulse-publish, whoami
共享本地诊断/安装 status, doctor, install, uninstall, config

CLI身份验证独立于您的编辑器（Codex、Cursor、VS Code、Windsurf、Claude Desktop、Claude Code）与网关协商的身份验证；每个客户端都有自己的会话。 vibecodr login 默认为MCP网关通道。使用 vibecodr login agent 用于托管代理计算机凭据通道。

从以下位置迁移 @vibecodr/vc-tools@0.1.x 或 @vibecodr/cli@0.2.x

你不需要改变任何东西。每个bin名称，env var前缀(VC_TOOLS_*, VIBECDR_MCP_*)，密钥环服务ID(@vibecodr/vc-tools, @vibecodr/mcp)、配置目录、Cloudflare工作程序路由、JWT声明、页面段塞和持久API密钥保持可寻址。看 MIGRATION.md 对于三个部分的细分。

文档

存储库状态

该存储库是Vibecodr CLI的统一宿主。它运送：

  • 已发布的npm包 @vibecodr/cli.
  • Cloudflare工作源 tools.vibecodr.space （in src/hosted/)以及匹配的D1迁移（in migrations/).

Apache-2.0已获得许可。

相关 MCP