Skip to content

[cli-consistency] CLI Consistency Issues - 2026-10-05 #65866

Description

@github-actions

Summary

Inspected 410 command/subcommand help files (from /tmp/gh-aw/agent/all-help.txt) and compared with docs/src/content/docs/setup/cli.md. Found 4 issues: 0 high, 2 medium, 2 low.

Documentation gaps

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

  • Help: Experimental: inspect and update a Git-backed work queue with subcommands cancel-claim, cancel-work, claim, compact, finish, replay, stats, submit-work.
  • cli.md has no gh aw work-queue section or command-table row (only a mention of the work-queue artifact set under audit). Flags --branch, --claim-id, --work-id, --attempt-id, --outcome, --run-id, --file appear nowhere in the doc.
  • Fix: add a command-table row and a section, as done for other experimental commands (sessions, edit).

Flag inconsistencies

2. -l short flag means different things (medium)

  • gh aw trial: -l, --logical-repo string Repository to simulate workflow execution against (for trial mode)
  • gh aw project new: -l, --link string Repository to link project to (format: owner/repo)
  • Expected: one meaning per short flag across commands. Fix: drop or change -l for one of them (e.g. leave --link long-only).

3. work-queue flags don't follow the common conventions (low)

  • Other commands: -j, --json Output results in JSON format and -r, --repo string Target repository ([HOST/]owner/repo format). Defaults to current repository.
  • work-queue: --json Output JSON and --repo string GitHub repository owner/repo (no -j/-r, different wording, no default stated).
  • Fix: add -j/-r and reuse the standard descriptions.

4. Inconsistent --repo description wording (low)

  • Variants seen: Target repository (owner/repo format only; GHES host prefixes are not supported), ... Required unless --org is provided, and the standard [HOST/]owner/repo text. Some are intentional but the phrasing differs; consider a shared helper string.

Metadata

  • Date: 2026-10-05; method: scripted scan of pre-collected help output for flags, short-flag collisions, typos, and doc coverage; run 37317266718.

Generated by ✅ CLI Consistency Checker · copilot · auto · 24.3 AIC · ⌖ 6.91 AIC · ⊞ 8.3K · ◷

  • expires on Oct 7, 2026, 5:37 AM UTC-08:00

Activity

  1. github-actions commented on Oct 6, 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 AIC · ⌖ 8.31 AIC · ⊞ 12.4K · ◷

  2. github-actions commented on Oct 6, 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 · 15.9 AIC · ⌖ 6.9 AIC · ⊞ 12.4K · ◷

  3. github-actions commented on Oct 6, 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 · 10.7 AIC · ⌖ 8.42 AIC · ⊞ 12.7K · ◷

  4. github-actions commented on Oct 6, 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 · 16.6 AIC · ⌖ 17.9 AIC · ⊞ 12.7K · ◷

  5. github-actions commented on Oct 6, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I identified this as a strong, self-contained candidate for automated resolution and requested assignment to the Copilot coding agent.

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

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 21 AIC · ⌖ 8.18 AIC · ⊞ 12.9K · ◷

  6. github-actions commented on Oct 6, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I identified this as a strong, self-contained candidate for automated resolution and requested assignment to the Copilot coding agent.

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

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · pi · gpt54 · 13.2 AIC · ⌖ 8.48 AIC · ⊞ 12.9K · ◷

  7. 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 · 20.2 AIC · ⌖ 17 AIC · ⊞ 13.2K · ◷

  8. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I have 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 · 15.6 AIC · ⌖ 9.3 AIC · ⊞ 13K · ◷

  9. github-actions commented on Oct 7, 2026

    @github-actions
    ContributorAuthor

    This issue was automatically closed because it expired on 2026-10-07T13:37:43.577Z.

    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