{"_id":"viberepo-cli","_rev":"2-b439052468ab41629e8f211eb7a96a28","name":"viberepo-cli","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"viberepo-cli","version":"0.1.0","keywords":["ai","cursor","claude","copilot","llm","mcp","vibecoding","developer-tools","cli","agent","cursorrules","llms-txt"],"author":"","license":"MIT","_id":"viberepo-cli@0.1.0","maintainers":[{"name":"kk5190krrish","email":"kk5190krrish@gmail.com"}],"homepage":"https://github.com/user/viberepo#readme","bugs":{"url":"https://github.com/user/viberepo/issues"},"bin":{"viberepo":"dist/index.js"},"dist":{"shasum":"cbb5d0295ed118540c64df86ad6feff17b42796d","tarball":"https://registry.npmjs.org/viberepo-cli/-/viberepo-cli-0.1.0.tgz","fileCount":5,"integrity":"sha512-Q3ZHP2mZfDCJyYwdR3HmTk5sn6/56PM1JWM/BsOiZ6yuOEKSyfp+5mJlsyjO+Vrazai0QdtTCNI7Mn/RriKj3w==","signatures":[{"sig":"MEYCIQCjDHdfwtiScveipaqD+xk+IVae3fP4kUqsQibtqvcESwIhAIcllTGfpcB6NDCHo3MjQs/u777hbXSRMzMkefvM8GeL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184165},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"59e95ef07534580e04b79c155df6f52c30e338a1","scripts":{"dev":"tsup --watch","lint":"biome check .","test":"vitest run","build":"tsup","start":"node dist/index.js","format":"biome format --write .","release":"changeset publish","lint:fix":"biome check --write .","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"kk5190krrish","email":"kk5190krrish@gmail.com"},"repository":{"url":"git+https://github.com/user/viberepo.git","type":"git"},"_npmVersion":"10.9.4","description":"Make any repo AI-agent-ready. One command.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"ora":"^8.1.0","glob":"^11.0.0","chalk":"^5.3.0","ignore":"^7.0.0","fs-extra":"^11.2.0","commander":"^13.0.0","@inquirer/prompts":"^7.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0","@biomejs/biome":"^2.4.6","@changesets/cli":"^2.30.0","@types/fs-extra":"^11.0.4"},"_npmOperationalInternal":{"tmp":"tmp/viberepo-cli_0.1.0_1772907636829_0.22966892006731054","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"viberepo-cli","version":"0.1.1","description":"Make any repo AI-agent-ready. One command.","type":"module","bin":{"viberepo":"dist/index.js"},"scripts":{"build":"tsup","dev":"tsup --watch","start":"node dist/index.js","typecheck":"tsc --noEmit","lint":"biome check .","lint:fix":"biome check --write .","format":"biome format --write .","test":"vitest run","test:watch":"vitest","release":"changeset publish","prepublishOnly":"npm run build"},"keywords":["ai","cursor","claude","copilot","llm","mcp","vibecoding","developer-tools","cli","agent","cursorrules","llms-txt"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/user/viberepo.git"},"engines":{"node":">=18.0.0"},"dependencies":{"@inquirer/prompts":"^7.0.0","chalk":"^5.3.0","commander":"^13.0.0","fs-extra":"^11.2.0","glob":"^11.0.0","ignore":"^7.0.0","ora":"^8.1.0"},"devDependencies":{"@biomejs/biome":"^2.4.6","@changesets/cli":"^2.30.0","@types/fs-extra":"^11.0.4","@types/node":"^22.0.0","tsup":"^8.3.0","typescript":"^5.7.0","vitest":"^3.0.0"},"_id":"viberepo-cli@0.1.1","gitHead":"6ec352a38c2fc02ffe4e18d3e589c9ab4e548237","bugs":{"url":"https://github.com/user/viberepo/issues"},"homepage":"https://github.com/user/viberepo#readme","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-CBKcCA+9bRPVz/vn92UxAX6+5YxnsseSlQPfUV0hao9Y5mSmxb0NeHGSq4dhUatBY1kQnoD3DHj5LP6glM8D6g==","shasum":"b85b55d35bef4bd640f4d0bc7b2f4fa0156cb03d","tarball":"https://registry.npmjs.org/viberepo-cli/-/viberepo-cli-0.1.1.tgz","fileCount":5,"unpackedSize":184213,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDnBYBbpoG9rTqAEKU1kkpSc5lrlzzaQ2nR9OblUwEsQAIhANERlf4peOT1QqzxYdEhBihhY4qL2+8p+101kojz2QLT"}]},"_npmUser":{"name":"kk5190krrish","email":"kk5190krrish@gmail.com"},"directories":{},"maintainers":[{"name":"kk5190krrish","email":"kk5190krrish@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/viberepo-cli_0.1.1_1772908136806_0.35493546790262265"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-07T18:20:36.828Z","modified":"2026-03-07T18:28:57.044Z","0.1.0":"2026-03-07T18:20:36.983Z","0.1.1":"2026-03-07T18:28:56.943Z"},"bugs":{"url":"https://github.com/user/viberepo/issues"},"license":"MIT","homepage":"https://github.com/user/viberepo#readme","keywords":["ai","cursor","claude","copilot","llm","mcp","vibecoding","developer-tools","cli","agent","cursorrules","llms-txt"],"repository":{"type":"git","url":"git+https://github.com/user/viberepo.git"},"description":"Make any repo AI-agent-ready. One command.","maintainers":[{"name":"kk5190krrish","email":"kk5190krrish@gmail.com"}],"readme":"# VibeRepo\n\n**Make any repo AI-agent-ready. One command.**\n\n[![npm version](https://img.shields.io/npm/v/viberepo.svg)](https://www.npmjs.com/package/viberepo)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nVibeRepo 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.\n\n> **Stop vibecoding blind.** Give your AI agent a map.\n\n## The Problem\n\nAI agents (Cursor, Claude Code, Copilot) hallucinate and waste tokens because they lack a **source of truth** for:\n\n- 📂 **Repository structure** — They don't know where files are or how they relate\n- 🔧 **Environmental tools** — They can't see the filesystem or database without manual MCP setup\n- 📏 **Coding standards** — They skip testing, linting, and your team's conventions\n\n## The Solution\n\n```bash\nnpx viberepo-cli init\n```\n\nOne command that:\n\n1. **Detects** your stack (Next.js, Vite, Remix, Astro, Python, Go, Rust, and more)\n2. **Generates** agent context files tailored to your project\n3. **Configures** MCP servers in your IDE (optional)\n4. **Validates** everything with a health check\n\n## Features\n\n### 🔍 Smart Stack Detection\n\nVibeRepo auto-detects your framework, language, package manager, ORM, and IDE:\n\n| Category | Supported |\n|----------|-----------|\n| **Frameworks** | Next.js, Vite (React/Vue/Svelte), Remix, Astro, Nuxt, Angular |\n| **Languages** | TypeScript, JavaScript, Python, Go, Rust |\n| **ORMs** | Prisma, Drizzle, TypeORM, SQLAlchemy |\n| **IDEs** | Cursor, VS Code, Claude Code |\n| **Package Managers** | npm, pnpm, yarn, bun |\n\n### 📄 Multi-Tool Agent Config\n\nGenerates for **every** AI tool simultaneously:\n\n| File | For | Purpose |\n|------|-----|---------|\n| `.cursorrules` | Cursor | Stack-specific coding rules |\n| `CLAUDE.md` | Claude Code | Build commands & project context |\n| `.github/copilot-instructions.md` | GitHub Copilot | Coding standards |\n| `ai-instructions.md` | Any LLM | Universal fallback |\n| `llms.txt` | Standard | Project map in llms.txt format |\n| `PROJECT_MAP.md` | All agents | Auto-generated file tree with roles |\n\n### 🔄 Living Project Map\n\n`PROJECT_MAP.md` is **auto-generated from your actual codebase** — not maintained manually. Run `viberepo sync` to keep it fresh.\n\n### 🔌 MCP Auto-Plumb\n\nAutomatically configures MCP servers in your IDE with one command. Backs up existing config before modifying.\n\n### 🩺 Health Checks\n\n```\nviberepo-cli check\n\n  ✅ Cursor Rules           exists\n  ✅ Claude Config           exists\n  ✅ PROJECT_MAP.md          in sync\n  ⚠️  MCP servers            2/3 configured\n  ✅ llms.txt                valid format\n  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n     Health Score: 92/100\n```\n\n## Quick Start\n\n### Initialize any project\n\n```bash\ncd your-project\nnpx viberepo-cli init\n```\n\n### Keep the map fresh\n\n```bash\nnpx viberepo-cli sync\n```\n\n### Configure MCP servers\n\n```bash\nnpx viberepo-cli plumb\n```\n\n### Check agent context health\n\n```bash\nnpx viberepo-cli check\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `viberepo-cli init` | Detect stack, generate agent context files |\n| `viberepo-cli sync` | Regenerate `PROJECT_MAP.md` and `llms.txt` from code |\n| `viberepo-cli plumb` | Auto-configure MCP servers in your IDE |\n| `viberepo-cli check` | Validate agent context health |\n\n### Options\n\n```\nviberepo-cli init [options]\n  -y, --yes        Skip confirmation prompts\n  --overwrite      Overwrite existing files\n\nviberepo-cli plumb [options]\n  -y, --yes        Skip confirmation prompts\n  --ping           Validate MCP server connectivity\n```\n\n## What Gets Generated\n\n```\nyour-project/\n├── .cursorrules              # Cursor AI rules (stack-specific)\n├── CLAUDE.md                 # Claude Code context\n├── ai-instructions.md        # Universal AI fallback\n├── llms.txt                  # Standard project map\n├── PROJECT_MAP.md            # Auto-generated file tree & architecture\n├── .github/\n│   ├── copilot-instructions.md\n│   └── workflows/\n│       └── ci.yml            # Lint + test CI pipeline\n├── docs/\n│   └── ai-context/\n│       ├── architecture.md   # Architecture cheat sheet\n│       ├── conventions.md    # Coding conventions\n│       └── stack.md          # Tech stack reference\n└── .viberepo/\n    └── config.json           # VibeRepo metadata & checksums\n```\n\n## Philosophy\n\n1. **Zero scaffolding** — Works on any existing project. We don't generate app code.\n2. **Framework-agnostic** — Detects and adapts to your stack automatically.\n3. **Multi-tool** — No IDE lock-in. Generates for Cursor, Claude, Copilot, and generic LLMs.\n4. **Living context** — `sync` keeps the map fresh. `check` validates health.\n5. **Non-destructive** — Never overwrites files without `--overwrite`. Always backs up.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nMIT © VibeRepo Contributors\n","readmeFilename":"README.md"}