vibe-tools: Instructions file for Codex

This is the vibe-tools repo. Here we build a cli tool that AI agents can use to execute commands and work with other AI agents.

This repo uses pnpm as the package manager and script runner.

use pnpm dev to run dev commands.

We add AI "teammates" as commands that can be asked questions. We add "skills" as commands that can be used to execute tasks.

Everything is implemented as a cli command that must return a result (cannot be a long running process).

The released commands are documented below. You can use the released commands as tools when we are building vibe-tools, in fact you should use them as often and enthusastically as possible (how cool is that!)

Don't ask me for permission to do stuff - if you have questions work with Gemini and Perplexity to decide what to do: they're your teammates. You're a team of superhuman expert AIs, believe in yourselves! Don't corners or get lazy, do your work thoroughly and completely and you don't need to ask permission.

We do not do automated unit tests or integration tests - it's trivial to manually test all the commmands by just asking cursor agent to read the readme and test all the commands.

console.log should be used for "meta" information that is of use to the caller but isn't a core part of the results that were requested. E.g. recording which model is being used to perfom an action.

console.error should be used for error messages.

yield should be used for the output of the command that contains the information that was requested. </logging and outputs>

Usage:

1. Run with: pnpm serve-test
2. Server starts at http://localhost:3000
3. Place test HTML files in tests/commands/browser/
4. Access files at http://localhost:3000/filename.html

remember that this will be a long running process that does not exit so you should run it in a separate background terminal.

If it won't start because the port is busy run lsof -i :3000 | grep LISTEN | awk '{print $2}' | xargs kill to kill the process and free the port.

to run test commands with latest code use pnpm dev browser <commands>

For interactive debugging start chrome in debug mode using:

open -a "Google Chrome" --args --remote-debugging-port=9222 --no-first-run --no-default-browser-check --user-data-dir="/tmp/chrome-remote-debugging"

note: this command will exit as soon as chrome is open so you can just execute it, it doesn't need to be run in a background task. </testing browser commands>

---

description: Global Rule. This rule should ALWAYS be loaded globs: ,**/ alwaysApply: true

---

description: Global Rule. This rule should ALWAYS be loaded. globs: ,**/ alwaysApply: true

vibe-tools is a CLI tool that allows you to interact with AI models and other tools. vibe-tools is installed on this machine and it is available to you to execute. You're encouraged to use it.

Direct Model Queries: vibe-tools ask "<your question>" --provider <provider> --model <model> - Ask any model from any provider a direct question (e.g., vibe-tools ask "What is the capital of France?" --provider openai --model o3-mini). Note that this command is generally less useful than other commands like repo or plan because it does not include any context from your codebase or repository. In general you should not use the ask command because it does not include any context. The other commands like web, doc, repo, or plan are usually better. If you are using it, make sure to include in your question all the information and context that the model might need to answer usefully.