{"id":35129109,"url":"https://github.com/patricio0312rev/agentkit","last_synced_at":"2026-01-13T22:02:36.434Z","repository":{"id":330890758,"uuid":"1123820878","full_name":"patricio0312rev/agentkit","owner":"patricio0312rev","description":"CLI tool to scaffold AI agent configurations for Claude Code, Cursor, and other AI coding assistants","archived":false,"fork":false,"pushed_at":"2025-12-28T21:45:19.000Z","size":236,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-31T12:58:35.260Z","etag":null,"topics":["ai","ai-agents","aider","claude","copilot","cursor","npm","npm-package","package"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@patricio0312rev/agentkit","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/patricio0312rev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-27T17:38:07.000Z","updated_at":"2025-12-28T23:57:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/patricio0312rev/agentkit","commit_stats":null,"previous_names":["patricio0312rev/agentkit"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/patricio0312rev/agentkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patricio0312rev%2Fagentkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patricio0312rev%2Fagentkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patricio0312rev%2Fagentkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patricio0312rev%2Fagentkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patricio0312rev","download_url":"https://codeload.github.com/patricio0312rev/agentkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patricio0312rev%2Fagentkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400454,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: 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":["ai","ai-agents","aider","claude","copilot","cursor","npm","npm-package","package"],"created_at":"2025-12-28T04:29:53.191Z","updated_at":"2026-01-13T22:02:36.423Z","avatar_url":"https://github.com/patricio0312rev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 AgentKit\n\n\u003e **Scaffold AI agent configurations for Claude Code, Cursor, GitHub Copilot, Aider, and more.**\n\nAgentKit is a CLI tool that helps you set up specialized AI agents for your development workflow. Get 42 pre-built agents across 7 departments—from engineering and design to marketing and testing—all optimized for rapid app development.\n\n[![npm version](https://img.shields.io/npm/v/@patricio0312rev/agentkit.svg)](https://www.npmjs.com/package/@patricio0312rev/agentkit)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n---\n\n## ✨ Features\n\n- 🚀 **42 Pre-built Agents** across 7 specialized departments\n- 🔧 **Multi-tool Support** - Works with Claude Code, Cursor, GitHub Copilot, Aider, and more\n- 📦 **Zero Configuration** - Interactive setup in under 2 minutes\n- 🎨 **Customizable** - Select exactly which agents you need\n- 🌍 **Language Agnostic** - Supports TypeScript, Python, Go, Java, Swift, Kotlin, and more\n- ⚡ **Optimized for Speed** - Built for 6-day development sprints\n\n---\n\n## 📦 Installation\n\n```bash\n# Install globally\nnpm install -g @patricio0312rev/agentkit\n\n# Or use directly with npx\nnpx agentkit init\n```\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# Interactive setup\nagentkit init\n\n# Non-interactive (with all flags)\nagentkit init \\\n  --tool cursor \\\n  --folder .cursorrules \\\n  --departments engineering,design \\\n  --skip-prompts\n```\n\nFollow the prompts to:\n\n1. Select your AI tool (Cursor, Claude Code, etc.)\n2. Choose departments (Engineering, Design, Marketing, etc.)\n3. Pick specific agents (or keep all selected)\n4. Generate your configuration ✨\n\n---\n\n## 🏢 Available Departments \u0026 Agents\n\n### **Design** (5 agents)\n\n- `brand-guardian` - Brand consistency and visual identity\n- `ui-designer` - Interface design and component systems\n- `ux-researcher` - User research and testing\n- `visual-storyteller` - Marketing visuals and graphics\n- `whimsy-injector` - Delightful micro-interactions\n\n### **Engineering** (7 agents)\n\n- `ai-engineer` - AI/ML integration and optimization\n- `backend-architect` - API design and server architecture\n- `devops-automator` - CI/CD and infrastructure\n- `frontend-developer` - UI implementation and optimization\n- `mobile-app-builder` - iOS/Android development\n- `rapid-prototyper` - Fast MVP development\n- `test-writer-fixer` - Testing and quality assurance\n\n### **Marketing** (7 agents)\n\n- `app-store-optimizer` - ASO and store listings\n- `content-creator` - Blog posts, videos, social content\n- `growth-hacker` - Viral loops and growth experiments\n- `instagram-curator` - Instagram strategy and content\n- `reddit-community-builder` - Reddit engagement\n- `tiktok-strategist` - TikTok marketing and trends\n- `twitter-engager` - Twitter/X engagement\n\n### **Product** (3 agents)\n\n- `feedback-synthesizer` - User feedback analysis\n- `sprint-prioritizer` - Feature prioritization\n- `trend-researcher` - Market trends and opportunities\n\n### **Project Management** (3 agents)\n\n- `experiment-tracker` - A/B testing and experiments\n- `project-shipper` - Launch coordination\n- `studio-producer` - Cross-team coordination\n\n### **Studio Operations** (5 agents)\n\n- `analytics-reporter` - Metrics and insights\n- `finance-tracker` - Budget and cost management\n- `infrastructure-maintainer` - System reliability\n- `legal-compliance-checker` - Privacy and compliance\n- `support-responder` - Customer support\n\n### **Testing** (5 agents)\n\n- `api-tester` - API testing and performance\n- `performance-benchmarker` - Speed optimization\n- `test-results-analyzer` - Test data analysis\n- `tool-evaluator` - Development tool assessment\n- `workflow-optimizer` - Process optimization\n\n---\n\n## 🛠️ Supported AI Tools\n\n| Tool               | Folder         | Description               |\n| ------------------ | -------------- | ------------------------- |\n| **Claude Code**    | `.claude`      | Native sub-agent support  |\n| **Cursor**         | `.cursorrules` | @-mentions and multi-file |\n| **GitHub Copilot** | `.github`      | copilot-instructions.md   |\n| **Aider**          | `.aider`       | conventions.md            |\n| **Universal**      | `.ai`          | Works with any tool       |\n\n---\n\n## 📖 Usage Examples\n\n### With Cursor\n\n```bash\nagentkit init --tool cursor --folder .cursorrules --departments engineering,design\n```\n\nThen in Cursor:\n\n```\n@engineering/backend-architect.md Design a REST API for user management\n```\n\n### With Claude Code\n\n```bash\nagentkit init --tool claude-code --folder .claude --departments engineering\n```\n\nThen with Claude Code CLI:\n\n```bash\nclaude-code \"Build a login page using the frontend-developer patterns\"\n```\n\n### With GitHub Copilot\n\n```bash\nagentkit init --tool copilot --departments engineering,testing\n```\n\nCopilot automatically uses `.github/copilot-instructions.md` for all suggestions.\n\n---\n\n## 🎯 Use Cases\n\n**For Startups:**\n\n- Rapid prototyping with `rapid-prototyper`\n- Growth experiments with `growth-hacker`\n- Launch coordination with `project-shipper`\n\n**For Solo Developers:**\n\n- Full-stack guidance with engineering agents\n- Marketing strategies with marketing agents\n- Testing workflows with testing agents\n\n**For Teams:**\n\n- Consistent standards across departments\n- Specialized expertise on demand\n- Faster onboarding for new team members\n\n---\n\n## 📚 Documentation\n\nEach generated agent includes:\n\n- **Clear responsibilities** and best practices\n- **Code examples** in multiple languages\n- **Framework-specific patterns** (React, Vue, Node.js, Python, Go, etc.)\n- **Quick reference guides** and checklists\n- **Integration tips** for your workflow\n\nAll agents are designed to be:\n\n- ✅ **Language-agnostic** (works with any tech stack)\n- ✅ **Actionable** (practical, not theoretical)\n- ✅ **Focused** (200-250 lines for easy reading)\n\n---\n\n---\n\n## ⚙️ Configuration Options\n\n### Command-Line Flags\n\n| Flag                       | Description                                         | Available Options                                                                                        | Default                              | Required                   |\n| -------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------------- |\n| `-t, --tool \u003ctool\u003e`        | AI tool to generate configuration for               | `claude-code`, `cursor`, `copilot`, `aider`, `universal`                                                 | `cursor`                             | ✅ (with `--skip-prompts`) |\n| `-f, --folder \u003cname\u003e`      | Custom folder name for agent files                  | Any valid folder name (no spaces or slashes)                                                             | Tool-specific default\\*              | ❌                         |\n| `-m, --model \u003cmodel\u003e`      | Model for Claude Code agents                        | `sonnet`, `opus`, `haiku`, `inherit`                                                                     | `sonnet`                             | ❌                         |\n| `-d, --departments \u003clist\u003e` | Comma-separated list of departments to include      | `design`, `engineering`, `marketing`, `product`, `project-management`, `studio-operations`, `testing`    | -                                    | ✅ (with `--skip-prompts`) |\n| `--agents \u003clist\u003e`          | Comma-separated list of specific agents to include  | See [agent list](#-available-departments--agents) above. Format: `agent-name` or `department/agent-name` | All agents from selected departments | ❌                         |\n| `--skip-prompts`           | Skip all interactive prompts (non-interactive mode) | -                                                                                                        | `false`                              | ❌                         |\n| `-h, --help`               | Display help information                            | -                                                                                                        | -                                    | ❌                         |\n\n\\*_Tool-specific default folders:_\n\n| Tool          | Default Folder                                |\n| ------------- | --------------------------------------------- |\n| `claude-code` | `.claude`                                     |\n| `cursor`      | `.cursorrules`                                |\n| `copilot`     | `.github` (creates `copilot-instructions.md`) |\n| `aider`       | `.aider`                                      |\n| `universal`   | `.ai`                                         |\n\n### Usage Examples\n\n**Interactive mode (recommended for first-time users):**\n\n```bash\nagentkit init\n```\n\n**Full non-interactive setup:**\n\n```bash\nagentkit init \\\n  --tool cursor \\\n  --folder .cursorrules \\\n  --departments engineering,design \\\n  --skip-prompts\n```\n\n**Select specific agents only:**\n\n```bash\nagentkit init \\\n  --tool cursor \\\n  --departments engineering \\\n  --agents backend-architect,frontend-developer \\\n  --skip-prompts\n```\n\n**Multiple departments with custom folder:**\n\n```bash\nagentkit init \\\n  --tool claude-code \\\n  --folder .my-agents \\\n  --departments engineering,marketing,testing \\\n  --skip-prompts\n```\n\n**Claude Code with specific model:**\n\n```bash\nagentkit init \\\n  --tool claude-code \\\n  --model opus \\\n  --departments engineering,design \\\n  --skip-prompts\n```\n\n**All agents from all departments:**\n\n```bash\nagentkit init \\\n  --tool universal \\\n  --departments design,engineering,marketing,product,project-management,studio-operations,testing \\\n  --skip-prompts\n```\n\n---\n\n## 🗺️ Roadmap\n\n### v0.2.0 (Coming Soon)\n\n- 🛠️ **Tech Stack Awareness** - Agents adapt to your specific stack (React, Vue, Python, Go, etc.)\n- 🔄 **Update Command** - Update existing configurations without regenerating\n- 📊 **Agent Analytics** - Track which agents you use most\n- 🎨 **Custom Agent Templates** - Create your own agents\n- 🌐 **More Languages** - Localization support\n\n### v0.3.0 (Future)\n\n- 🔌 **VSCode Extension** - Use agents directly in VSCode\n- 🤝 **Team Collaboration** - Share agent configurations across teams\n- 📦 **Agent Marketplace** - Community-contributed agents\n- 🧪 **Agent Testing Framework** - Validate agent effectiveness\n\n**Want to contribute?** Check our [GitHub repository](https://github.com/patricio0312rev/agentkit) for open issues and feature requests!\n\n---\n\n## 🐛 Known Issues \u0026 Troubleshooting\n\n### Common Issues\n\n**1. \"Command not found: agentkit\"**\n\n```bash\n# If installed globally, try:\nnpm uninstall -g @patricio0312rev/agentkit\nnpm install -g @patricio0312rev/agentkit\n\n# Or use npx:\nnpx agentkit init\n```\n\n**2. Agents not appearing in Cursor @-mentions**\n\n- Restart Cursor after running `agentkit init`\n- Verify files exist in the specified folder\n- Check Cursor settings → Custom Instructions\n\n**3. Permission errors during installation**\n\n```bash\nsudo npm install -g @patricio0312rev/agentkit\n# Or use npx to avoid global install\n```\n\n**4. Files not generating**\n\n- Ensure you have write permissions in the current directory\n- Check if folder already exists (AgentKit won't overwrite)\n- Run with `--skip-prompts` and all required flags\n\n### Report an Issue\n\nFound a bug or have a feature request?\n\n👉 **[Open an issue on GitHub](https://github.com/patricio0312rev/agentkit/issues)**\n\nPlease include:\n\n- Your OS and Node.js version (`node -v`)\n- The command you ran\n- Expected vs actual behavior\n- Any error messages\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. **Report bugs** - Open an issue with details\n2. **Suggest features** - Tell us what would make AgentKit better\n3. **Improve agents** - Submit PRs for agent improvements\n4. **Share your setup** - Show how you use AgentKit\n\nSee [CONTRIBUTING.md](https://github.com/patricio0312rev/agentkit/blob/main/CONTRIBUTING.md) for guidelines.\n\n---\n\n## 💡 Tips \u0026 Best Practices\n\n**Getting Started:**\n\n- Start with 1-2 departments to avoid overwhelming yourself\n- Read the generated `README.md` in your agents folder\n- Try different agents to find which ones fit your workflow\n\n**For Teams:**\n\n- Commit the generated folder to version control\n- Share agent configurations across your team\n- Customize agents to match your team's conventions\n- Run `agentkit init` when onboarding new members\n\n**Optimization:**\n\n- Remove agents you rarely use to reduce context\n- Customize agent instructions for your specific needs\n- Create shortcuts for frequently used agent combinations\n\n---\n\n## 🙏 Credits\n\nAgentKit is built with:\n\n- [Commander.js](https://github.com/tj/commander.js) - CLI framework\n- [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) - Interactive prompts\n- [Chalk](https://github.com/chalk/chalk) - Terminal styling\n- [fs-extra](https://github.com/jprichardson/node-fs-extra) - File system utilities\n\nAgentKit templates were based on:\n\n- [agents](https://github.com/contains-studio/agents) - Contains-Studio's Agents\n\nInspired by the amazing AI coding assistant community and built for developers who ship fast.\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](./LICENSE) file for details.\n\n---\n\n**Stay safe when working with AI! 🛡️**\n\nEnjoy! 💜\n\nMade with love by [Patricio Marroquin](https://www.patriciomarroquin.dev/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatricio0312rev%2Fagentkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatricio0312rev%2Fagentkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatricio0312rev%2Fagentkit/lists"}