vibe-tools
Give Cursor Agent an AI Team and Advanced Skills
vibe-tools is an agent skill that equips AI coding assistants with an AI team and advanced capabilities through a globally-installed CLI. It enables agents to delegate tasks to specialized AI models: Perplexity for web research, Gemini 2.0 for whole-codebase analysis with massive context windows, and Stagehand for browser automation. Designed for Cursor Composer Agent, Claude Code, Codex, Windsurf, Cline, and Roo, it automatically configures IDE instruction files and provides commands for GitHub/Linear integration, documentation generation, YouTube video analysis, and Xcode automation.
Key Features
Use Cases
- 01Delegate web research to Perplexity to find current library documentation and API usage patterns
- 02Use Gemini to review entire codebases and generate implementation plans with full context awareness
- 03Automate browser testing and debugging with Stagehand to validate form behavior and capture console errors
- 04Fetch GitHub issues and pull requests with code review comments to understand feature requests or bugs
- 05Generate local documentation for external dependencies so agents can reference APIs without web search
- 06Analyze YouTube tutorial videos to extract implementation steps and code examples without watching
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
vibe-tools — FAQ
What is vibe-tools?+
vibe-tools is a globally-installed Node.js CLI that extends AI coding agents with an AI team (Perplexity, Gemini, Stagehand) and skills like browser automation, repository analysis, GitHub/Linear integration, and documentation generation. It works with Cursor, Claude Code, Codex, Windsurf, Cline, and Roo by automatically configuring their instruction files.
How do I install vibe-tools?+
Install globally with npm install -g vibe-tools, then run vibe-tools install . in your project directory. The installer will guide you through API key configuration, install Playwright browsers, and create IDE-specific instruction files like .cursorrules or CLAUDE.md.
Which AI clients work with vibe-tools?+
vibe-tools supports Cursor Composer Agent, Claude Code, Codex, Windsurf, Cline, and Roo. It automatically detects your IDE during installation and configures the appropriate instruction files for that environment.
What API keys does vibe-tools require?+
Required: Perplexity API key and Google Gemini API key. Optional: OpenAI or Anthropic for browser automation commands, GitHub token for private repos, Linear API key for issue integration, and OpenRouter/xAI/Groq for additional model access.
Is vibe-tools free to use?+
The vibe-tools package itself is free and MIT-licensed. However, you need API keys from third-party services: Gemini models are currently free on Google AI with generous limits, Perplexity Pro users get $5/month free credits, and other providers have their own pricing.
How does the agent use vibe-tools commands?+
After installation, your AI agent can execute commands like vibe-tools web for web search, vibe-tools repo for codebase analysis, or vibe-tools browser for automation. You can use natural language like 'ask Perplexity' or 'use Gemini' and the agent will translate to the appropriate command.
How do I install vibe-tools?+
Open the source repository on GitHub and follow its README. vibe-tools is a skill — MCP Agents Market links you directly to the official repo.
Is vibe-tools free?+
vibe-tools is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.