Skip to content

List a parent's sub-issues with the list_sub_issues tool

Goal: see a parent issue’s sub-issues and how much of its work is complete.

  • The parent issue exists (it may have zero sub-issues — the tool still returns a valid, empty-total result).
  1. Call list_sub_issues:

    { "owner": "your-org", "repo": "your-repo", "parentNumber": 101 }
  2. Read the response:

    {
    "total": 2,
    "completed": 1,
    "percentCompleted": 50,
    "items": [
    { "number": 102, "nodeId": "...", "title": "Redesign the welcome email", "state": "CLOSED" },
    { "number": 103, "nodeId": "...", "title": "Add a product tour", "state": "OPEN" }
    ]
    }
  • total/completed/percentCompleted come from GitHub’s own subIssuesSummary, so they match what the parent issue’s UI panel shows.
  • Close or reopen a listed sub-issue on GitHub, call the tool again, and confirm completed/percentCompleted update — this is GitHub-computed state, not anything this plugin tracks separately.

See also: tool reference.