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

项目概览

vibe‑tools（原 cursor‑tools） 是一个为 Cursor Agent （或任何能执行命令的 AI 编程助手）扩展能力的 CLI 工具包。

安装后，你的 AI 助手可以即时调用一整支"AI 团队"来做 检索、代码审查、浏览器自动化、GitHub 操作、文档生成、YouTube 视频分析 等工作。

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

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

erlang 复制代码

vibe-tools install .

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

环境	生成的规则文件
Cursor	`.cursor/rules/vibe-tools.mdc` 或旧 `.cursorrules`
Claude Code	`CLAUDE.md`
Windsurf	`.windsurfrules`
Cline / Roo	`.clinerules/vibe-tools.md`
Codex	`codex.md`

组件	最低版本
Node.js	18+
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`
`xcode`	iOS 项目构建 / 运行 / Lint	`vibe-tools xcode build`

昵称规则

"Gemini " = vibe-tools repo

"Perplexity " = vibe-tools web

"Stagehand " = vibe-tools browser

浏览器自动化测试

bash 复制代码

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

生成依赖库文档

css 复制代码

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

分析 YouTube 技术教程

bash 复制代码

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

vibe-tools.config.json

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

认证方式

服务	认证变量 / 文件
Perplexity	`PERPLEXITY_API_KEY`
Gemini	`GEMINI_API_KEY`（支持 API Key / 服务账号 JSON / ADC）
OpenAI	`OPENAI_API_KEY`（可选）
Anthropic	`ANTHROPIC_API_KEY`（可选）
GitHub	`GITHUB_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 IDE	cursor‑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 IDE	Cursor、Claude Code、Windsurf 等多种 AI‑IDE，甚至纯命令行

全局安装 npm i -g vibe-tools，再执行 vibe-tools install .。
安装脚本会在项目或用户目录写入 Cursor 规则文件 （.cursor/rules/vibe-tools.mdc 或旧版 .cursorrules）。
Cursor Agent 读取这些规则后，你只需在对话里说：
- "让 Perplexity 搜一下 ..." → 等同 vibe-tools web ...
- "让 Gemini 规划 ..." → 等同 vibe-tools repo/plan ...
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 ...，并把检索结果返回给你。