Issue Tracker for Claude Code

Issue Tracker for Claude Code

Issue Tracker for Claude Code is a powerful Visual Studio Code extension designed to enhance productivity when working with AI coding assistants like Claude Code, Gemini, and other CLI-based LLMs. This tool allows developers to manage multiple coding tasks simultaneously, eliminating the bottleneck of waiting for AI responses one at a time.

Benefits

Parallel Processing

Run multiple AI sessions at the same time. You can configure the number of terminals (from 1 to 9) to suit your workflow, allowing you to handle several tasks concurrently.

Real-time Monitoring

The split view feature shows all active AI terminals, enabling you to see at a glance what each AI is working on and when it needs your attention.

Non-blocking Workflow

Add new issues while others are being processed. This means you can keep working without being stuck waiting for AI responses.

File-based Storage

Issues are stored as markdown files, making it easy to track changes and maintain version control.

Smart Queue Management

Issues automatically move through different states: New, Working, and Done. This helps you keep track of progress without manual intervention.

Visual Status Indicators

Color-coded badges show the status of each issue, making it easy to see at a glance which tasks are completed, in progress, or pending.

Use Cases

Large Refactoring Projects

Queue multiple files or components for AI to refactor while you review the completed ones. This allows you to make significant progress quickly.

Bug Fix Marathons

Add all bugs as issues and let the AI work through them in parallel. This speeds up the debugging process and helps you fix multiple issues efficiently.

Feature Implementation

Break down features into small tasks and process them concurrently. This ensures that all parts of a feature are developed simultaneously, speeding up the overall development process.

Code Reviews

Have the AI review multiple files at the same time. This helps you catch errors and improve code quality more efficiently.

Documentation Updates

Queue multiple files for documentation improvements. This ensures that all documentation is up-to-date and accurate.

How It Works

1. Add Issues: Type your coding task in the input field (e.g., "Fix the login validation bug in auth.js").
2. Automatic Processing: Issues are automatically picked up by available AI terminals.
3. Monitor Progress: Watch all terminals in split view to see exactly what each AI is doing.
4. Manage States: Issues automatically move from New to Working to Done.
5. Archive Completed: Clean up by archiving completed issues.

Configuration

Access settings through the gear icon in the Issue Tracker panel:

Terminal Count

Set the number of simultaneous AI terminals (1-9).

Terminal Command

Configure the command template to run (default:claude {{issue_content}}). This works with any CLI-based AI, such asgemini {{issue_content}}orgpt {{issue_content}}.

Extra Instructions

Add additional context to each issue, such as specific guidelines or requirements.

Usage

1. Click the Issue Tracker icon in the Activity Bar.
2. Add issues using the input field at the bottom.
3. ClickStart Processingto begin.
4. Monitor all active terminals in the split view.
5. Issues automatically progress through states.
6. Archive completed issues with the archive button.

Directory Structure

Your workspace will have the following directory structure:

your-workspace/issues/new/ # New issues waiting to be processedworking/ # Issues currently being worked on by AIdone/ # Completed issuesarchived/ # Archived issues (hidden from UI)

Workflow Example

1. Morning Sprint: Add 10 bug fixes as separate issues.
2. Hit Play: Start processing with 4 terminals.
3. Monitor: See all 4 AIs working in split view.
4. Respond: When an AI needs clarification, you see it immediately.
5. Continue: Add more issues while others process.
6. Review: Check completed issues and archive when satisfied.

Installation

Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter:

extension install Issue Tracker for Claude Code