Get VIBES Running in 5 Minutes

Add AI transparency to your workflow — track every line of code AI writes and every decision agents make. Pick your tool, install, and you're done.

Step 1: Install VibeCheck

VibeCheck is the validator, reporter, and attestation tool for the VIBES ecosystem. It validates your .ai-audit/ data, generates reports, signs cryptographic attestations, and computes risk scores.

🛠

VibeCheck CLI

Available

Fast Rust binary. Validates VIBES data, generates reports, signs attestations, and scores risk. Clone the repo and build with Cargo.

View on GitHub

Then run vibecheck init in any project to bootstrap a .ai-audit/ directory.

Step 2: Add VIBES to Your AI Tool

VibeCheck validates and reports on VIBES data, but it doesn't generate that data. To produce .ai-audit/ records automatically, you need a VIBES integration for the AI tool you use. Each tool requires its own integration, installed separately.

💻

ClaudeCode-VIBES

Coming Soon

A hook for Claude Code that automatically generates .ai-audit/ data as you work. Records code, decisions, and reasoning.

Gemini-CLI-VIBES

Coming Soon

A VIBES integration for Google Gemini CLI. Tracks model variants, tool use, and file modifications with automatic annotations.

🤖

Codex-VIBES

Coming Soon

A VIBES plugin for OpenAI Codex CLI. Records AI provenance, sandbox execution, and shell commands alongside code changes.

🚧

Cursor / Windsurf / Copilot

Coming Soon

Instrumentation for IDE-integrated tools is in development. Join the waitlist to be notified when support ships.

Don't see your tool? Check the full tooling page for the latest support, or ask your provider to add native VIBES support. Tool builders can use the Implementors Guide to add VIBES in hours.

Or Use Maestro

Want the full VIBES ecosystem without any setup? Maestro comes with everything built in — tracking for code and agent decisions, verification, risk scoring, and governance — ready out of the box.

Maestro — The Easiest Way to Start

Maestro is a full implementation of the VIBES ecosystem. No manual instrumentation, no configuration — just start working and everything gets tracked automatically. Code generation, agent decisions, delegation chains — all of it.

VIBES VERIFY PRISM EVOLVE

Full audit trail + cryptographic signing + risk scoring + agent governance

Get started at runmaestro.ai →

What Happens Next

Once your AI tool has a VIBES integration installed (or you're using Maestro), here's what happens in your project.

1

A .ai-audit/ folder appears in your project

This is where all VIBES data lives. It's a normal folder in your repository — committed to git, versioned alongside your code, and portable across any system. Run vibecheck init to bootstrap it, or let your tool's VIBES integration create it automatically.

2

Your AI tool records actions automatically

The VIBES integration in your AI tool records what it writes and what it was asked. When an agent makes a decision — approving a PR, scaling infrastructure, modifying a pipeline — the integration captures the decision and reasoning. No manual work required.

3

Validate and report with vibecheck

Run vibecheck verify to validate your audit data, or vibecheck --format html to see a visual summary of all AI involvement — which models touched which files, risk scores, and coverage statistics.

4

Attest and submit to the registry

Run vibecheck attest to cryptographically sign your audit data and submit it to the public registry. This proves your data hasn't been tampered with and creates a verifiable public record.

Add a Badge

Show that your project tracks AI involvement. Add a VIBES badge to your README — it tells contributors and users that every AI action in your project is recorded and auditable.

✅ VIBES Tracked

Add this to your README.md:

<!-- VIBES Badge --> [![VIBES Tracked](https://img.shields.io/badge/VIBES-tracked-00c8d4)](https://itsavibe.ai) # Or if your project is in the registry: [![VIBES Tracked](https://itsavibe.ai/api/badge/YOUR-PROJECT)](https://itsavibe.ai/registry)

See all badge options and customization → · Trust-tier attestation badges →

Spread the Word

VIBES gets stronger as more tools and teams adopt it. Here's how you can help make AI transparency the default — for code generation and agent operations alike.

Ready to Go?

You've got everything you need. Pick a path and start tracking what AI does in your workflow today.

Install VibeCheck

Install VibeCheck to validate, report on, and attest your VIBES audit data. Then add a VIBES integration for your AI tool when available.

Back to top →

Explore the Ecosystem

Learn how VERIFY, PRISM, and EVOLVE extend VIBES with signing, risk scoring, and agent governance.

The full ecosystem →

Try Maestro

Full VIBES ecosystem — VIBES, VERIFY, PRISM, and EVOLVE — built in and ready to go.

runmaestro.ai →

Want the full implementation guide? Read the Implementor’s Reference →