name	create-issue
description	Create a GitHub issue linked to a milestone, team, and optionally a parent issue
argument-hint	<title> [--milestone <name-or-number>] [--team <name>] [--parent <issue-number>] [--label <label>]
disable-model-invocation	true

Create Issue

Create a GitHub issue in amaralc/explore and link it to a milestone, project team, and optionally a parent issue (sub-issue).

Available context

Milestones

!gh api repos/amaralc/explore/milestones --jq '.[] | "#\(.number) \(.title)"' 2>/dev/null

Labels

!gh api repos/amaralc/explore/labels --jq '.[].name' 2>/dev/null | tr '\n' ', '

Project Teams

!gh api graphql -f query='{ node(id: "PVT_kwHOAergc84BAFUg") { ... on ProjectV2 { fields(first: 30) { nodes { ... on ProjectV2SingleSelectField { name options { id name } } } } } } }' --jq '.data.node.fields.nodes[] | select(.name == "Team") | .options[] | "\(.name) (\(.id))"' 2>/dev/null

Arguments

Parse the following arguments from $ARGUMENTS:

Title: The issue title (required, first positional argument or quoted string)
--milestone: Milestone name or number (optional)
--team: Project team name — one of: kernel, people, things (optional)
--parent: Parent issue number for sub-issue linking (optional)
--label: Label to apply, can be repeated (optional)
--body: Issue body content (optional, if not provided generate a reasonable body based on the title and labels)

Procedure

Follow these steps exactly:

1. Create the issue

gh issue create --repo amaralc/explore \
  --title "<title>" \
  --label "<label>" \
  --milestone "<milestone-title>" \
  --body "<body>"

Capture the issue URL and extract the issue number.

2. Add to Explore project and set team

If --team is provided:

Get the issue node ID:

gh api repos/amaralc/explore/issues/<number> --jq '.node_id'

Add to the Explore project (ID: PVT_kwHOAergc84BAFUg):

gh api graphql -f query='mutation { addProjectV2ItemById(input: {projectId: "PVT_kwHOAergc84BAFUg", contentId: "<node_id>"}) { item { id } } }'

Set the Team field (field ID: PVTSSF_lAHOAergc84BAFUgzgy_nmQ) using the option ID from the context above:

gh api graphql -f query='mutation { updateProjectV2ItemFieldValue(input: {projectId: "PVT_kwHOAergc84BAFUg", itemId: "<item_id>", fieldId: "PVTSSF_lAHOAergc84BAFUgzgy_nmQ", value: {singleSelectOptionId: "<option_id>"}}) { projectV2Item { id } } }'

3. Link as sub-issue (if --parent provided)

Get the parent issue node ID:

gh api repos/amaralc/explore/issues/<parent_number> --jq '.node_id'

Link using the addSubIssue mutation:

gh api graphql -f query='mutation { addSubIssue(input: {issueId: "<parent_node_id>", subIssueId: "<child_node_id>"}) { issue { id } subIssue { id } } }'

4. Report results

Print a summary with:

Issue URL
Milestone
Team assignment
Parent issue link (if applicable)

name	create-issue
description	Create a GitHub issue linked to a milestone, team, and optionally a parent issue
argument-hint	<title> [--milestone <name-or-number>] [--team <name>] [--parent <issue-number>] [--label <label>]
disable-model-invocation	true

Create Issue

Create a GitHub issue in amaralc/explore and link it to a milestone, project team, and optionally a parent issue (sub-issue).

Available context

Milestones

!gh api repos/amaralc/explore/milestones --jq '.[] | "#\(.number) \(.title)"' 2>/dev/null

Labels

!gh api repos/amaralc/explore/labels --jq '.[].name' 2>/dev/null | tr '\n' ', '

Project Teams

Arguments

Parse the following arguments from $ARGUMENTS:

Title: The issue title (required, first positional argument or quoted string)
--milestone: Milestone name or number (optional)
--team: Project team name — one of: kernel, people, things (optional)
--parent: Parent issue number for sub-issue linking (optional)
--label: Label to apply, can be repeated (optional)
--body: Issue body content (optional, if not provided generate a reasonable body based on the title and labels)

Procedure

Follow these steps exactly:

1. Create the issue

gh issue create --repo amaralc/explore \
  --title "<title>" \
  --label "<label>" \
  --milestone "<milestone-title>" \
  --body "<body>"

Capture the issue URL and extract the issue number.

2. Add to Explore project and set team

If --team is provided:

Get the issue node ID:

gh api repos/amaralc/explore/issues/<number> --jq '.node_id'

Add to the Explore project (ID: PVT_kwHOAergc84BAFUg):

gh api graphql -f query='mutation { addProjectV2ItemById(input: {projectId: "PVT_kwHOAergc84BAFUg", contentId: "<node_id>"}) { item { id } } }'

Set the Team field (field ID: PVTSSF_lAHOAergc84BAFUgzgy_nmQ) using the option ID from the context above:

gh api graphql -f query='mutation { updateProjectV2ItemFieldValue(input: {projectId: "PVT_kwHOAergc84BAFUg", itemId: "<item_id>", fieldId: "PVTSSF_lAHOAergc84BAFUgzgy_nmQ", value: {singleSelectOptionId: "<option_id>"}}) { projectV2Item { id } } }'

3. Link as sub-issue (if --parent provided)

Get the parent issue node ID:

gh api repos/amaralc/explore/issues/<parent_number> --jq '.node_id'

Link using the addSubIssue mutation:

gh api graphql -f query='mutation { addSubIssue(input: {issueId: "<parent_node_id>", subIssueId: "<child_node_id>"}) { issue { id } subIssue { id } } }'

4. Report results

Print a summary with:

Issue URL
Milestone
Team assignment
Parent issue link (if applicable)

create-issue

Create Issue

Available context

Milestones

Labels

Project Teams

Arguments

Procedure

1. Create the issue

2. Add to Explore project and set team

3. Link as sub-issue (if --parent provided)

4. Report results

Create Issue

Available context

Milestones

Labels

Project Teams

Arguments

Procedure

1. Create the issue

2. Add to Explore project and set team

3. Link as sub-issue (if --parent provided)

4. Report results