Claude Issue Agent

claude-issue-agent

Drive local Claude Code from GitHub issues. Keep developing while away from the machine, without using Claude's cloud or remote sessions.

You (phone) open an issue, label it claude-ukk
        │
        ▼
poll.sh watches GitHub from your machine
        │
        ▼
run-task.sh
   1. git fetch, pulling your own commits into the worktree
   2. claude -p  ──first turn --session-id / later --resume──> one session
   3. git commit + push to claude/issue-
   4. open a PR on the first push
   5. post Claude's summary back to the issue
        │
        ▼
You (phone) read the PR, comment → next turn
        Comment mid-run → the turn is cut off and redirected

What it does

• Label routing — claude- decides which machine takes the work, so several machines can watch one repository
• Label picks the model — sonnet-5-low, opus-4-6-max, one tap on a phone. Setup creates only the routing label; model labels are opt-in via ctl.sh labels, so the repository's shared label list stays yours
• One issue, one session — the session id is md5(repo#N), so it survives lost state and reboots
• Interruptible — comment while a turn runs and it is cut off within ~10s, continuing the same session in a new direction; prefix a comment with // to leave a note that neither triggers nor interrupts anything
• Live progress — each text block Claude emits is posted as its own comment so it actually notifies, then collapsed once the real reply lands
• Sandboxed — Bash confined to the issue's worktree, network open, ~/.ssh ~/.aws ~/.gnupg unreadable

Install

Add the public Skill repository in CC Switch, install `claude-issue-agent`, and enable it for the required clients. The installed copy is the runtime source; do not link a development checkout directly.

Then ask an agent to set it up. It asks three questions — machine codename, permission mode, repository — and configures everything.

Manual