arthai-marketplace

/issue

Create, close, list, and remind on GitHub issues.

Synopsis

/issue <title>, /issue close #N, /issue list, /issue status, /issue remind, /issue update #N

When to use it

Quickstart

/issue Fix login redirect loop on Safari

What you’ll see: an issue created with a ## Task one-liner and 2–5 acceptance-criteria checkboxes (a short checklist of concrete conditions that define when the issue is “done”), attached to the most recent open milestone if one exists, and the issue URL reported back. If no assignee is given or inferable, it asks who to assign.

Examples

/issue Fix login bug --assign sam            # create + assign
/issue Set up CI --milestone "Launch Prep"   # create + attach to a milestone
/issue fix auth bug --assign sam, add dark mode --assign ana   # two issues at once
/issue close #270                            # close (also: /issue done #270)
/issue close #270 fixed by PR #456           # close with a reason — added to the close comment
/issue list                                  # open issues in the current milestone
/issue list sam                              # open issues assigned to sam only
/issue status                                # milestone progress: X/Y done, days remaining
/issue remind                                # post milestone status + open issues
/issue remind ana                            # reminder for one person's issues only
/issue update #270 waiting on API key        # add a comment to an issue
/issue update #270 --title "Urgent: login bug"  # retitle an issue

Blank /issue (no title) prompts you interactively for what the issue should be about.

Arguments & flags

Command What it does
/issue <title> Create a new issue (body auto-generated with acceptance criteria)
--assign <user> Assign on creation; if ambiguous and omitted, it asks
--milestone "Name" Attach to a milestone; defaults to the most recent open one
/issue close #N [reason] / done #N Close one or more issues; any reason you add is included in the close comment
/issue list [username] Open issues, optionally filtered by person
/issue status Milestone progress summary
/issue remind [username] Post a reminder of open issues
/issue update #N <comment> Comment on an issue; --title "..." updates the title

What it does

  1. Parses your input — title, assignee, milestone; multiple comma- or line-separated issues are created in parallel.
  2. Generates the body — a ## Task one-liner plus a ## Acceptance Criteria checklist (always included).
  3. Creates via gh — gh issue create, then attaches the milestone (specified, or the most recent open one). If the assignee is ambiguous, it asks you first — user-confirmation checkpoint.
  4. Reports the URL back so you can open it immediately.
  5. Close / list / status / remind / update subcommands map directly onto gh issue close|list|comment|edit and the milestone API, formatted as clean tables.

Output & artifacts

Troubleshooting

Problem Fix
gh: command not found or auth errors Install the GitHub CLI and run gh auth login
Issue created without a milestone No open milestone exists — create one in GitHub or pass --milestone "Name"
/issue close all done asks instead of closing By design — it lists the milestone’s open issues and asks which to close
Wrong repository targeted /issue operates on the current directory’s repo — cd to the right project first