一个最近很火的cursor插件：vibe-tools

是魔丸啊
1,399 阅读5分钟

项目概览

vibe‑tools（原 cursor‑tools） 是一个为 Cursor Agent（或任何能执行命令的 AI 编程助手）扩展能力的 CLI 工具包。
安装后，你的 AI 助手可以即时调用一整支“AI 团队”来做 检索、代码审查、浏览器自动化、GitHub 操作、文档生成、YouTube 视频分析 等工作。

AI 团队成员

昵称技能主要模型 / 服务
Perplexity实时网页搜索与深度调研Perplexity API
Gemini超大上下文（百万 Token）代码理解、规划Google Gemini 2.x
StagehandPlaywright 驱动的浏览器控制、录屏、网络日志抓取Anthropic / OpenAI
OpenRouter统一调用多家模型（用于 MCP 命令）OpenRouter
其它GitHub、Xcode、YouTube 分析等见下表

你只需在对话里说“让 Perplexity 搜一下”或“让 Gemini 制定计划”，Cursor Agent 就会自动转成对应命令。

快速上手

  1. 全局安装
npm install -g vibe-tools
  1. 交互式配置（推荐）
vibe-tools install .

按照提示填写 Perplexity API Key 和 Google Gemini API Key，工具会自动为下列 IDE 写入规则文件：

环境生成的规则文件
Cursor.cursor/rules/vibe-tools.mdc 或旧 .cursorrules
Claude CodeCLAUDE.md
Windsurf.windsurfrules
Cline / Roo.clinerules/vibe-tools.md
Codexcodex.md
  1. 必备环境
组件最低版本
Node.js18+
Playwright（浏览器命令用）npm i -g playwright

核心命令一览

命令作用常见用法示例
web网页检索（Perplexity）vibe-tools web "TypeScript 5.7 新特性"
repo整仓代码问答（Gemini）vibe-tools repo "解释登录流程"
plan智能规划（先搜文件再思考）vibe-tools plan "重构用户模型"
doc生成本地或 GitHub 仓库文档vibe-tools doc --save-to=DOC.md
browser打开 / 操作 / 观察 / 抓取网页vibe-tools browser act "点击登录" --url=https://…
github查看 Issue / PR，带完整讨论vibe-tools github pr 123
youtube总结 / 转录 / 提问 YouTube 视频vibe-tools youtube https://youtu.be/ID --type=summary
ask直接点名模型答复vibe-tools ask "REST vs GraphQL" --provider openai --model o3-mini
xcodeiOS 项目构建 / 运行 / Lintvibe-tools xcode build

昵称规则

  • “Gemini” = vibe-tools repo
  • “Perplexity” = vibe-tools web
  • “Stagehand” = vibe-tools browser

典型使用场景

  1. 代码审查（Gemini Code Review）

    “请让 Gemini 审查刚刚的提交并列出需要修改的文件。”

  2. 网页调研（Perplexity）

    “帮我查一下各国 Stripe 支付方式，用 Perplexity。”

  3. 浏览器自动化测试

    vibe-tools browser act "填写注册表单 | 点击提交"
  --url http://localhost:3000/signup --video=./recordings

  4. 生成依赖库文档

    vibe-tools doc --from-github=expressjs/express --save-to=docs/EXPRESS.md

  5. 分析 YouTube 技术教程

    vibe-tools youtube https://youtu.be/VIDEO --type=plan

配置与进阶

  • vibe-tools.config.json
    全局 ~/.vibe-tools/ 或项目根目录均可放置，用来自定义各命令默认的 provider、model、headless 等参数。

  • 认证方式

    服务认证变量 / 文件
    PerplexityPERPLEXITY_API_KEY
    GeminiGEMINI_API_KEY（支持 API Key / 服务账号 JSON / ADC）
    OpenAIOPENAI_API_KEY（可选）
    AnthropicANTHROPIC_API_KEY（可选）
    GitHubGITHUB_TOKEN 或已登录 gh CLI

  • Repomix
    repo / plan / doc 命令用 Repomix 打包仓库上下文，可通过 .repomixignore 或 repomix.config.json 控制排除文件，避免超过 Gemini 2 M token 限制。

故障排查速查表

问题解决思路
命令找不到确认 npm install -g 成功，PATH 含全局 bin
API Key 错误重新 vibe-tools install 或检查 .vibe-tools.env
GitHub 限流 / 私库访问失败设置 GITHUB_TOKEN 或登录 gh auth login
浏览器操作元素找不到用 --no-headless 目视调试或先 browser observe
超大仓库超限用 .repomixignore 排除 / 分目录分析

一句话总结

vibe‑tools = “一键装好”的 AI 多合一工具箱 —— 给你的 Cursor Agent 配备 Perplexity、Gemini、Stagehand 等“队友”，让代码检索、文档生成、浏览器测试、GitHub 操作、视频分析统统一句话搞定。

二者定位

Cursor IDEcursor‑tools（现名 vibe‑tools）
本质一款基于 VS Code 的 AI 编程 IDE一个 CLI 工具包，给 Cursor IDE（或其他支持命令的 AI 助手）“外挂”多种新技能
开发方Cursor 官方开源社区（作者 @eastlondoner 等）
关系Cursor IDE 内置 Agent（Composer 模式）能够执行本地命令cursor‑tools 通过生成 .cursor/rules/vibe-tools.mdc 等规则文件，把自己的命令暴露给 Cursor Agent 调用
是否官方插件✔ IDE 本体✖ 非官方；独立安装、独立维护
作用编辑、补全、聊天、调试等 IDE 功能提供 Perplexity 检索、Gemini 超大上下文分析、浏览器自动化、GitHub Issue/PR 操作、YouTube 视频解析 等扩展命令
适用范围仅 Cursor IDECursor、Claude Code、Windsurf 等多种 AI‑IDE，甚至纯命令行

工作原理

  1. 全局安装 npm i -g vibe-tools，再执行 vibe-tools install .。

  2. 安装脚本会在项目或用户目录写入 Cursor 规则文件（.cursor/rules/vibe-tools.mdc 或旧版 .cursorrules）。

  3. Cursor Agent 读取这些规则后，你只需在对话里说：

    • “让 Perplexity 搜一下 …” → 等同 vibe-tools web …
    • “让 Gemini 规划 …” → 等同 vibe-tools repo/plan …

  4. Agent 在本地执行对应 CLI，拿到结果后回到聊天窗口。

换句话说：Cursor IDE 提供执行命令的“插座”，cursor‑tools 把一排“多功能插头”插进去，让你的 AI 助手瞬间拥有更多本领。

核心要点

  • cursor‑tools 不是 Cursor 官方插件，更新节奏与官方独立；出现兼容问题时需关注其 GitHub activity。citeturn0search2
  • Cursor IDE 本身就有部分“Web 搜索”“Repo 分析”功能，但 cursor‑tools 针对 大上下文 (2 M tokens)、多模型选择、浏览器控制、GitHub 深度集成 等场景做了更强化的定制。citeturn0search1turn0search2
  • 安装 cursor‑tools 不会替换 Cursor 原生能力，而是 并排共存；你可以自由选择用官方指令还是 “vibe” 指令。

如需快速体验，只要在 Cursor IDE Composer 对话里输入：

“请用 Perplexity 查看 TypeScript 5.7 的新特性”

Cursor 会自动触发 vibe-tools web …，并把检索结果返回给你。

avatar
文章
阅读
粉丝