vibe-tools: Empowering AI Agents with Teams and Advanced Skills

Summary

vibe-tools is a powerful CLI designed to enhance AI agents by providing them with an AI team and advanced skills. It integrates tools like Perplexity for web research, Gemini for repository context, and Stagehand for browser automation. Optimized for Cursor Composer Agent, vibe-tools can be utilized by any coding agent capable of executing commands.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Introduction

vibe-tools is a powerful Command Line Interface (CLI) designed to give your AI agents an AI team and advanced skills. It significantly expands the capabilities of coding agents, making them more versatile and efficient. Optimized for Cursor Composer Agent, vibe-tools is also compatible with any coding agent that can execute commands.

At its core, vibe-tools integrates a specialized AI team:

Perplexity: For comprehensive web search and deep research.
Gemini 2.0: Offers vast whole-codebase context, search grounding, and advanced reasoning for planning.
Stagehand: Enables robust browser automation for testing and debugging web applications.

Beyond the core team, vibe-tools provides new skills for your existing agent, including working with GitHub Issues and Pull Requests, accessing Linear issues with full context, generating local documentation for external dependencies, and analyzing YouTube videos to extract insights and implementation plans. Written in TypeScript, vibe-tools is a globally installable Node.js package.

Installation

Getting started with vibe-tools is straightforward. First, install the package globally using npm:

npm install -g vibe-tools

After installation, run the setup command in your project directory:

vibe-tools install .

This command will guide you through configuring API keys for your chosen AI providers, automatically install necessary Playwright browsers for browser automation, and set up AI instruction files tailored to your development environment (e.g., for Cursor, Claude Code, or Windsurf). For CI/CD environments, vibe-tools supports non-interactive installation by setting CI=true or NONINTERACTIVE=true.

Examples

vibe-tools empowers your AI agent with a wide array of commands. Here are a few examples demonstrating its versatility:

Web Search with Perplexity:

"Please implement country specific stripe payment pages for the USA, UK, France and Germany. Use vibe-tools web to check the available stripe payment methods in each country."

Repository Context and Planning with Gemini:

"Let's refactor our User class to allow multiple email aliases per user. Use vibe-tools repo to ask for a plan including a list of all files that need to be changed."

Browser Automation with Stagehand:

"Use vibe-tools to open the users page and check the error in the console logs, fix it"

Documentation Generation:

"Use vibe-tools to generate documentation for the Github repo https://github.com/kait-http/kaito and write it to docs/kaito.md"

YouTube Video Analysis:

"Generate a comprehensive summary of a technical talk vibe-tools youtube 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' --type=summary"

Why Use vibe-tools?

vibe-tools stands out by transforming your AI coding agent into a more capable and autonomous entity. By providing access to specialized AI models for web research, deep codebase understanding, and browser interaction, it significantly streamlines complex development workflows. Whether you need to quickly research new technologies, plan large refactors, automate web testing, or generate documentation, vibe-tools equips your agent with the necessary intelligence and tools. Its broad compatibility with various AI-powered IDEs and environments ensures a seamless integration into your existing setup, ultimately boosting productivity and accelerating development cycles.