Skills › Superpowers › diagnosing-superpowers › github-issues.md

github-issues.md

47 lines · skills/diagnosing-superpowers/references/github-issues.md at 2ce8aa1

1# GitHub issues

3Use `gh` when it is installed and authenticated; it handles auth, rate

4limits, and JSON. Fall back to the public API with curl, then to a URL

5your partner opens.

GitHub issues

Use gh when it is installed and authenticated; it handles auth, rate limits, and JSON. Fall back to the public API with curl, then to a URL your partner opens.

Raw lines 1 to 6

7## Search

9```bash

10gh search issues --repo obra/superpowers --limit 10 "<terms>" \

11 --json number,state,title --jq '.[] | "\(.number)\t\(.state)\t\(.title)"'

12```

14Without `gh` (unauthenticated, 10 requests a minute):

16```bash

17curl -s -H "Accept: application/vnd.github+json" \

18 "https://api.github.com/search/issues?q=repo:obra/superpowers+is:issue+<url-encoded terms>&per_page=10" \

19 | jq -r '.items[] | "\(.number)\t\(.state)\t\(.title)"'

20```

22Without curl, hand over `https://github.com/obra/superpowers/issues?q=<terms>`.

Search

gh search issues --repo obra/superpowers --limit 10 "<terms>" \
  --json number,state,title --jq '.[] | "\(.number)\t\(.state)\t\(.title)"'

Without gh (unauthenticated, 10 requests a minute):

curl -s -H "Accept: application/vnd.github+json" \
  "https://api.github.com/search/issues?q=repo:obra/superpowers+is:issue+<url-encoded terms>&per_page=10" \
  | jq -r '.items[] | "\(.number)\t\(.state)\t\(.title)"'

Without curl, hand over https://github.com/obra/superpowers/issues?q=<terms>.

Raw lines 7 to 23

24## File

26Write the filled `templates/issue.md` to the workspace and show the exact

27text. After approval:

29```bash

30gh issue create --repo obra/superpowers --title "<title>" --body-file <path> \

31 --label bug --label automated-issue-report

32```

34GitHub drops labels silently when the reporter lacks push access, so the

35labels land only for collaborators; the template footer still marks the

36issue as skill-filed. `gh` cannot attach files: give your partner the

37bundle path to attach through the browser after the issue exists.

39Without `gh`, hand over a prefilled link on the `bug_report.md` template,

40which applies the `bug` label for any reporter:

42```

43https://github.com/obra/superpowers/issues/new?template=bug_report.md&title=<url-encoded title>&body=<url-encoded body>

44```

46GitHub rejects URLs over about 8,000 characters; past that, send the link

47with the title only and tell your partner to paste the body from the file.

File

Write the filled templates/issue.md to the workspace and show the exact text. After approval:

gh issue create --repo obra/superpowers --title "<title>" --body-file <path> \
  --label bug --label automated-issue-report

GitHub drops labels silently when the reporter lacks push access, so the labels land only for collaborators; the template footer still marks the issue as skill-filed. gh cannot attach files: give your partner the bundle path to attach through the browser after the issue exists.

Without gh, hand over a prefilled link on the bug_report.md template, which applies the bug label for any reporter:

https://github.com/obra/superpowers/issues/new?template=bug_report.md&title=<url-encoded title>&body=<url-encoded body>

GitHub rejects URLs over about 8,000 characters; past that, send the link with the title only and tell your partner to paste the body from the file.

Raw lines 24 to 47