Skip to content

[cli-consistency] CLI Consistency Issues - 2026-10-20 #70526

Closed as not planned
Closed as not planned

Description

@github-actions

Summary

Inspected the pre-collected help output (/tmp/gh-aw/agent/all-help.txt plus per-command files in help-output/) and compared it with docs/src/content/docs/setup/cli.md.

Severity Count
high 0
medium 0
low 1

No typos were found in the help text, and every top-level command appears in cli.md.

Documentation gaps

1. work-queue subcommand flags are missing from cli.md (low)

Affected commands: work-queue cancel-claim, deploy, dispatch-next, explain, inspect, policy, replay, reprioritize, state, submit-graph, submit-work, trace.

Actual: the work-queue section of cli.md (about lines 1247–1275) lists only some flags. The help output documents these flags, and none of them appear anywhere in cli.md:

submit-work: --pool ("Approved scheduling pool (default "default")"), --worker-profile, --priority, --execution-ref, --expires-at, --file
deploy: --from-config, --pool, --worker-profile
dispatch-next: --pool, --max-claims, --max-dispatches
replay: --pool, --file, --run-id, --max-claims, --max-dispatches
explain: --pool, --before-claim
state: --pool, --offset, --search
trace: --claim-id, --offset
cancel-claim / inspect: --claim-id
policy: --epoch, --file, --from-config
reprioritize: --priority
submit-graph: --file

Expected: the cli.md table or text covers these flags, or points readers to gh aw work-queue <subcommand> --help. Some are mentioned in the reference docs, for example --pool in 7 places. The setup CLI page is the one place where the flag set is incomplete.

Suggested fix: add a flag row or sentence per subcommand to the work-queue table in cli.md. Alternatively, generate that table from the help output.

Priority: low.

Inspection metadata

  • Date: 2026-10-20
  • Run: 39429930172
  • Method: Scanned all-help.txt and the per-command help files for typos, then did a scripted cross-check of every long flag in the help files against cli.md.
  • Scope: about 570 help files, including the --banner and --version variants. The top-level command list was checked against cli.md.
  • Not flagged: work-queue --repo says "(owner/repo format)", while other commands say "([HOST/]owner/repo format)". The docs describe this as intentional ("no host prefix").

Generated by ✅ CLI Consistency Checker · copilot · auto · 22.7 AIC · ⌖ 0.612 AIC · ⊞ 8.5K · ◷

  • expires on Oct 22, 2026, 5:34 AM UTC-08:00

Activity

  1. github-actions commented on Oct 20, 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 · gpt50 · 0.534 AIC · ⌖ 0.76 AIC · ⊞ 13.1K · ◷

  2. github-actions commented on Oct 20, 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 · gpt50 · 0.583 AIC · ⌖ 0.622 AIC · ⊞ 12.9K · ◷

  3. github-actions commented on Oct 20, 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 · gpt50 · 0.597 AIC · ⌖ 0.969 AIC · ⊞ 12.6K · ◷

  4. github-actions commented on Oct 20, 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 · gpt50 · 0.56 AIC · ⌖ 0.812 AIC · ⊞ 12.5K · ◷

  5. github-actions commented on Oct 20, 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 · gpt50 · 0.671 AIC · ⌖ 0.741 AIC · ⊞ 12.5K · ◷

  6. github-actions commented on Oct 21, 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 · gpt50 · 0.635 AIC · ⌖ 0.844 AIC · ⊞ 12.5K · ◷

  7. github-actions commented on Oct 21, 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 · gpt50 · 0.739 AIC · ⌖ 0.712 AIC · ⊞ 12.5K · ◷

  8. github-actions commented on Oct 21, 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 · gpt50 · 0.663 AIC · ⌖ 0.623 AIC · ⊞ 12.5K · ◷

  9. github-actions commented on Oct 21, 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 · gpt50 · 0.713 AIC · ⌖ 0.879 AIC · ⊞ 12.6K · ◷

  10. github-actions commented on Oct 21, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    This issue is a good candidate for automated resolution, and assignment to the Copilot coding agent was requested.

    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 · gpt50 · 0.794 AIC · ⌖ 0.755 AIC · ⊞ 12.5K · ◷

  11. github-actions commented on Oct 21, 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 · gpt50 · 0.559 AIC · ⌖ 0.747 AIC · ⊞ 12.5K · ◷

  12. 24 remaining items

  13. github-actions commented on Oct 21, 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 · gpt50 · 0.705 AIC · ⌖ 0.705 AIC · ⊞ 12.5K · ◷

  14. github-actions commented on Oct 21, 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 · gpt50 · 0.558 AIC · ⌖ 0.823 AIC · ⊞ 12.5K · ◷

  15. github-actions commented on Oct 21, 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 · gpt50 · 0.624 AIC · ⌖ 0.607 AIC · ⊞ 12.5K · ◷

  16. github-actions commented on Oct 21, 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 · gpt50 · 0.495 AIC · ⌖ 0.603 AIC · ⊞ 12.5K · ◷

  17. github-actions commented on Oct 21, 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 · gpt50 · 0.702 AIC · ⌖ 0.898 AIC · ⊞ 12.5K · ◷

  18. github-actions commented on Oct 21, 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 · gpt50 · 0.571 AIC · ⌖ 0.615 AIC · ⊞ 12.6K · ◷

  19. github-actions commented on Oct 21, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    Imve 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 · gpt50 · 0.656 AIC · ⌖ 0.616 AIC · ⊞ 12.6K · ◷

  20. github-actions commented on Oct 21, 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 · gpt50 · 0.63 AIC · ⌖ 0.723 AIC · ⊞ 12.6K · ◷

  21. github-actions commented on Oct 21, 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 · gpt50 · 0.593 AIC · ⌖ 0.833 AIC · ⊞ 12.6K · ◷

  22. github-actions commented on Oct 22, 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 · gpt50 · 0.501 AIC · ⌖ 0.615 AIC · ⊞ 12.6K · ◷

  23. github-actions commented on Oct 22, 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 · gpt50 · 0.758 AIC · ⌖ 0.722 AIC · ⊞ 12.6K · ◷

  24. github-actions commented on Oct 22, 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 · gpt50 · 0.507 AIC · ⌖ 0.766 AIC · ⊞ 12.6K · ◷

  25. github-actions commented on Oct 22, 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 · gpt50 · 0.497 AIC · ⌖ 0.752 AIC · ⊞ 12.6K · ◷

  26. github-actions commented on Oct 22, 2026

    @github-actions
    ContributorAuthor

    This issue was automatically closed because it expired on 2026-10-22T13:34:43.456Z.

    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