agnostic-ai-gh-issues

GitHub Issues Watcher

Purpose

Process every open GitHub issue that is unassigned or assigned to the current user (@me) through the agnostic-ai-gh-issue skill. Record blockers and continue independent issues when the worktree is safe.

Args

• --limit N: process at most N issues this run (default: all).
• --label foo: only issues carrying label foo.
• --dry-run: list issues that would be processed; do not invoke agnostic-ai-gh-issue.

Phase 1: Discover

Fetch open issues that are unassigned or assigned to @me, oldest first. GitHub search does not OR these cleanly, so run two queries and merge:

# Unassigned
gh issue list \
  --state open \
  --search "no:assignee" \
  --json number,title,labels,assignees,createdAt \
  --limit 200

# Assigned to me
gh issue list \
  --state open \
  --assignee "@me" \
  --json number,title,labels,assignees,createdAt \
  --limit 200

Merge:

• If either query returns 200 rows, repeat it with a larger --limit until the result count falls below that limit.
• Deduplicate by number.
• Keep only issues whose assignees array is empty or contains the current user (gh api user -q .login).
• Drop issues assigned to anyone else (a safety check).
• Apply --label filter if given.
• Apply --limit if given.
• Sort ascending by createdAt (oldest first).

Print the queue: #<num> <title> [assignee] per line, where [assignee] is unassigned or @me. If empty, exit cleanly.

Phase 2: Worktree Sanity

Before touching any issue:

test -z "$(git status --porcelain)" || exit 1
git fetch origin main
git switch main
test "$(git rev-list --count origin/main..main)" -eq 0 || exit 1
git pull --ff-only

Abort if the worktree is dirty or local main is ahead of origin/main. Never auto-stash or discard local commits.

Phase 3: Process Loop

For each issue in the queue:

1. Re-check assignment state (someone else may have grabbed it):

   gh issue view <num> --json assignees -q '.assignees[].login'
   me=$(gh api user -q .login)
   

   • Empty output → unassigned, proceed.
   • Only $me listed → already mine, proceed (skip self-assign step).
   • Any other login present → skip this issue.