{
  "markdown": "# GeminiAutoPM\n\n**Intelligent Project Management Framework for Gemini CLI**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)\n[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)\n\nGeminiAutoPM is a powerful Gemini CLI extension that provides AI-powered agent tools for code analysis, test execution, DevOps automation, and agile project management. Built on the Model Context Protocol (MCP), it brings intelligent automation to your development workflow.\n\n## ✨ Features\n\n### 🔍 Code Analyzer\n- **Bug Detection**: Trace logic flows and identify potential bugs\n- **Security Scanning**: Detect vulnerabilities and security anti-patterns\n- **Performance Analysis**: Identify bottlenecks and optimization opportunities\n- **Code Quality**: Assess maintainability and best practices adherence\n\n### 🧪 Test Runner\n- **Test Execution**: Run tests with any framework (Jest, Mocha, Pytest, etc.)\n- **Failure Analysis**: Deep-dive into test failures with root cause analysis\n- **Coverage Assessment**: Identify test coverage gaps\n- **Regression Detection**: Compare results with baseline metrics\n\n### 🤖 Agent Manager\n- **Tool Creation**: Scaffold new MCP tools following best practices\n- **Registry Management**: Maintain consistent tool catalog\n- **Validation**: Ensure tools follow MCP standards\n- **Documentation**: Generate comprehensive docs with examples\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install the extension\ngemini extensions install rafeekpro/GeminiAutoPM\n\n# Verify installation\ngemini extensions list\n```\n\n### Basic Usage\n\nOnce installed, the tools are automatically available in Gemini CLI:\n\n```bash\n# Start Gemini CLI\ngemini\n\n# Use the tools in natural language\n> Use the code_analyzer tool to review my authentication module for security issues\n\n> Use the test_runner tool to execute all unit tests and analyze failures\n\n> Use the agent_manager tool to create a new MCP tool for GraphQL development\n```\n\n## 📖 Documentation\n\n### Agent Tools\n\n#### code_analyzer\n\nPerforms deep code analysis for bugs, security vulnerabilities, and optimization opportunities.\n\n**Parameters:**\n- `task` (required): The code analysis task to perform\n- `scope` (optional): Analysis focus (security, performance, bugs)\n- `files` (optional): Specific files to analyze\n\n**Example:**\n```\nUse code_analyzer to scan the src/auth directory for security vulnerabilities\n```\n\n**Context7 Queries:**\n- `mcp://context7/security/code-analysis`\n- `mcp://context7/security/vulnerability-scanning`\n- `mcp://context7/code-quality/static-analysis`\n\n#### test_runner\n\nExecutes tests and provides comprehensive failure analysis.\n\n**Parameters:**\n- `task` (required): The test execution task\n- `scope` (optional): Test type (unit, integration, e2e)\n- `testPattern` (optional): Test file pattern\n- `framework` (optional): Test framework (jest, mocha, pytest)\n\n**Example:**\n```\nUse test_runner to run all integration tests and analyze any failures\n```\n\n**Context7 Queries:**\n- `mcp://context7/testing/test-frameworks`\n- `mcp://context7/testing/jest`\n- `mcp://context7/testing/test-analysis`\n\n#### agent_manager\n\nCreates and manages MCP tools and agent definitions.\n\n**Parameters:**\n- `task` (required): Management task (create, analyze, update)\n- `scope` (optional): Management scope\n- `agentType` (optional): Type of agent/tool\n- `capabilities` (optional): Required capabilities\n\n**Example:**\n```\nUse agent_manager to create a new tool for Docker containerization\n```\n\n**Context7 Queries:**\n- `mcp://context7/mcp/model-context-protocol`\n- `mcp://context7/mcp/tool-development`\n- `mcp://context7/typescript/zod-validation`\n\n## 🏗️ Architecture\n\n### MCP Server Structure\n\n```\nGeminiAutoPM/\n├── src/\n│   ├── agents/              # Agent implementations\n│   │   ├── code-analyzer.ts\n│   │   ├── test-runner.ts\n│   │   └── agent-manager.ts\n│   ├── types/               # TypeScript types\n│   │   └── agent.ts\n│   └── agents-server.ts     # Main MCP server\n├── gemini-extension.json    # Extension manifest\n├── GEMINI.md               # Persistent context\n└── package.json\n```\n\n### How It Works\n\n1. **Extension Loading**: Gemini CLI loads the extension and reads `GEMINI.md`\n2. **MCP Server Start**: The `agents-server.ts` starts via stdio transport\n3. **Tool Registration**: Three tools are registered with the MCP server\n4. **Tool Invocation**: Gemini model can invoke tools based on user requests\n5. **Result Processing**: Tool results are returned as structured content\n\n## 🔧 Development\n\n### Prerequisites\n\n- Node.js >= 20.0.0\n- npm >= 10.0.0\n- Gemini CLI installed\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/rafeekpro/GeminiAutoPM.git\ncd GeminiAutoPM\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Link for local development\ngemini extensions link .\n```\n\n### Testing\n\n```bash\n# Run tests\nnpm test\n\n# Watch mode\nnpm run test:watch\n\n# Coverage report\nnpm run test:coverage\n```\n\n### Project Commands\n\n```bash\nnpm run build          # Compile TypeScript to JavaScript\nnpm run dev            # Watch mode for development\nnpm test              # Run Jest tests\nnpm run test:coverage # Generate coverage report\n```\n\n## 📝 Framework Principles\n\n### 1. Context7 Integration (MANDATORY)\n\n**Always query Context7 documentation before implementing:**\n- Verify API signatures against live documentation\n- Apply current best practices\n- Follow industry standards\n\n### 2. Test-Driven Development (TDD)\n\n**All code follows TDD:**\n1. Write tests FIRST\n2. Implement functionality\n3. Refactor while keeping tests green\n4. Achieve comprehensive coverage\n\n### 3. Security First\n\n**Security is paramount:**\n- Use `code_analyzer` with security scope before releases\n- Follow OWASP and CWE standards\n- Validate all inputs\n- Handle errors gracefully\n\n## 🛠️ Configuration\n\n### Extension Manifest (gemini-extension.json)\n\n```json\n{\n  \"name\": \"gemini-autopm\",\n  \"version\": \"0.1.0\",\n  \"contextFileName\": \"GEMINI.md\",\n  \"mcpServers\": {\n    \"autopm-agents\": {\n      \"command\": \"node\",\n      \"args\": [\"${extensionPath}/dist/agents-server.js\"],\n      \"cwd\": \"${extensionPath}\"\n    }\n  }\n}\n```\n\n### User Settings (~/.gemini/settings.json)\n\nThe extension is automatically configured. No manual settings required.\n\n## 🤝 Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Follow TDD - write tests first\n4. Ensure all tests pass (`npm test`)\n5. Commit changes (`git commit -m 'Add amazing feature'`)\n6. Push to branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n### Development Guidelines\n\n- Follow TypeScript strict mode\n- Use Zod for input validation\n- Include Context7 documentation queries\n- Write comprehensive tests (80%+ coverage)\n- Add usage examples to tool descriptions\n- Update documentation\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## 🙏 Acknowledgments\n\n- Built on [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\n- Powered by [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- Inspired by [ClaudeAutoPM](https://github.com/rafeekpro/ClaudeAutoPM)\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](https://github.com/rafeekpro/GeminiAutoPM/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/rafeekpro/GeminiAutoPM/discussions)\n- **Documentation**: [Wiki](https://github.com/rafeekpro/GeminiAutoPM/wiki)\n\n## 🗺️ Roadmap\n\n### Phase 1: Core Foundation (Current)\n- ✅ MCP server with 3 core agent tools\n- ✅ Basic documentation and examples\n- ✅ Initial test coverage\n\n### Phase 2: Expanded Capabilities\n- [ ] Add 10 more specialized agent tools\n- [ ] Project management prompts (epic decomposition, task breakdown)\n- [ ] DevOps automation tools\n- [ ] Enhanced test analysis features\n\n### Phase 3: Advanced Features\n- [ ] Multi-server architecture\n- [ ] Custom command definitions (TOML)\n- [ ] Advanced Context7 integration\n- [ ] Docker sandbox support\n- [ ] CI/CD integration examples\n\n### Phase 4: Enterprise Features\n- [ ] Tool allowlisting and security controls\n- [ ] Performance optimization\n- [ ] Multi-project support\n- [ ] Advanced analytics and reporting\n\n## 🌟 Star History\n\nIf you find GeminiAutoPM useful, please consider giving it a star on GitHub!\n\n---\n\n**Made with ❤️ for the Gemini CLI community**\n",
  "bytes": 8490,
  "sha": "92acbb84ccd8ffd6c18b2f8f5c828403404d9bd65b3f28eddf16c6fbed95f2cd",
  "repo_slug": "dlee11r21-star/geminiautopm",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_dlee11r21_star_geminiautopm_cd7fdc98/readme"
}