Skip to content

gh project item-edit/item-list: address fields, options, and items by name #13816

Closed

Description

@zwick

Describe the feature or problem you’d like to solve

gh project item-edit and item-list currently require ProjectV2 node IDs for the project, item, field, and single-select option. Getting those IDs means extra field-list/item-list preflight calls and copy-pasting opaque IDs, which is especially painful for scripting and for agents driving gh. Every other gh project verb that touches items (e.g. item-add) already accepts a human-readable [<number>] --owner --url addressing scheme, so item-edit is the odd one out.

Proposed solution

Add additive, backward-compatible name-based addressing that mirrors item-add:

gh project item-edit <number> --owner monalisa \
  --url https://github.com/monalisa/myproj/issues/23 \
  --field "Status" --value "In Progress"

gh project item-list <number> --owner monalisa --field "Status"
  • Existing --id/--field-id/--project-id flags are untouched; name flags are opt-in.
  • --value is dispatched by the field's data type; for single-select it resolves the option name.
  • Name matching is case-insensitive, mirroring the Projects v2 platform API.
  • Resolution happens before the mutation, so bad names fail loudly with candidate lists instead of 400 [].

Benefits CLI users (no more ID spelunking for a one-line edit) and unblocks agent/automation workflows that address Projects by name.

Additional context

Activity

  1. added
    enhancementa request to improve CLI
    gh-projectrelating to the gh project command
    and removed on Jul 17, 2026
  2. github-actions commented on Jul 17, 2026

    @github-actions
    Contributor

    Thank you for your issue! We have categorized it as an enhancement (feature or improvement) request, and it has been added to our backlog. In doing so, we are not committing to implementing this feature at this time, but, we will consider it for future releases based on community feedback and our own product roadmap.

    Unless you see the help wanted Contributions welcome label, we are not currently looking for external contributions for this feature.

    If you come across this issue and would like to see it implemented, please add a thumbs up! This will help us prioritize the feature. Please only comment if you have additional information or viewpoints to contribute.

  3. zwick commented on Aug 3, 2026

    @zwick
    ContributorAuthor

    Closed this issue, the feature was included in the 2.97.0 release 🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementa request to improve CLIgh-projectrelating to the gh project command

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions