This project provides a CLI tool to augment AI coding agents with advanced skills like web research, code analysis, browser automation, and GitHub integration. It targets developers using AI assistants within IDEs like Cursor, Claude Code, and others, enabling more sophisticated agent teamwork and task execution.

How It Works

vibe-tools acts as a bridge between AI agents and external tools/APIs. It leverages large context window models like Gemini 2.0 for codebase analysis and Perplexity for web search. For browser automation, it integrates with Playwright. The CLI orchestrates these capabilities, allowing agents to execute commands like vibe-tools web for research or vibe-tools repo for code understanding, abstracting away the complexities of API calls and tool usage.

Quick Start & Requirements

• Install globally: npm install -g vibe-tools
• Run setup: vibe-tools install
• Requirements: Node.js 18+, Perplexity API key, Google Gemini API key.
• Optional for browser commands: OpenAI or Anthropic API key, Playwright (npm install playwright).
• Setup involves interactive configuration of API keys and IDE integration files.

Highlighted Details

• Leverages Gemini 2.0's 2 million token context window for full codebase analysis.
• Integrates Perplexity for reliable web search and research.
• Offers browser automation (Stagehand) via Playwright for testing and interaction.
• Supports GitHub integration for issue and PR management.
• Includes YouTube video analysis capabilities.

Maintenance & Community

• Sponsored by Vinta.app, Resoled.it, and iterate.com.
• Open to contributions via Pull Requests.

Licensing & Compatibility

• MIT License.
• Compatible with various AI coding environments and providers (OpenAI, Anthropic, Gemini, Perplexity, OpenRouter, xAI).

Limitations & Caveats

• Requires API keys for Perplexity and Google Gemini, which may incur costs beyond free tiers.
• Browser automation with --connect-to has limitations on wait commands and video recording.
• Gemini 2.0 experimental models are used by default, which are free but may change.