issuebeam
Issuebeam is a lightweight, open-source skeleton that bridges AI coding agents with GitHub Issues, ensuring that tasks, bugs, and ideas discussed in chat are formalized into trackable issues. It provides a cross-platform Python CLI script and platform-specific instruction files (for Cursor, Claude Code, Copilot, etc.) that force the agent to directly create, comment, and close issues on GitHub. The script uses only Python's standard library (urllib) to communicate with the GitHub REST API, requiring only a Personal Access Token with Issues read/write permissions, and eliminates the need for the gh CLI or PowerShell scripts. When a user instructs an AI agent to track a bug or open an issue, the agent executes `python scripts/github_issue.py` with the provided details, automatically creating an issue with appropriate labels. This process turns natural language requests into official, shareable backlog items that are visible to the entire team, supporting web templates, label filtering, and auto-close via pull request references (e.g., `Fixes #N`). The tool is designed for 'vibe coders' and fast iteration environments where context can be lost in chat logs. It works on Windows, macOS, and Linux, and can be easily adopted into any existing repository using a provided adoption script that copies the CLI, instruction files, issue templates, and labels, and sets the target repo slug. Token management is handled via environment variables or a gitignored .env file, with additional Windows support for reading from the registry if needed. Issuebeam promotes a structured development workflow where GitHub Issues serves as the single source of truth, helping teams maintain organization and accountability without disrupting their AI-assisted coding experience.
- Category
- Bots
- Pricing
- Free
Problem solved
AI coding assistants often leave task tracking buried in chat history, causing bugs and ideas to be forgotten. Issuebeam solves this by directly connecting AI agents to GitHub Issues, turning natural language commands into structured, trackable issues in the official project backlog.
Use cases
- Automatically create GitHub issues from AI agent chat conversations
- Manage project backlogs by prompting agents to list, update, or close issues
- Standardize issue tracking across different AI coding assistants (Cursor, Claude Code, Copilot, etc.)
- Adopt into existing repositories to enable AI-driven issue management on Windows, macOS, and Linux
- Enable non-technical stakeholders to create issues via the AI agent in natural language
Audience
- Developers
- ML Engineers
- Startups
- Hobbyists
Pros
- Stdlib-only Python script with no external dependencies
- Supports multiple AI coding agents (Cursor, Claude Code, Copilot, etc.)
- Cross-platform (Windows, macOS, Linux)
- Easy adoption with a single script into any repo
- Open source (MIT) with clear instructions
Cons
- Requires Python and a GitHub token setup
- Limited to GitHub Issues (no GitLab, Jira, etc.)
- May need manual customization for different agent platforms
- Not a standalone application; requires installation into a repo
- Relies on environment variable or .env for token security
Official website: https://issuebeam.github.io/
Canonical LambdaBase page: https://www.lambdabase.com/tools/issuebeam