explaingit

eastlondoner/vibe-tools

4,764TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A CLI package that extends AI coding tools like Cursor with web search via Perplexity, full-codebase analysis via Gemini, browser automation via Stagehand, and GitHub and Linear integration.

Mindmap

mindmap
  root((vibe-tools))
    AI services
      Perplexity search
      Gemini codebase
      Stagehand browser
      OpenRouter models
    Skills added
      GitHub integration
      Linear task management
      Xcode support
      Doc generation
    Setup
      npm install
      API keys per service
    Works with
      Cursor
      Other AI editors
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Ask your Cursor assistant to search the web for current docs or library releases using Perplexity.

USE CASE 2

Have Gemini read your entire codebase at once to plan a complex refactor or generate documentation.

USE CASE 3

Automate browser testing by letting your AI agent click through your web app and take screenshots.

USE CASE 4

Read and write GitHub issues and pull requests directly from inside your AI coding environment.

Tech stack

TypeScriptNode.jsnpmPerplexity APIGemini APIOpenRouterStagehand

Getting it running

Difficulty · moderate Time to first run · 30min

Requires separate API keys for each service you want to use: Perplexity, Google Gemini, and/or OpenRouter.

License not specified in the explanation.

In plain English

vibe-tools is a command-line package that extends AI coding tools like Cursor by giving them access to a set of specialized AI services. The idea is that instead of relying on a single AI model for every task, your coding assistant can delegate to whichever tool is best suited for a specific job. The README calls this concept an "AI team." The team consists of a few different services. Perplexity handles web search and research, pulling in current information from the internet that a coding assistant would not otherwise have access to. Google's Gemini model, which has a very large context window, is used for tasks that involve reading an entire codebase at once, such as planning a complex change or generating documentation. A library called Stagehand handles browser automation, letting the agent open web pages, click elements, extract content, and take screenshots to test or debug a web application. OpenRouter provides access to various other models through a single API, primarily for use with a protocol called MCP that allows AI tools to invoke external services. Beyond the AI team, vibe-tools adds several skills to a coding agent: reading and writing GitHub issues and pull requests, working with the Linear project management tool, generating documentation from source code, and interacting with Xcode for Apple development. Installing the package and configuring API keys for the services you want to use is the main setup step. Once installed, the agent can be instructed in plain English to use specific tools: for example, asking it to "use Perplexity to research the best way to do X" or "use Gemini to review the entire repository for Y." The project is designed primarily for developers using Cursor but also works with other AI coding environments. It is a TypeScript package distributed via npm. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Using vibe-tools with Cursor, help me set up Perplexity web search so my AI assistant can look up current npm package documentation.
Prompt 2
Configure vibe-tools so Gemini can review my entire Next.js repository and produce a refactoring plan.
Prompt 3
Show me how to use vibe-tools Stagehand to automate clicking through a login form and extracting the resulting dashboard content.
Prompt 4
Set up vibe-tools GitHub integration so my AI agent can read open issues and draft a pull-request description automatically.
Prompt 5
Help me connect vibe-tools to Linear so I can create and update project tasks from inside Cursor.
Open on GitHub → Explain another repo

← eastlondoner on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.