Claude Queue

claude-queue

A CLI tool that solves GitHub issues using [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It picks up open issues from your repo, solves them one by one, and opens a pull request with all the fixes. It can also create well-structured GitHub issues from a text description or interactive interview.

The typical workflow is: open issues for whatever you need done, run `claude-queue`, and come back to a pull request with everything solved. I usually do this at night and review the PR in the morning.

Issues don't have to be code changes — they can be investigative tasks like "figure out why the API is slow and document what you find" or "audit the codebase for accessibility issues". Claude will research, document findings, and commit whatever it produces.

Prerequisites

• GitHub CLI (gh) — authenticated
• Claude Code (claude) — installed and configured
• git and jq

Install

npm install -g claude-queue

Or run directly:

npx claude-queue

Usage

Solving issues

Run from inside any git repository with GitHub issues:

claude-queue

Flag	Default	Description
--issue ID	all issues	Solve specific issue(s) by ID, URL, or comma-separated IDs
--max-retries N	3	Max retry attempts per issue before marking it failed
--max-turns N	50	Max Claude Code turns per attempt
--label LABEL	all issues	Only process issues with this label (can be repeated)
--branch BRANCH	new daily branch	Work on this branch instead of creating a new one per run
--model MODEL	CLI default	Claude model to use (e.g. claude-sonnet-4-5-20250929)

By default each run creates a fresh `claude-queue/` branch. Pass `--branch` to commit onto an existing branch instead — it's checked out if it exists locally or on the remote, otherwise created from