gh project item-list adds named field columns

Introduced 2026-07-31 · score 0.97

HOW TO USE IT

When listing project items with selected project fields as columns, run `gh project item-list` with the project number, owner, and one `--field` per field name.

WHY THIS HELPS

List project items with selected project fields displayed as columns.

REQUIREMENTS AND LIMITATIONS

• Version: v2.97.0
• <number>: Project number; the documented example uses `1`.
• --owner <string>: Owner login; use `@me` for the current user.
• --field <stringArray>: Name of a field to show as an extra column; repeat once per field.
• Prerequisite: GitHub CLI authentication must have the `project` scope; verify with `gh auth status` or add it with `gh auth refresh -s project`.

FIRST-PARTY EVIDENCE

• https://github.com/cli/cli/releases/tag/v2.97.0
• https://github.com/cli/cli/blob/v2.97.0/pkg/cmd/project/item-list/item_list.go
• https://cli.github.com/manual/gh_project_item-list
• https://cli.github.com/manual/gh_project

Check the installed version and the source before using it. Entry JSON

Report a problem with this card