VibeRepo

Make any repo AI-agent-ready. One command.

VibeRepo is the Agent Context Protocol for any codebase. It detects your stack and generates the configuration files that AI agents need to understand your project — .cursorrules, CLAUDE.md, llms.txt, PROJECT_MAP.md, and more.

Stop vibecoding blind. Give your AI agent a map.

The Problem

AI agents (Cursor, Claude Code, Copilot) hallucinate and waste tokens because they lack a source of truth for:

• 📂 Repository structure — They don't know where files are or how they relate
• 🔧 Environmental tools — They can't see the filesystem or database without manual MCP setup
• 📏 Coding standards — They skip testing, linting, and your team's conventions

The Solution

npx viberepo-cli init

One command that:

1. Detects your stack (Next.js, Vite, Remix, Astro, Python, Go, Rust, and more)
2. Generates agent context files tailored to your project
3. Configures MCP servers in your IDE (optional)
4. Validates everything with a health check

Features

🔍 Smart Stack Detection

VibeRepo auto-detects your framework, language, package manager, ORM, and IDE:

| Category | Supported | |----------|-----------| | Frameworks | Next.js, Vite (React/Vue/Svelte), Remix, Astro, Nuxt, Angular | | Languages | TypeScript, JavaScript, Python, Go, Rust | | ORMs | Prisma, Drizzle, TypeORM, SQLAlchemy | | IDEs | Cursor, VS Code, Claude Code | | Package Managers | npm, pnpm, yarn, bun |

📄 Multi-Tool Agent Config

Generates for every AI tool simultaneously:

| File | For | Purpose | |------|-----|---------| | .cursorrules | Cursor | Stack-specific coding rules | | CLAUDE.md | Claude Code | Build commands & project context | | .github/copilot-instructions.md | GitHub Copilot | Coding standards | | ai-instructions.md | Any LLM | Universal fallback | | llms.txt | Standard | Project map in llms.txt format | | PROJECT_MAP.md | All agents | Auto-generated file tree with roles |

🔄 Living Project Map

PROJECT_MAP.md is auto-generated from your actual codebase — not maintained manually. Run viberepo sync to keep it fresh.

🔌 MCP Auto-Plumb

Automatically configures MCP servers in your IDE with one command. Backs up existing config before modifying.

🩺 Health Checks

viberepo-cli check

  ✅ Cursor Rules           exists
  ✅ Claude Config           exists
  ✅ PROJECT_MAP.md          in sync
  ⚠️  MCP servers            2/3 configured
  ✅ llms.txt                valid format
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
     Health Score: 92/100

Quick Start

Initialize any project

cd your-project
npx viberepo-cli init

Keep the map fresh

npx viberepo-cli sync

Configure MCP servers

npx viberepo-cli plumb

Check agent context health

npx viberepo-cli check

Commands

| Command | Description | |---------|-------------| | viberepo-cli init | Detect stack, generate agent context files | | viberepo-cli sync | Regenerate PROJECT_MAP.md and llms.txt from code | | viberepo-cli plumb | Auto-configure MCP servers in your IDE | | viberepo-cli check | Validate agent context health |

Options

viberepo-cli init [options]
  -y, --yes        Skip confirmation prompts
  --overwrite      Overwrite existing files

viberepo-cli plumb [options]
  -y, --yes        Skip confirmation prompts
  --ping           Validate MCP server connectivity

What Gets Generated

your-project/
├── .cursorrules              # Cursor AI rules (stack-specific)
├── CLAUDE.md                 # Claude Code context
├── ai-instructions.md        # Universal AI fallback
├── llms.txt                  # Standard project map
├── PROJECT_MAP.md            # Auto-generated file tree & architecture
├── .github/
│   ├── copilot-instructions.md
│   └── workflows/
│       └── ci.yml            # Lint + test CI pipeline
├── docs/
│   └── ai-context/
│       ├── architecture.md   # Architecture cheat sheet
│       ├── conventions.md    # Coding conventions
│       └── stack.md          # Tech stack reference
└── .viberepo/
    └── config.json           # VibeRepo metadata & checksums

Philosophy

1. Zero scaffolding — Works on any existing project. We don't generate app code.
2. Framework-agnostic — Detects and adapts to your stack automatically.
3. Multi-tool — No IDE lock-in. Generates for Cursor, Claude, Copilot, and generic LLMs.
4. Living context — sync keeps the map fresh. check validates health.
5. Non-destructive — Never overwrites files without --overwrite. Always backs up.

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT © VibeRepo Contributors