Skip to content

[cli-consistency] CLI Consistency Issues - 2026-10-06 #66169

Description

@github-actions

Summary

Inspected 46 top-level command help outputs from /tmp/gh-aw/agent/help-output/ and compared flags/commands to docs/src/content/docs/setup/cli.md.

Severity Count
high 0
medium 1
low 1

Documentation gaps

1. gh aw work-queue is not documented in cli.md (medium)

  • Help output: Experimental: inspect and update a Git-backed work queue, with subcommands cancel-claim, cancel-work, claim, compact, finish, replay, stats, submit-work, and the flag --branch string Work queue branch (default "gh-aw-work-queue").
  • Actual: cli.md has no gh aw work-queue section. Its only mention is the work-queue artifact set under audit. The --branch flag is not documented anywhere.
  • Suggested fix: add a section to cli.md covering the subcommands and flags. Other experimental commands (edit, sessions) are already documented.

Flag-naming inconsistencies

2. work-queue lacks the -r and -j short flags (low)

  • Help output:
          --json            Output JSON
          --repo string     GitHub repository owner/repo
    
  • Expected: the other commands that have these flags (17 each) use -r, --repo and -j, --json. work-queue is the only command that omits the short forms.
  • Suggested fix: add -r and -j shorthands to work-queue.

Inspection metadata

  • Date: 2026-10-06
  • Method: scanned the pre-collected help files, cross-checked every command name and long flag against cli.md, and compared short/long flag pairings across commands. Other undocumented entries (--banner, --version, and gh) are not real subcommands and were not counted.

Generated by ✅ CLI Consistency Checker · copilot · auto · 22.9 AIC · ⌖ 6.42 AIC · ⊞ 8.4K · ◷

  • expires on Oct 8, 2026, 5:32 AM UTC-08:00

Activity

  1. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 12.8 AIC · ⌖ 8.87 AIC · ⊞ 12.9K · ◷

  2. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 13.5 AIC · ⌖ 8.94 AIC · ⊞ 12.9K · ◷

  3. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 14.8 AIC · ⌖ 10.1 AIC · ⊞ 12.9K · ◷

  4. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    Caution

    agentic threat detected
    Threat detection flagged this output in warn mode. Manual review is REQUIRED before any follow-up automation.

    Details

    Potential security threats were detected in the agent output.

    Review the workflow run logs for details.

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 19.7 AIC · ⌖ 14.8 AIC · ⊞ 12.9K · ◷

  5. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 19.1 AIC · ⌖ 10.4 AIC · ⊞ 12.9K · ◷

  6. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 18.4 AIC · ⌖ 10.1 AIC · ⊞ 13.2K · ◷

  7. github-actions commented on Oct 8, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 23.7 AIC · ⌖ 9.32 AIC · ⊞ 13.5K · ◷

  8. github-actions commented on Oct 8, 2026

    @github-actions
    ContributorAuthor

    This issue was automatically closed because it expired on 2026-10-08T13:32:09.215Z.

    Closed by Workflow

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

    automationclicookieIssue Monster Loves Cookies!documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions