{"id":30635405,"url":"https://github.com/i-am-bee/beeai-issue-creator","last_synced_at":"2025-08-30T22:32:45.048Z","repository":{"id":311612858,"uuid":"1044276104","full_name":"i-am-bee/beeai-issue-creator","owner":"i-am-bee","description":"Multi-agent system for drafting and managing GitHub issues. Built with BeeAI Framework, integrated via GitHub MCP, and consumable through BeeAI Platform CLI \u0026 UI via A2A.","archived":false,"fork":false,"pushed_at":"2025-08-28T14:15:43.000Z","size":183,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-28T21:32:24.266Z","etag":null,"topics":["a2a","automation","beeai","github-issues","mcp","multi-agent"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/i-am-bee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2025-08-25T12:49:38.000Z","updated_at":"2025-08-28T14:15:47.000Z","dependencies_parsed_at":"2025-08-25T15:28:18.306Z","dependency_job_id":"76ec04d8-ff67-41f2-b3ef-ae74012473eb","html_url":"https://github.com/i-am-bee/beeai-issue-creator","commit_stats":null,"previous_names":["matoushavlena/beeai-issue-creator","i-am-bee/beeai-issue-creator"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/i-am-bee/beeai-issue-creator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-issue-creator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-issue-creator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-issue-creator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-issue-creator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i-am-bee","download_url":"https://codeload.github.com/i-am-bee/beeai-issue-creator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i-am-bee%2Fbeeai-issue-creator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272917687,"owners_count":25014933,"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-08-30T02:00:09.474Z","response_time":77,"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":["a2a","automation","beeai","github-issues","mcp","multi-agent"],"created_at":"2025-08-30T22:32:41.220Z","updated_at":"2025-08-30T22:32:45.041Z","avatar_url":"https://github.com/i-am-bee.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BeeAI Issue Creator\n\n\u003e [!WARNING]\n\u003e This project is in early beta stage. Expect bugs and breaking changes.\n\nA multi-agent system for creating well-structured GitHub issues using the [BeeAI Framework](https://framework.beeai.dev/experimental/requirement-agent). This system coordinates between specialized agents to draft issues, check for duplicates, and create final GitHub issues with customizable templates. The system is consumable via the [BeeAI Platform](https://beeai.dev) (UI and CLI) through the A2A protocol.\n\n✅ Multi-agent workflow  \n🔄 Real-time trajectory tracking  \n📝 Customizable issue templates\n\n## What is BeeAI Issue Creator?\n\nThe BeeAI Issue Creator orchestrates a multi-step workflow using specialized agents:\n\n- **Project Manager**: Coordinates the entire workflow and manages agent handoffs\n- **Technical Writer**: Creates structured issue drafts from user input using templates, grounded with project documentation for technical accuracy\n- **Analyst**: Searches for existing similar issues to prevent duplicates\n\nThis gives you consistent, professional GitHub issues while preventing duplicates and maintaining quality standards. The system integrates with GitHub through the [GitHub MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/github) for seamless repository interactions.\n\n## Use Cases\n\nPerfect for:\n- Automated issue creation from user reports\n- Maintaining consistent issue formatting across repositories\n- Preventing duplicate issues through intelligent search\n- Multi-step workflows with user approval gates\n\n## Agents Included\n\n🎯 **[Project Manager](src/agents/agent_manager.py)** - Manages the complete issue lifecycle from draft to creation  \n📝 **[Technical Writer](src/agents/agent_writer.py)** - Creates structured issues using customizable templates  \n🔍 **[Analyst](src/agents/agent_analyst.py)** - Searches for similar existing issues\n\n## Features\n\n- **Template Support**: Bug report and feature request templates\n- **Documentation Grounding**: Technical Writer uses project documentation for technical accuracy\n- **GitHub Integration**: Seamless interaction through GitHub MCP server\n- **Trajectory Tracking**: Real-time visibility into agent interactions and tool usage\n- **Duplicate Prevention**: Intelligent search for existing similar issues\n- **User Approval**: Human-in-the-loop workflow with approval gates\n- **Conditional Requirements**: Enforced workflow steps and dependencies\n\n## Quickstart\n\n```bash\n# Install dependencies\nuv sync --group dev\n\n# Copy and edit environment variables\ncp .env.example .env\n# Set your MODEL, API_KEY, GITHUB_PAT, and templates in .env\n\n# Start the agent server\nuv run server\n```\n\nThe server will start on `http://127.0.0.1:8000` and register the GitHub Issue Creator agent that coordinates the complete workflow.\n\n## Security Considerations\n\n\u003e [!WARNING]\n\u003e **Important Security Notes:**\n\u003e \n\u003e - **GitHub Token Scoping**: It is **critical** to scope your GitHub Personal Access Token (GITHUB_PAT) to only the specific repositories you intend to use with this system. Do not use tokens with broad repository access.\n\u003e \n\u003e - **Approval Feature Not Functional**: The user approval/permission feature is currently not working correctly. This means the agent **will create GitHub issues without explicit user approval**. Review all generated content carefully and ensure your GitHub token has appropriate restrictions.\n\n## Configuration\n\n### Environment Variables\n\nConfigure the system using environment variables:\n\n```bash\n# Model Configuration\nMODEL=openai:gpt-5-nano\nAPI_KEY=your_api_key_here\n\n# GitHub Configuration  \nGITHUB_PAT=your_github_personal_access_token\nGITHUB_REPOSITORY=owner/repository-name\n\n# Documentation for issue grounding (optional)\nDOCS_URL=https://example.com/llms-full.txt\n\n# Issue Templates (URLs preferred)\nTEMPLATE_BUG_URL=\"https://raw.githubusercontent.com/user/repo/main/.github/ISSUE_TEMPLATE/bug_report.md\"\nTEMPLATE_FEATURE_URL=\"https://raw.githubusercontent.com/user/repo/main/.github/ISSUE_TEMPLATE/feature_request.md\"\n\n# Alternative: Direct template content\nTEMPLATE_BUG=\"your bug report template...\"\nTEMPLATE_FEATURE=\"your feature request template...\"\n```\n\n## Workflow\n\n1. **User Input**: Describe the bug or feature request\n2. **Draft Creation**: Technical Writer creates structured draft using templates\n3. **Duplicate Check**: Analyst searches for similar existing issues\n4. **User Review**: User reviews and approves the draft\n5. **Issue Creation**: Final GitHub issue is created with proper formatting\n\n## Development\n\n```bash\n# Install development dependencies\nuv sync --group dev\n\n# Run linting\nuv run ruff check\n\n# Run formatting\nuv run ruff format\n```\n\n## Architecture\n\nThe system uses the BeeAI Framework's Requirement Agent with:\n- **Conditional Requirements**: Enforced workflow sequence\n- **Handoff Tools**: Agent-to-agent delegation\n- **Permission Requirements**: User approval gates\n- **Trajectory Middleware**: Real-time progress tracking\n\n## Documentation\n\nFor more information on the BeeAI Framework: https://framework.beeai.dev\n\n## Roadmap\n\n- [x] **Improve multi-turn conversations** - Better context handling across multiple interactions\n- [ ] **Add evaluation datasets** - Comprehensive testing with real-world issue examples  \n- [ ] **MCP direct repository configuration** - Pre-configure the MCP tool with repository settings instead of relying on LLM to pass repository name\n- [ ] **Improve agent configuration** - Configure GitHub repository from BeeAI Platform UI\n- [x] **Improve trajectory metadata** - Enhanced progress tracking and debugging capabilities\n- [ ] **Add RAG instead of grounding** - Dynamic document retrieval for better context\n- [ ] **Add streaming support** - Real-time response streaming for better UX\n- [ ] **Build as Docker image** - Containerized deployment for easier hosting\n- [ ] **Elicitation support** - Interactive tool use approval and clarification workflows\n- [ ] **Artefact support** - Enable rich content generation and interactive editing capabilities\n\n## Contributing\n\nFeel free to submit improvements, additional templates, or new agent capabilities via pull requests.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-am-bee%2Fbeeai-issue-creator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi-am-bee%2Fbeeai-issue-creator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi-am-bee%2Fbeeai-issue-creator/lists"}