{"id":30677175,"url":"https://github.com/entro314-labs/vdk-cli","last_synced_at":"2026-01-20T17:03:09.566Z","repository":{"id":306868177,"uuid":"1019631572","full_name":"entro314-labs/VDK-CLI","owner":"entro314-labs","description":"The world's first Vibe Development Kit - Train any AI coding assistant to understand your project like a senior developer who's been on your team for years.","archived":false,"fork":false,"pushed_at":"2025-08-31T16:13:59.000Z","size":9565,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-31T18:23:34.438Z","etag":null,"topics":["ai-rule","automation","claude-code","cli","code-analysis","context-aware","cursor","developer-tools","github-copilot","productivity","slash-commands","vdk","vibe-coding","vibe-development-kit","vibecoding","vscode","windsurf"],"latest_commit_sha":null,"homepage":"https://vdk.tools","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/entro314-labs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORTED_IDES_AND_AI_TOOLS.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"TheSethRose"}},"created_at":"2025-07-14T16:16:58.000Z","updated_at":"2025-08-11T21:22:21.000Z","dependencies_parsed_at":"2025-08-31T18:20:00.847Z","dependency_job_id":null,"html_url":"https://github.com/entro314-labs/VDK-CLI","commit_stats":null,"previous_names":["entro314-labs/vdk-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/entro314-labs/VDK-CLI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entro314-labs%2FVDK-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entro314-labs%2FVDK-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entro314-labs%2FVDK-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entro314-labs%2FVDK-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/entro314-labs","download_url":"https://codeload.github.com/entro314-labs/VDK-CLI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entro314-labs%2FVDK-CLI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273114756,"owners_count":25048253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-rule","automation","claude-code","cli","code-analysis","context-aware","cursor","developer-tools","github-copilot","productivity","slash-commands","vdk","vibe-coding","vibe-development-kit","vibecoding","vscode","windsurf"],"created_at":"2025-09-01T11:34:38.083Z","updated_at":"2026-01-20T17:03:09.535Z","avatar_url":"https://github.com/entro314-labs.png","language":"JavaScript","funding_links":["https://github.com/sponsors/TheSethRose"],"categories":[],"sub_categories":[],"readme":"# VibeKit VDK CLI\n\n\u003cdiv align=\"center\"\u003e\n\n![NPM](https://img.shields.io/badge/NPM-%23CB3837.svg?style=for-the-badge\u0026logo=npm\u0026logoColor=white)\n![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge\u0026logo=node.js\u0026logoColor=white)\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)\n\n[![npm version](https://img.shields.io/npm/v/@vibe-dev-kit/cli?style=flat-square\u0026logo=npm)](https://www.npmjs.com/package/@vibe-dev-kit/cli)\n[![Downloads](https://img.shields.io/npm/dm/@vibe-dev-kit/cli?style=flat-square\u0026logo=npm)](https://www.npmjs.com/package/@vibe-dev-kit/cli)\n[![GitHub Repo stars](https://img.shields.io/github/stars/entro314-labs/VibeKit-VDK-CLI?style=flat-square\u0026logo=github)](https://github.com/entro314-labs/VibeKit-VDK-CLI)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003csvg width=\"64\" height=\"64\" viewBox=\"0 0 64 64\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003crect width=\"64\" height=\"64\" rx=\"12\" fill=\"#6366F1\"/\u003e\n\u003cpath d=\"M16 20h32v4H16v-4zm0 8h24v4H16v-4zm0 8h28v4H16v-4z\" fill=\"white\"/\u003e\n\u003ccircle cx=\"48\" cy=\"44\" r=\"8\" fill=\"#10B981\"/\u003e\n\u003cpath d=\"M44 44l3 3 5-5\" stroke=\"white\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/\u003e\n\u003c/svg\u003e\n\n**Stop Training Your AI Assistant Every Day**\n\nThe world's first Vibe Development Kit - Train any AI coding assistant to understand your project like a senior developer who's been on your team for years.\n\n\u003c/div\u003e\n\nVDK CLI revolutionizes AI-assisted development by generating intelligent rules that make AI suggestions 60% faster and perfectly matched to your codebase patterns. This tool helps developers create project-aware AI assistants and provides seamless integration across all major coding platforms.\n\n## Demo\n\n\u003cdiv align=\"center\"\u003e\n\n### Interactive Setup \u0026 Features\n\n![VDK CLI Interactive Demo](docs/media/demo-interactive.gif)\n\n### Quick Start Workflow\n\n![VDK CLI Quick Demo](docs/media/demo-quick-real.gif)\n\n\u003c/div\u003e\n\n## Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"50%\"\u003e\n\n\u003csvg width=\"40\" height=\"40\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z\" fill=\"#6366F1\"/\u003e\n\u003c/svg\u003e\n\n**Intelligent Project Analysis**\nAutomatically detects 20+ technologies, frameworks, and architectural patterns in your codebase\n\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"50%\"\u003e\n\n\u003csvg width=\"40\" height=\"40\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M12 1L3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5l-9-4z\" fill=\"#10B981\"/\u003e\n\u003c/svg\u003e\n\n**Universal AI Compatibility**\nWorks with 33+ IDEs and AI tools: Claude Code, Cursor, VS Code variants, Windsurf, all JetBrains IDEs, Zed, GitHub Copilot, and more\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\n\u003csvg width=\"40\" height=\"40\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6z\" fill=\"#8B5CF6\"/\u003e\n\u003cpath d=\"M14 2v6h6\" fill=\"none\" stroke=\"white\" stroke-width=\"2\"/\u003e\n\u003c/svg\u003e\n\n**Smart Rule Generation**\nCreates tailored MDC files with project-specific patterns, conventions, and best practices\n\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\n\u003csvg width=\"40\" height=\"40\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003ccircle cx=\"12\" cy=\"12\" r=\"3\" fill=\"#F59E0B\"/\u003e\n\u003cpath d=\"M12 1v6m0 6v6m11-7h-6m-6 0H1\" stroke=\"#F59E0B\" stroke-width=\"2\"/\u003e\n\u003c/svg\u003e\n\n**5-Minute Setup**\nZero configuration required - instant value with automatic project detection and rule deployment\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## Quick Start\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M4 12l1.41 1.41L11 7.83V20h2V7.83l5.58 5.59L20 12l-8-8-8 8z\" fill=\"#059669\"/\u003e\n\u003c/svg\u003e\n\n### Installation\n\n```bash\n# Install globally\nnpm install -g @vibe-dev-kit/cli\n\n# Or use with pnpm\npnpm add -g @vibe-dev-kit/cli\n\n# Or use the installer script\ncurl -fsSL https://raw.githubusercontent.com/entro314-labs/VibeKit-VDK-CLI/main/install.sh | sh\n```\n\n### Basic Usage\n\n```bash\n# Initialize in your project\ncd your-project\nvdk init\n\n# Interactive mode with guided setup\nvdk init --interactive\n\n# Check what VDK detected\nvdk status\n```\n\nThat's it! Your AI assistant now understands your project's patterns and conventions.\n\n## How It Works\n\n1. **Project Analysis**: Scans your codebase to detect technologies, frameworks, and architectural patterns\n2. **Pattern Recognition**: Identifies naming conventions, code structures, and project-specific practices\n3. **Rule Generation**: Creates customized MDC files with intelligent guidelines for your tech stack\n4. **AI Integration**: Deploys rules to your preferred AI assistant's configuration directory\n\n## Migration System\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z\" fill=\"#8B5CF6\"/\u003e\n\u003c/svg\u003e\n\nVDK CLI includes intelligent migration capabilities to convert your existing AI contexts from various platforms to VDK's universal format:\n\n### Supported Migration Sources\n- **Claude Code** - CLAUDE.md files and .claude/ directories  \n- **Cursor** - .cursorrules and .cursor/ configurations\n- **GitHub Copilot** - .github/copilot-instructions.md and related files\n- **Windsurf** - .windsurf/ rules and configurations\n- **Generic AI** - Various AI assistant rule formats\n\n### Migration Process\n1. **Detection**: Automatically identifies existing AI contexts in your project\n2. **Analysis**: Evaluates confidence levels and categorizes found contexts  \n3. **Conversion**: Transforms contexts to VDK blueprint format with project-specific adaptations\n4. **Organization**: Creates structured migration output in `vdk-migration/` folder\n5. **Integration**: Optionally deploys converted rules to your configured AI assistants\n\n### Migration Commands\n```bash\n# Migrate existing AI contexts\nvdk migrate\n\n# Preview what would be migrated (no files created)  \nvdk migrate --dry-run\n\n# Migrate without deploying to IDE integrations\nvdk migrate --no-deploy\n\n# Check for existing AI contexts before migrating\nvdk status\n```\n\nThe migration system leverages VDK's existing architecture (scanners, adapters, generators) to ensure converted rules maintain the same quality and project-awareness as newly generated ones.\n\n## Supported Technologies\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\n\u003csvg width=\"32\" height=\"32\" viewBox=\"0 0 24 24\" fill=\"#61DAFB\"\u003e\n\u003cpath d=\"M12 10.11c1.03 0 1.87.84 1.87 1.89s-.84 1.85-1.87 1.85-1.87-.82-1.87-1.85.84-1.89 1.87-1.89M7.37 20c.63.38 2.01-.2 3.6-1.7-.52-.59-1.03-1.23-1.51-1.9a22.7 22.7 0 0 1-2.4-.36c-.51 2.14-.32 3.61.31 3.96m.71-5.74l-.29-.51c-.11.29-.22.58-.29.86.27.06.57.11.88.16l-.3-.51m6.54-.76l.81-1.5-.81-1.5c-.3-.53-.62-1-.91-1.47C13.17 9 12.6 9 12 9s-1.17 0-1.71.03c-.29.47-.61.94-.91 1.47L8.57 12l.81 1.5c.3.53.62 1 .91 1.47.54.03 1.11.03 1.71.03s1.17 0 1.71-.03c.29-.47.61-.94.91-1.47M12 6.78c-.19.22-.39.45-.59.72h1.18c-.2-.27-.4-.5-.59-.72m0 10.44c.19-.22.39-.45.59-.72h-1.18c.2.27.4.5.59.72M16.62 4c-.62-.38-2 .2-3.59 1.7.52.59 1.03 1.23 1.51 1.9.82.08 1.63.2 2.4.36.51-2.14.32-3.61-.32-3.96m-.7 5.74l.29.51c.11-.29.22-.58.29-.86-.27-.06-.57-.11-.88-.16l.3.51m1.45-7.05c1.47.84 1.63 3.05 1.01 5.63 2.54.75 4.37 1.99 4.37 3.68s-1.83 2.93-4.37 3.68c.62 2.58.46 4.79-1.01 5.63-1.46.84-3.45-.12-5.37-1.95-1.92 1.83-3.91 2.79-5.37 1.95-1.47-.84-1.63-3.05-1.01-5.63-2.54-.75-4.37-1.99-4.37-3.68s1.83-2.93 4.37-3.68c-.62-2.58-.46-4.79 1.01-5.63 1.46-.84 3.45.12 5.37 1.95 1.92-1.83 3.91-2.79 5.37-1.95\"/\u003e\n\u003c/svg\u003e\n\n**Frontend Frameworks**\n![React](https://img.shields.io/badge/react-%2320232a.svg?style=flat\u0026logo=react\u0026logoColor=%2361DAFB)\n![Vue.js](https://img.shields.io/badge/vuejs-%2335495e.svg?style=flat\u0026logo=vuedotjs\u0026logoColor=%234FC08D)\n![Angular](https://img.shields.io/badge/angular-%23DD0031.svg?style=flat\u0026logo=angular\u0026logoColor=white)\n![Next JS](https://img.shields.io/badge/Next-black?style=flat\u0026logo=next.js\u0026logoColor=white)\n![TailwindCSS](https://img.shields.io/badge/tailwindcss-%2338B2AC.svg?style=flat\u0026logo=tailwind-css\u0026logoColor=white)\n\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\n\u003csvg width=\"32\" height=\"32\" viewBox=\"0 0 24 24\" fill=\"#339933\"\u003e\n\u003cpath d=\"M12 1.85c-.27 0-.55.07-.78.2l-7.44 4.3c-.48.28-.78.8-.78 1.36v8.58c0 .56.3 1.08.78 1.36l7.44 4.3c.46.26 1.04.26 1.5 0l7.44-4.3c.48-.28.78-.8.78-1.36V7.71c0-.56-.3-1.08-.78-1.36l-7.44-4.3c-.23-.13-.51-.2-.78-.2zm0 2.03c.13 0 .27.04.39.11l6.9 4v.81L12 12.6 4.71 8.8v-.81l6.9-4c.12-.07.26-.11.39-.11zM5.05 9.85l6.95 4.01v7.79c-.13 0-.27-.04-.39-.11l-6.9-4c-.23-.13-.39-.39-.39-.68v-6.68c0-.11.02-.22.05-.33zm13.9 0c.03.11.05.22.05.33v6.68c0 .29-.16.55-.39.68l-6.9 4c-.12.07-.26.11-.39.11v-7.79l6.95-4.01z\"/\u003e\n\u003c/svg\u003e\n\n**Backend \u0026 Languages**\n![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=flat\u0026logo=node.js\u0026logoColor=white)\n![Express.js](https://img.shields.io/badge/express.js-%23404d59.svg?style=flat\u0026logo=express\u0026logoColor=%2361DAFB)\n![Python](https://img.shields.io/badge/python-3670A0?style=flat\u0026logo=python\u0026logoColor=ffdd54)\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=flat\u0026logo=typescript\u0026logoColor=white)\n![Go](https://img.shields.io/badge/go-%2300ADD8.svg?style=flat\u0026logo=go\u0026logoColor=white)\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\n\u003csvg width=\"32\" height=\"32\" viewBox=\"0 0 24 24\" fill=\"#3178C6\"\u003e\n\u003cpath d=\"M1.125 0C.502 0 0 .502 0 1.125v21.75C0 23.498.502 24 1.125 24h21.75c.623 0 1.125-.502 1.125-1.125V1.125C24 .502 23.498 0 22.875 0zm17.363 9.75c.612 0 1.154.037 1.627.111a6.38 6.38 0 0 1 1.306.34v2.458a3.95 3.95 0 0 0-.643-.361 5.093 5.093 0 0 0-.717-.26 5.453 5.453 0 0 0-1.426-.2c-.3 0-.573.028-.819.086a2.1 2.1 0 0 0-.623.242c-.17.104-.3.229-.393.374a.888.888 0 0 0-.14.49c0 .196.053.373.156.529.104.156.252.304.443.444s.423.276.696.41c.273.135.582.274.926.416.47.197.892.407 1.266.628.374.222.695.473.963.753.268.279.472.598.614.957.142.359.214.776.214 1.253 0 .657-.125 1.21-.373 1.656a3.033 3.033 0 0 1-1.012 1.085 4.38 4.38 0 0 1-1.487.596c-.566.12-1.163.18-1.79.18a9.916 9.916 0 0 1-1.84-.164 5.544 5.544 0 0 1-1.512-.493v-2.63a5.033 5.033 0 0 0 3.237 1.2c.333 0 .624-.03.872-.09.249-.06.456-.144.623-.25.166-.108.29-.234.373-.38a1.023 1.023 0 0 0-.074-1.089 2.12 2.12 0 0 0-.537-.5 5.597 5.597 0 0 0-.807-.444 27.72 27.72 0 0 0-1.007-.436c-.918-.383-1.602-.852-2.053-1.405-.45-.553-.676-1.222-.676-2.005 0-.614.123-1.141.369-1.582.246-.441.58-.804 1.004-1.089a4.494 4.494 0 0 1 1.47-.629 7.536 7.536 0 0 1 1.77-.201zm-15.113.188h9.563v2.166H9.506v9.646H6.789v-9.646H3.375z\"/\u003e\n\u003c/svg\u003e\n\n**IDEs \u0026 AI Assistants**\n![Claude](https://img.shields.io/badge/Claude-000000?style=flat\u0026logo=anthropic\u0026logoColor=white)\n![Cursor](https://img.shields.io/badge/Cursor-000000?style=flat\u0026logo=cursor\u0026logoColor=white)\n![VS Code](https://img.shields.io/badge/VS%20Code-0078d4.svg?style=flat\u0026logo=visual-studio-code\u0026logoColor=white)\n![JetBrains](https://img.shields.io/badge/JetBrains-black.svg?style=flat\u0026logo=jetbrains\u0026logoColor=white)\n![Zed](https://img.shields.io/badge/Zed-084CCF?style=flat\u0026logo=zed\u0026logoColor=white)\n![Windsurf](https://img.shields.io/badge/Windsurf-1E293B?style=flat\u0026logoColor=white)\n![GitHub Copilot](https://img.shields.io/badge/github%20copilot-000000?style=flat\u0026logo=githubcopilot\u0026logoColor=white)\n\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\n\u003csvg width=\"32\" height=\"32\" viewBox=\"0 0 24 24\" fill=\"#06B6D4\"\u003e\n\u003cpath d=\"M12.001 4.8c-3.2 0-5.2 1.6-6 4.8 1.2-1.6 2.6-2.2 4.2-1.8.913.228 1.565.89 2.288 1.624C13.666 10.618 15.027 12 18.001 12c3.2 0 5.2-1.6 6-4.8-1.2 1.6-2.6 2.2-4.2 1.8-.913-.228-1.565-.89-2.288-1.624C16.337 6.182 14.976 4.8 12.001 4.8zm-6 7.2c-3.2 0-5.2 1.6-6 4.8 1.2-1.6 2.6-2.2 4.2-1.8.913.228 1.565.89 2.288 1.624 1.177 1.194 2.538 2.576 5.512 2.576 3.2 0 5.2-1.6 6-4.8-1.2 1.6-2.6 2.2-4.2 1.8-.913-.228-1.565-.89-2.288-1.624C10.337 13.382 8.976 12 6.001 12z\"/\u003e\n\u003c/svg\u003e\n\n**Build Tools \u0026 Services**\n![Vite](https://img.shields.io/badge/vite-%23646CFF.svg?style=flat\u0026logo=vite\u0026logoColor=white)\n![Webpack](https://img.shields.io/badge/webpack-%238DD6F9.svg?style=flat\u0026logo=webpack\u0026logoColor=black)\n![PNPM](https://img.shields.io/badge/pnpm-%234a4a4a.svg?style=flat\u0026logo=pnpm\u0026logoColor=f69220)\n![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=flat\u0026logo=supabase\u0026logoColor=white)\n![Prisma](https://img.shields.io/badge/Prisma-3982CE?style=flat\u0026logo=Prisma\u0026logoColor=white)\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n## Core Commands\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M20 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2zM4 6h16v2H4V6zm0 4h4v2H4v-2zm6 0h10v2H10v-2zm-6 4h4v2H4v-2zm6 0h10v2H10v-2z\" fill=\"#374151\"/\u003e\n\u003c/svg\u003e\n\n```bash\n# Project initialization\nvdk init                         # Initialize with auto-detection\nvdk init --interactive          # Interactive setup with guided choices\n\n# Migration\nvdk migrate                      # Migrate existing AI contexts to VDK format\nvdk migrate --dry-run           # Preview migration without creating files\nvdk migrate --no-deploy         # Skip deployment to IDE integrations\n\n# Analysis and status\nvdk scan                         # Re-analyze project and update rules\nvdk status                       # Check current VDK configuration\nvdk validate                     # Validate generated rules\n\n# Utilities\nvdk --help                       # Show all available commands\nvdk --version                    # Display VDK CLI version\n```\n\n## Supported IDEs \u0026 AI Tools\n\nVDK CLI supports **33+ IDEs and AI assistants** with full auto-detection and configuration:\n\n- **Code Editors**: VS Code, VS Code Insiders, VSCodium, Cursor AI, Windsurf, Windsurf Next, Zed Editor\n- **JetBrains IDEs**: IntelliJ IDEA, WebStorm, PyCharm, PHPStorm, RubyMine, CLion, DataGrip, GoLand, Rider, Android Studio\n- **AI Services**: Claude Code, Claude Desktop, GitHub Copilot, OpenAI API Tools, Generic AI Platform\n- **Generic**: Works with any AI coding assistant through universal .ai/ configuration\n\n✨ **Enhanced Features**: \n- Individual JetBrains IDE detection with project-specific configurations\n- MCP (Model Context Protocol) integration across compatible platforms\n- Confidence-based IDE detection with intelligent project analysis\n- Automatic rule directory creation and management\n\n📖 **[Complete IDE Support List](./SUPPORTED_IDES_AND_AI_TOOLS.md)** - Exhaustive list with configuration details, MCP support status, and integration features.\n\n## Configuration\n\nVDK CLI automatically generates configuration files for your detected AI assistants:\n\n```json\n{\n  \"project\": {\n    \"name\": \"my-nextjs-app\",\n    \"type\": \"web-application\",\n    \"frameworks\": [\"nextjs\", \"react\", \"typescript\"],\n    \"libraries\": [\"tailwindcss\", \"shadcn-ui\"]\n  },\n  \"integrations\": {\n    \"claude-code\": {\n      \"enabled\": true,\n      \"memoryFiles\": [\"CLAUDE.md\", \"CLAUDE-patterns.md\"]\n    },\n    \"cursor\": {\n      \"enabled\": true,\n      \"rulesDirectory\": \".ai/rules/\"\n    }\n  }\n}\n```\n\n## Examples\n\n### Basic Project Setup\n\n```bash\n# Navigate to your project\ncd my-nextjs-app\n\n# Initialize VDK\nvdk init\n\n# VDK detects: Next.js, React, TypeScript, Tailwind CSS\n# Generates: .ai/rules/ with 15+ tailored rules\n# Configures: Claude Code memory files\n```\n\n### Interactive Setup\n\n```bash\n# Interactive mode for custom configuration\nvdk init --interactive\n\n# Choose your AI assistants:\n# ✓ Claude Code\n# ✓ Cursor\n# ✗ Windsurf\n# ✗ GitHub Copilot\n\n# Generates optimized rules for selected platforms\n```\n\n### Migration Example\n\n```bash\n# Project with existing AI contexts\ncd my-existing-project\n\n# Check what AI contexts are detected\nvdk status\n# Found: CLAUDE.md, .cursorrules, .github/copilot-instructions.md\n\n# Preview migration without creating files  \nvdk migrate --dry-run\n# Would migrate: 3 contexts with high confidence\n\n# Perform migration\nvdk migrate\n# Migrated: 3 contexts → 15+ VDK blueprints in vdk-migration/\n# Deployed: Rules to Claude Code, Cursor integrations\n```\n\n### Advanced Usage\n\n```bash\n# Re-analyze after adding new dependencies\nnpm install prisma\nvdk scan\n\n# Check what VDK detected\nvdk status\n\n# Validate all generated rules\nvdk validate\n```\n\n## Real Impact\n\nTeams using VDK CLI v2.0 report:\n\n- **60% faster** initial AI suggestions with enhanced technology detection\n- **85% more relevant** code completions with framework-specific rules\n- **40% fewer** back-and-forth clarifications through precise context\n- **90% consistency** in code patterns across team members\n- **100% accuracy** in package manager and build tool detection\n\n## Documentation\n\n- **[Getting Started Guide](./docs/Getting-Started-Guide.md)** - Complete setup instructions\n- **[Supported IDEs \u0026 AI Tools](./SUPPORTED_IDES_AND_AI_TOOLS.md)** - Complete compatibility list\n- **[CLI Reference](./docs/CLI-Reference.md)** - All commands and options\n- **[Rule Authoring Guide](./docs/Rule-Authoring-Guide.md)** - Create custom rules\n- **[Troubleshooting Guide](./docs/Troubleshooting-Guide.md)** - Common issues and solutions\n- **[Scanner Documentation](./src/scanner/README.md)** - Technical scanner details\n\n## Contributing\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z\" fill=\"#7C3AED\"/\u003e\n\u003c/svg\u003e\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.\n\n- [Report bugs](https://github.com/entro314-labs/VibeKit-VDK-CLI/issues)\n- [Request features](https://github.com/entro314-labs/VibeKit-VDK-CLI/issues)\n- [Improve documentation](./docs/)\n- [Submit pull requests](https://github.com/entro314-labs/VibeKit-VDK-CLI/pulls)\n\n## Roadmap\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M20 6h-2.18c.11-.31.18-.65.18-1a2.996 2.996 0 0 0-5.5-1.65l-.5.67-.5-.68C10.96 2.54 10.05 2 9 2 7.34 2 6 3.34 6 5c0 .35.07.69.18 1H4c-1.11 0-1.99.89-1.99 2L2 19c0 1.11.89 2 2 2h16c1.11 0 2-.89 2-2V8c0-1.11-.89-2-2-2zm-5-2c.55 0 1 .45 1 1s-.45 1-1 1-1-.45-1-1 .45-1 1-1zM9 4c.55 0 1 .45 1 1s-.45 1-1 1-1-.45-1-1 .45-1 1-1z\" fill=\"#0891B2\"/\u003e\n\u003c/svg\u003e\n\n- [x] **v2.0** - Enhanced technology detection, improved AI integrations\n- [x] **v2.9** - AI context migration system with multi-platform support\n- [ ] **v2.2** - VDK Hub integration for cloud-based rule management  \n- [ ] **v2.3** - Visual Studio Code extension for seamless IDE integration\n- [ ] **v3.0** - Team collaboration features and shared rule repositories\n\n## Requirements\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M20 18c1.1 0 1.99-.9 1.99-2L22 5c0-1.1-.9-2-2-2H4c-1.1 0-2 .9-2 2v11c0 1.1.9 2 2 2H0c0 1.1.9 2 2 2h20c1.1 0 2-.9 2-2h-4zM4 5h16v11H4V5zm8 14c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1z\" fill=\"#6B7280\"/\u003e\n\u003c/svg\u003e\n\n- **Node.js**: \u003e= 22.0.0\n- **npm**: \u003e= 8.0.0 or **pnpm** \u003e= 7.0.0\n- **Operating System**: Windows, macOS, Linux\n\n## License\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6z\" fill=\"#9CA3AF\"/\u003e\n\u003cpath d=\"M14 2v6h6\" fill=\"none\" stroke=\"white\" stroke-width=\"2\"/\u003e\n\u003c/svg\u003e\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n### Project Evolution \u0026 Attribution\n\nVDK CLI is the evolution of a rich history of AI-assisted development tooling:\n\n- **Original DevRules** by [Seth Rose](https://github.com/TheSethRose) - Established the foundational concept of structured AI assistant rules\n- **AIRules** - Major enhancement adding 51+ specialized tasks, memory management, and multi-platform support\n- **VibeKit VDK** - The current evolution, a comprehensive toolkit for making AI assistants project-aware\n\nFor detailed history and contributions, see [Project History \u0026 Attribution](docs/Project-History-Attribution.md).\n\n## Support\n\n\u003csvg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"\u003e\n\u003cpath d=\"M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z\" fill=\"#059669\"/\u003e\n\u003c/svg\u003e\n\n- **GitHub**: [Issues \u0026 Feature Requests](https://github.com/entro314-labs/VibeKit-VDK-CLI/issues)\n- **Documentation**: [Complete Docs](./docs/)\n- **Community**: [VDK Hub](https://vdk.tools)\n- **Email**: For enterprise support inquiries\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the VibeKit VDK community**\n\n[GitHub](https://github.com/entro314-labs/VibeKit-VDK-CLI) • [Documentation](./docs/) • [VDK Hub](https://vdk.tools) • [NPM](https://www.npmjs.com/package/@vibe-dev-kit/cli)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentro314-labs%2Fvdk-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fentro314-labs%2Fvdk-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentro314-labs%2Fvdk-cli/lists"}