{"id":28137803,"url":"https://github.com/tecnomanu/agent-rules-kit","last_synced_at":"2026-02-08T01:36:11.289Z","repository":{"id":291848010,"uuid":"978979293","full_name":"tecnomanu/agent-rules-kit","owner":"tecnomanu","description":"Bootstrap of Cursor rules (.mdc) and mirror documentation (.md) for AI agent-guided projects.","archived":false,"fork":false,"pushed_at":"2025-09-14T03:13:59.000Z","size":93984,"stargazers_count":25,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-23T15:08:28.824Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tecnomanu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-06T20:00:36.000Z","updated_at":"2025-09-30T12:53:32.000Z","dependencies_parsed_at":"2025-07-11T17:27:49.706Z","dependency_job_id":"bee7224d-ce7d-4ba8-8eb1-6ad7952f2d3c","html_url":"https://github.com/tecnomanu/agent-rules-kit","commit_stats":null,"previous_names":["tecnomanu/agent-rules-kit"],"tags_count":54,"template":false,"template_full_name":null,"purl":"pkg:github/tecnomanu/agent-rules-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecnomanu%2Fagent-rules-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecnomanu%2Fagent-rules-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecnomanu%2Fagent-rules-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecnomanu%2Fagent-rules-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tecnomanu","download_url":"https://codeload.github.com/tecnomanu/agent-rules-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecnomanu%2Fagent-rules-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29216092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T00:10:47.190Z","status":"ssl_error","status_checked_at":"2026-02-08T00:10:43.589Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-05-14T17:02:06.646Z","updated_at":"2026-02-08T01:36:11.282Z","avatar_url":"https://github.com/tecnomanu.png","language":"JavaScript","funding_links":[],"categories":["Development Utilities"],"sub_categories":["AI"],"readme":"# Agent Rules Kit v3.x\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/banner_agent_rules_kit.jpg\" alt=\"Agent Rules Kit Logo\" width=\"729\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/agent-rules-kit.svg\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/npm/dm/agent-rules-kit.svg\" alt=\"Downloads\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/tecnomanu/agent-rules-kit\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/tecnomanu/agent-rules-kit\" alt=\"Last Commit\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/tecnomanu/agent-rules-kit/CI\" alt=\"Build Status\" /\u003e\n\u003c/p\u003e\n\n\u003c!-- Badges --\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#️-mcp\"\u003e\n    \u003cimg alt=\"MCP badge\"\n         src=\"https://img.shields.io/badge/Rules-MCP-6f42c1?style=for-the-badge\u0026logo=sheriff\"\n    /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"#️-stacks\"\u003e\n    \u003cimg alt=\"Stacks badge\"\n         src=\"https://img.shields.io/badge/Rules-Stacks-ff004c?style=for-the-badge\u0026logo=layers\"\n    /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"#️-globals\"\u003e\n    \u003cimg alt=\"Globals badge\"\n         src=\"https://img.shields.io/badge/Rules-Globals-0d6efd?style=for-the-badge\u0026logo=files\"\n    /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e CLI tool to bootstrap AI agent rules for multiple IDEs and frameworks. Generates optimized rules for Cursor, VS Code, Claude, and 6+ other AI coding assistants.\n\n## 🎯 IDE Selection Interface\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/terminal_select_ide.png\" alt=\"Agent Rules Kit IDE Selector\" width=\"800\" /\u003e\n\u003c/p\u003e\n\n_Choose from 9 supported IDEs including Cursor, VS Code/GitHub Copilot, Windsurf, Continue, Claude, and more._\n\n## What is Agent Rules Kit?\n\nAgent Rules Kit is a CLI tool that facilitates the installation and configuration of rules for multiple AI-powered IDEs and coding assistants. The rules help AI agents better understand the structure, patterns, and best practices of different technology stacks, generating optimized configurations for each supported IDE.\n\n## 🎧 Audio Introduction\n\nListen to a brief introduction about Agent Rules Kit:\n\nhttps://github.com/user-attachments/assets/7d65c696-245d-421d-9ddc-90331a92c9b2\n\n[English Version](assets/podcast_en.mp3)\n\nhttps://github.com/user-attachments/assets/8e91d651-c15f-4892-a250-684ab60d8594\n\n[Spanish Version](assets/podcast_es.mp3)\n\n## 📚 Table of Contents\n\n1. [Quick Start](#-quick-start)\n2. [New Architecture](#-new-architecture)\n3. [New Features](#-new-features)\n4. [Supported Stacks](#supported-stacks)\n5. [MCP Tools Integration](#-mcp-tools-integration)\n6. [Implementation Status](#implementation-status)\n7. [Contributing](#contributing)\n8. [Code of Conduct](#code-of-conduct)\n9. [License](#license)\n\n## 🚀 Quick Start\n\n### Interactive Installation\n\n```bash\n# Install and run interactively\nnpx agent-rules-kit\n\n# The CLI will guide you through:\n# 1. 📁 Project path selection\n# 2. 🎯 IDE selection (Cursor, VS Code, Claude, etc.)\n# 3. 📚 Stack and architecture choice (optional)\n# 4. 🌐 Global best practices (recommended)\n# 5. 🔧 MCP tools selection (multiple tools supported)\n# 6. ⚡ Automatic rule generation\n```\n\n### Command Line Installation\n\nFor automated or scripted installations, use command line arguments to skip interactive prompts:\n\n```bash\n# Basic installation with auto-detection\nnpx agent-rules-kit --stack=laravel --version=12 --global --auto-install\n\n# Full configuration example\nnpx agent-rules-kit --stack=nextjs --version=14 --architecture=app --global --mcp-tools=pampa,github --ide=cursor\n\n# For different IDEs\nnpx agent-rules-kit --stack=react --version=18 --ide=vscode    # VS Code\nnpx agent-rules-kit --stack=laravel --version=12 --ide=claude  # Claude\nnpx agent-rules-kit --stack=angular --version=17 --ide=windsurf # Windsurf\n```\n\n**📖 For complete CLI options and examples, see [AGENTS.md](AGENTS.md)**\n\nYour rules will be generated in the appropriate location for your chosen IDE and automatically detected!\n\n### AI Agent Integration\n\nIf you are using an AI agent, check [AGENTS.md](AGENTS.md) for comprehensive instructions on automated installation. Share this file with your agent so it installs the rules automatically with the correct options.\n\n### Available Options\n\n-   **Stack Selection**: Choose the main framework or technology for your project\n-   **Global Rules**: Include general best practice rules\n-   **Cursor Directory**: Specify the location of the Cursor directory\n-   **Project Path**: Define the relative path if the project is not in the root\n-   **Mirror Documentation**: Generate .md files that reflect the rules for human reference\n-   **Debug Mode**: Enable detailed logging for troubleshooting\n\n## 🎉 New Architecture\n\nWe've completely redesigned the internal architecture to provide a more maintainable and extensible system:\n\n-   **Service-Based Architecture**: Replaced the helper-based system with a clean service-oriented architecture that enhances maintainability and extensibility\n-   **Automatic Backups**: Smart backup system that preserves your custom rules when updating\n-   **Enhanced Debug Mode**: Better visibility into the rule generation process with standardized logging\n-   **Improved Testing Framework**: More robust testing with better mocking and service isolation\n-   **React Architecture Options**: Now includes support for atomic design and feature-sliced design\n-   **Better State Management Support**: Enhanced support for modern state management libraries\n\n## 🎉 New Features\n\n-   🚀 Quick setup of rules for different frameworks and stacks\n-   🔍 Automatic framework version detection\n-   🏗️ Support for multiple architectural styles\n-   📚 Mirror documentation generation for human reference\n-   🧩 Modular system for easy expansion to new frameworks\n-   💾 Automatic backups of existing rules\n-   🔄 Version-specific rule overlays\n-   🔧 **Multi-select MCP Tools integration** (Since v2.0)\n\n## 🔧 MCP Tools Integration\n\n**Since v2.0**: Agent Rules Kit includes comprehensive support for Model Context Protocol (MCP) tools! This powerful feature allows AI agents to work more effectively with external tools and services.\n\n### What are MCP Tools?\n\nModel Context Protocol (MCP) tools are standardized interfaces that allow AI assistants to securely connect to external data sources and services. These tools enable AI agents to:\n\n-   🔍 **Search codebases semantically** with understanding of code meaning\n-   🐙 **Manage repositories** with secure GitHub integration\n-   🧠 **Maintain persistent memory** across conversation sessions\n-   📁 **Access file systems** with configurable security controls\n-   🔀 **Perform version control** operations with Git integration\n\n### Available MCP Tools\n\nChoose from 5 popular MCP tools during installation:\n\n| Tool              | Name                  | Description                                       | Best For                                                      |\n| ----------------- | --------------------- | ------------------------------------------------- | ------------------------------------------------------------- |\n| 🔍 **PAMPA**      | Semantic Code Search  | AI-powered code search with project memory        | Understanding large codebases, finding relevant code patterns |\n| 🐙 **GitHub**     | Repository Management | Secure GitHub API integration for file operations | Repository management, collaborative development              |\n| 🧠 **Memory**     | Persistent Knowledge  | Long-term memory storage across sessions          | Maintaining context, learning from previous interactions      |\n| 📁 **Filesystem** | File Operations       | Secure file system access with controls           | File management, project organization                         |\n| 🔀 **Git**        | Version Control       | Repository operations and history analysis        | Version control, commit management, branch operations         |\n\n### Multi-Select Installation\n\nThe new multi-select interface allows you to install rules for multiple MCP tools simultaneously:\n\n```bash\n? Select MCP tools to install rules for: (Use space to select, enter to confirm)\n❯◉ PAMPA - Semantic Code Search - AI-powered semantic code search and project memory system\n ◉ GitHub - Repository Management - Secure access to GitHub repositories for file operations\n ◯ Memory - Persistent Knowledge - Persistent knowledge storage and retrieval across sessions\n ◉ Filesystem - File Operations - Secure file operations with configurable access controls\n ◯ Git - Version Control - Repository operations, commit history analysis, and version control\n```\n\n### Generated Rule Structure\n\nEach selected MCP tool generates organized rules in your project:\n\n```\n.cursor/rules/rules-kit/mcp-tools/\n├── pampa/\n│   ├── pampa-mcp-usage.mdc       # Core usage patterns\n│   └── pampa-best-practices.mdc  # Best practices and tips\n├── github/\n│   ├── github-mcp-usage.mdc      # GitHub API integration rules\n│   └── github-workflow.mdc       # Workflow patterns\n└── memory/\n    ├── memory-mcp-usage.mdc      # Memory management rules\n    └── memory-patterns.mdc       # Common memory patterns\n```\n\n### Benefits for AI Agents\n\nMCP Tools rules help AI agents:\n\n1. **🎯 Use tools effectively**: Clear guidelines on when and how to use each tool\n2. **🛡️ Follow security best practices**: Built-in security patterns and access controls\n3. **⚡ Optimize performance**: Efficient usage patterns to avoid rate limits and errors\n4. **🔄 Handle errors gracefully**: Common error scenarios and recovery strategies\n5. **📖 Learn workflows**: Step-by-step patterns for complex operations\n\n### Integration with Stack Rules\n\nMCP tools rules work alongside your stack-specific rules:\n\n-   **🔀 Independent Generation**: MCP rules are separate from stack rules\n-   **🧩 Flexible Combinations**: Any stack + any combination of MCP tools\n-   **🎯 Focused Guidance**: Tool-specific rules don't interfere with framework patterns\n-   **📋 Complete Coverage**: Both development patterns AND tool usage covered\n\n## Supported Stacks\n\n-   Laravel (v8-12)\n-   Next.js (v12-14)\n-   React (v17-18)\n-   React Native\n-   Angular (v14-17)\n-   NestJS\n-   Vue (v2-3)\n-   Nuxt (v2-3)\n-   Svelte (v3-5)\n-   SvelteKit (v1-2)\n-   Astro\n\n## Implementation Status\n\n\u003cp align=\"center\"\u003e\n\n| Stack                                                                                                                                         | Status                                | Features                                                                                                                        |\n| --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |\n| \u003cimg src=\"https://img.shields.io/badge/MCP%20Tools-FF6600?style=for-the-badge\u0026logo=tools\u0026logoColor=white\" alt=\"MCP Tools\" width=\"100\"/\u003e       | ![100%](https://progress-bar.xyz/100) | **Since v2.0**: Multi-select MCP tools (PAMPA, GitHub, Memory, Filesystem, Git), usage patterns, security guidelines, workflows |\n| \u003cimg src=\"https://img.shields.io/badge/MCP-0066CC?style=for-the-badge\u0026logo=protocol\u0026logoColor=white\" alt=\"MCP\" width=\"100\"/\u003e                  | ![100%](https://progress-bar.xyz/100) | Complete SDK coverage (Python, TypeScript, Java, Kotlin, C#, Swift), server/client patterns, architecture concepts              |\n| \u003cimg src=\"https://img.shields.io/badge/Laravel-FF2D20?style=for-the-badge\u0026logo=laravel\u0026logoColor=white\" alt=\"Laravel\" width=\"100\"/\u003e           | ![100%](https://progress-bar.xyz/100) | Multiple architectures, version detection, casting rules                                                                        |\n| \u003cimg src=\"https://img.shields.io/badge/Nuxt-00DC82?style=for-the-badge\u0026logo=nuxt.js\u0026logoColor=white\" alt=\"Nuxt\" width=\"100\"/\u003e                 | ![100%](https://progress-bar.xyz/100) | Testing guidelines, architectural patterns, version-specific docs                                                               |\n| \u003cimg src=\"https://img.shields.io/badge/Pampa-FF6B35?style=for-the-badge\u0026logo=search\u0026logoColor=white\" alt=\"Pampa\" width=\"100\"/\u003e                | ![100%](https://progress-bar.xyz/100) | Semantic code search, AI agent integration, MCP support, multi-language indexing                                                |\n| \u003cimg src=\"https://img.shields.io/badge/React-61DAFB?style=for-the-badge\u0026logo=react\u0026logoColor=black\" alt=\"React\" width=\"100\"/\u003e                 | ![95%](https://progress-bar.xyz/95)   | Architecture options, state management, testing guidelines, version-specific guidance (v18 concurrent features)                 |\n| \u003cimg src=\"https://img.shields.io/badge/React%20Native-61DAFB?style=for-the-badge\u0026logo=react\u0026logoColor=black\" alt=\"React Native\" width=\"100\"/\u003e | ![25%](https://progress-bar.xyz/25)   | Base rules (architecture, best practices, styling, naming, navigation, platform code, state, testing, version info)             |\n| \u003cimg src=\"https://img.shields.io/badge/Next.js-000000?style=for-the-badge\u0026logo=nextdotjs\u0026logoColor=white\" alt=\"Next.js\" width=\"100\"/\u003e         | ![95%](https://progress-bar.xyz/95)   | App \u0026 Pages router support, version detection, testing docs, version-specific guidance (v13 API routes, v14 Server Components)  |\n| \u003cimg src=\"https://img.shields.io/badge/Svelte-FF3E00?style=for-the-badge\u0026logo=svelte\u0026logoColor=white\" alt=\"Svelte\" width=\"100\"/\u003e              | ![70%](https://progress-bar.xyz/70)   | Component organization, runes (v5), lifecycle, state management                                                                 |\n| \u003cimg src=\"https://img.shields.io/badge/Go-00ADD8?style=for-the-badge\u0026logo=go\u0026logoColor=white\" alt=\"Go\" width=\"100\"/\u003e                          | ![75%](https://progress-bar.xyz/75)   | Multiple architectures, project structure, error handling patterns                                                              |\n| \u003cimg src=\"https://img.shields.io/badge/SvelteKit-FF3E00?style=for-the-badge\u0026logo=svelte\u0026logoColor=white\" alt=\"SvelteKit\" width=\"100\"/\u003e        | ![70%](https://progress-bar.xyz/70)   | Routing system, layouts, SSR/CSR strategies, form actions                                                                       |\n| \u003cimg src=\"https://img.shields.io/badge/Astro-0D0D0D?style=for-the-badge\u0026logo=astro\u0026logoColor=white\" alt=\"Astro\" width=\"100\"/\u003e                 | ![60%](https://progress-bar.xyz/60)   | Content collections, static/dynamic content, integration guides                                                                 |\n| \u003cimg src=\"https://img.shields.io/badge/Angular-DD0031?style=for-the-badge\u0026logo=angular\u0026logoColor=white\" alt=\"Angular\" width=\"100\"/\u003e           | ![55%](https://progress-bar.xyz/55)   | Signals support, base project structure                                                                                         |\n| \u003cimg src=\"https://img.shields.io/badge/NestJS-E0234E?style=for-the-badge\u0026logo=nestjs\u0026logoColor=white\" alt=\"NestJS\" width=\"100\"/\u003e              | ![75%](https://progress-bar.xyz/75)   | Standard and Microservices architectures, NestJS 9.x and 10.x features                                                          |\n| \u003cimg src=\"https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=node.js\u0026logoColor=white\" alt=\"Node.js\" width=\"100\"/\u003e           | ![20%](https://progress-bar.xyz/20)   | Base project structure, best practices, naming, testing                                                                         |\n| \u003cimg src=\"https://img.shields.io/badge/Vue-4FC08D?style=for-the-badge\u0026logo=vue.js\u0026logoColor=white\" alt=\"Vue\" width=\"100\"/\u003e                    | ![45%](https://progress-bar.xyz/45)   | Testing guidelines, architecture concepts                                                                                       |\n\n\u003c/p\u003e\n\n\u003e **Enhanced Extensibility**: Detailed documentation has been added on how to [extend Agent Rules Kit with new services](/docs/extending-services.md), making it easier to contribute new stacks and features.\n\n## Contributing\n\nFor guidelines on contributing to this project, please see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Code of Conduct\n\nPlease read our [Code of Conduct](CODE_OF_CONDUCT.md) before participating in our project.\n\n## License\n\nThis project is licensed under the ISC License. See the [LICENSE](LICENSE) file for details.\n\n## 🎯 Available Stacks\n\nChoose from a wide range of technology stacks:\n\n| Stack                               | SDKs/Versions                               | Architectures                         |\n| ----------------------------------- | ------------------------------------------- | ------------------------------------- |\n| **Laravel**                         | 8, 9, 10, 11, 12                            | Standard, DDD, Hexagonal              |\n| **Next.js**                         | 12, 13, 14                                  | App Router, Pages Router              |\n| **Angular**                         | 14, 15, 16, 17                              | Standard, Standalone, Micro-frontends |\n| **React**                           | 17, 18                                      | Standard, Hooks, Concurrent           |\n| **Vue.js**                          | 2, 3                                        | Options API, Composition API, Nuxt    |\n| **Astro**                           | 2, 3, 4, 5                                  | Static, SSR, Hybrid                   |\n| **React Native**                    | 0.70, 0.71, 0.72, 0.73, 0.74                | Standard, Expo                        |\n| **NestJS**                          | 8, 9, 10                                    | Standard, Microservices, GraphQL      |\n| **Go**                              | 1.20, 1.21, 1.22                            | Standard, DDD, Hexagonal              |\n| **Node.js**                         | 18, 20                                      | Standard                              |\n| **🆕 MCP (Model Context Protocol)** | Python, TypeScript, Java, Kotlin, C#, Swift | Server, Client, Toolkit               |\n| **🆕 Pampa**                        | Latest                                      | Standard                              |\n\n### 🔥 Featured: Model Context Protocol (MCP) SDKs\n\nMCP is an open standard that enables AI applications to securely connect to data sources. Our rules kit includes comprehensive implementation guides for all major SDKs:\n\n-   **📖 Architecture Concepts**: Core MCP patterns and best practices\n-   **🐍 Python SDK**: Async/await patterns with Pydantic validation\n-   **🟦 TypeScript SDK**: Type-safe implementations with modern JS patterns\n-   **☕ Java SDK**: Enterprise patterns with Spring Boot integration\n-   **🎯 Kotlin SDK**: Coroutines and advanced async features\n-   **🔷 C# SDK**: .NET patterns with dependency injection\n-   **🍎 Swift SDK**: Actors and async/await with Vapor integration\n\n### 🎯 Featured: Pampa Semantic Code Search\n\nPampa is our own AI-powered semantic code search tool designed specifically for AI agents:\n\n-   **🔍 Semantic Search**: Understand code meaning, not just syntax\n-   **🤖 AI Agent Optimized**: Built specifically for AI agent workflows\n-   **🌍 Multi-Language**: Python, TypeScript, Java, Go, PHP, and more\n-   **🚀 Simple Setup**: No versions, no complex config - just install and use\n-   **🔌 MCP Integration**: Built-in MCP server for seamless AI integration\n\nPerfect for AI agents to quickly understand and navigate any codebase!\n\n## ✨ Key Features\n\n-   **🎯 Multi-Stack Support**: 15+ frameworks including Laravel, Next.js, React, Angular, Vue, and more\n-   **🏗️ Architecture-Aware**: Specialized rules for different architectural patterns (MVC, DDD, Hexagonal, etc.)\n-   **📦 Version Detection**: Automatic framework version detection with version-specific optimizations\n-   **🌐 Global Best Practices**: Universal coding standards and quality assurance rules\n-   **🔧 MCP Tools Integration**: Multi-select support for popular Model Context Protocol tools (PAMPA, GitHub, Memory, Filesystem, Git)\n-   **⚡ Performance Optimized**: Efficient rule generation with progress tracking and memory management\n-   **🔄 Smart Updates**: Backup existing rules and merge configurations intelligently\n-   **🎨 Beautiful CLI**: Interactive interface with helpful prompts and clear feedback\n\n## Multi-IDE Installation\n\nAgent Rules Kit can install existing rules into several IDEs and agents using the new `install` command. Pass the desired IDE with `--target` (or the alias `--ide`) to skip the interactive selector:\n\n```bash\nnpx agent-rules-kit install --target=cursor   # or --ide=cursor\n```\n\n### Supported targets\n\n| Target                   | Path                              | Extension | Front matter |\n| ------------------------ | --------------------------------- | --------- | ------------ |\n| Cursor                   | `.cursor/rules/`                  | `.mdc`    | yes          |\n| VS Code / GitHub Copilot | `.github/copilot-instructions.md` | `.md`     | no           |\n| Windsurf                 | `.windsurf/rules/`                | `.md`     | no           |\n| Windsurf (legacy)        | `.windsurfrules`                  | `.md`     | no           |\n| Continue                 | `.continue/rules/`                | `.md`     | yes          |\n| Zed                      | `./.rules`                        | `.rules`  | no           |\n| Claude Code              | `CLAUDE.md`                       | `.md`     | no           |\n| Gemini Code              | `GEMINI.md`                       | `.md`     | no           |\n| OpenAI Codex             | `AGENTS.md`                       | `.md`     | no           |\n| Cline                    | `.clinerules`                     | `.md`     | no           |\n\nThe command detects `.mdc` files in your project (default `./rules`) and writes them in the format required by the chosen target.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftecnomanu%2Fagent-rules-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftecnomanu%2Fagent-rules-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftecnomanu%2Fagent-rules-kit/lists"}