Manage the GitHub issues backlog. Bridge between GitHub Issues and local task management.
Commands
Parse $ARGUMENTS to determine the action:
show (default — when no argument or show)
- •Run
gh issue list --state open --limit 20to get open issues. - •Group by priority label (
P0-critical,P1-high,P2-medium,P3-low, unlabeled). - •Present a summary:
code
## Open Issues ### P0 — Critical - #12 Fix auth token expiration (bug, in-progress) ### P1 — High - #8 Add rate limiting to API (feature, ready) - #11 Database migration fails on empty tables (bug, ready) ### P2 — Medium - #3 Refactor config loader (refactor, needs-triage) ### Unprioritized - #14 Update README examples (task) **Total**: 5 open issues
new
Create a new GitHub issue interactively:
- •Ask the user for:
- •Title (required)
- •Type — bug, feature, task, chore, or refactor (maps to label)
- •Priority — P0-P3 (maps to label)
- •Description (required)
- •Acceptance criteria (optional)
- •Create with
gh issue create --title "..." --body "..." --label "type,priority,needs-triage" - •Report the issue URL.
pick #N
Start working on issue #N:
- •Run
gh issue view Nto get the issue details. - •Create a branch:
git checkout -b <type>/<N>-<short-title>(derive type from label, slugify the title). - •Add
in-progresslabel, removereadylabel:gh issue edit N --add-label "in-progress" --remove-label "ready" - •Write the issue description and acceptance criteria into
tasks/todo.mdas a plan. - •Present the plan and ask the user to confirm before starting implementation.
close #N
Close issue #N:
- •Run
gh issue view Nto get context. - •Ask the user for a brief summary of what was done.
- •Add a closing comment with the summary:
gh issue comment N --body "..." - •Close the issue:
gh issue close N --reason completed - •Remove
in-progresslabel if present.
Rules
- •Always show issue numbers so the user can reference them.
- •If
ghis not available or not authenticated, say so and suggestgh auth login. - •For
pick, always verify there are no uncommitted changes before creating a branch. - •For
pick, use the branch naming convention:<type>/<issue-number>-<short-slug>(e.g.,feat/8-rate-limiting,fix/12-auth-token). - •Keep
tasks/todo.mdas the working plan — issues are the backlog, todo.md is the active session plan.