Claude Issue Solver is an innovative command-line interface (CLI) tool that automates the resolution of GitHub issues using Claude Code. This tool streamlines the development workflow by allowing developers to fetch issues from a repository, create a worktree for each issue, and utilize Claude Code in a separate terminal for solving them. Once the task is completed, a pull request (PR) is created automatically, enhancing productivity and efficiency in addressing project challenges.

Key Features

• Interactive Issue Selection: Navigate through open issues using intuitive arrow-key navigation, with options to hide issues that already have pending PRs.
• Rapid Issue Creation and Resolution: Quickly create new issues and begin solving them immediately.
• Worktree Isolation: Each issue is assigned its own worktree, enabling parallel handling of multiple issues without conflicts.
• Real-time PR Generation: Automatically creates or updates pull requests as changes are committed by Claude, ensuring the latest updates are always reflected.
• Smart Cleanup Functionality: Automatically cleans merged PRs and closes the relevant VS Code or terminal windows on macOS.
• Monorepo Compatibility: Recursively manages .env* files and symlinks node_modules, making it ideal for expansive projects with multiple components.
• Cross-Platform Terminal Support: Compatible with various terminal applications including iTerm2 and gnome-terminal, providing flexibility across macOS and Linux environments.

Usage Examples

To leverage the capabilities of Claude Issue Solver, several commands can be utilized within any Git repository that supports GitHub issues:

# Start interactive mode to solve an issue
claude-issue

# Directly solve a specific issue
claude-issue 42

# List all open issues
claude-issue list

# Create and start solving a new issue
claude-issue new "Add dark mode support"

How the Tool Operates

1. Fetches Issue Data: Retrieves the title and description of a selected issue from GitHub.
2. Worktree Creation: Establishes a dedicated git worktree using a designated branch name.
3. Environment Setup: Automatically copies necessary environment files and creates symlinks for node_modules.
4. Claude Code Activation: Opens a new terminal window where Claude Code can run, focused on the specific issue content.
5. Dynamic PR Management: A background process monitors changes, auto-generating a pull request upon the first commit and updating it with further commits.
6. Interactive User Experience: Offers a real-time session with Claude to allow for adjustments and requests during the coding process.

Claude Issue Solver brings efficiency to issue resolution in software development, empowering teams to respond swiftly to bugs and feature requests, while harnessing the capabilities of AI through Claude Code.