Skip to content

Add in-product help (--help) for squad watch command #757

New issue
New issue
Closed
Closed
Add in-product help (--help) for squad watch command#757
Labels
go:needs-researchNeeds investigationsquadSquad triage inbox — Lead will assign to a member

Description

@bradygaster
bradygaster
opened on Apr 2, 2026

Problem

The squad watch command lacks discoverable in-product help. Running squad watch --help starts the watch loop instead of showing help text. This creates friction for developers trying to learn about available flags and capabilities.

Related: squad triage --help exhibits the same behavior, and watch is not listed as an explicit command in squad --help output (it's a hidden alias for triage).

Current behavior

  • squad watch --help starts the watch loop with no help output
  • squad triage --help has the same issue
  • squad --help lists triage but not watch as an explicit command

Desired outcome

  1. squad watch --help prints help text with flag descriptions
  2. squad triage --help prints help text with flag descriptions
  3. watch appears as a first-class command in squad --help output

Flags to document

  • --interval: Polling interval (milliseconds)
  • --execute: Command to run on match
  • --max-concurrent: Parallel job limit
  • --timeout: Job timeout (milliseconds)
  • --copilot-flags: Flags to pass to Copilot
  • --self-pull: Enable self-pull mode
  • --board: Board filter
  • --two-pass: Enable two-pass mode
  • --wave-dispatch: Enable wave dispatch
  • --monitor-teams: Monitor Teams channel
  • --monitor-email: Monitor email
  • --retro: Enable retro mode
  • --decision-hygiene: Enable decision hygiene
  • --no-{capability}: Disable specific capabilities

Configuration can also be set in .squad/config.json under the watch key.

Implementation notes

  • Source: packages/squad-cli/src/cli-entry.ts (lines 338-398)
  • Command logic: packages/squad-cli/src/cli/commands/watch/

Activity

  1. bradygaster
    added
    squadSquad triage inbox — Lead will assign to a member
    on Apr 2, 2026
  2. github-actions
    added
    squad:flight
    on Apr 2, 2026

  3. github-actions commented on Apr 2, 2026

    @github-actions
    github-actionsBot
    on Apr 2, 2026 – with GitHub Actions
    Contributor

    🏗️ Squad Triage — Flight (Lead)

    Issue: #757 — Add in-product help (--help) for squad watch command
    Assigned to: Flight (Lead)
    Reason: No specific domain match — assigned to Lead for further analysis

    @copilot evaluation: No strong capability match — routed to squad member.

    Team roster:

    • Flight (Lead) → label: squad:flight
    • Procedures (Prompt Engineer) → label: squad:procedures
    • EECOM (Core Dev) → label: squad:eecom
    • FIDO (Quality Owner) → label: squad:fido
    • PAO (DevRel) → label: squad:pao
    • CAPCOM (SDK Expert) → label: squad:capcom
    • CONTROL (TypeScript Engineer) → label: squad:control
    • Surgeon (Release Manager) → label: squad:surgeon
    • Booster (CI/CD Engineer) → label: squad:booster
    • GNC (Node.js Runtime) → label: squad:gnc
    • Network (Distribution) → label: squad:network
    • RETRO (Security) → label: squad:retro
    • INCO (CLI UX & Visual Design) → label: squad:inco
    • GUIDO (VS Code Extension) → label: squad:guido
    • Telemetry (Aspire & Observability) → label: squad:telemetry
    • VOX (REPL & Interactive Shell) → label: squad:vox
    • DSKY (TUI Engineer) → label: squad:dsky
    • Sims (E2E Test Engineer) → label: squad:sims
    • Handbook (SDK Usability) → label: squad:handbook
    • Ralph (Work Monitor) → label: squad:ralph
    • @copilot (Coding Agent) → label: squad:copilot

    To reassign, remove the current squad:* label and add the correct one.

  4. github-actions
    added
    go:needs-researchNeeds investigation
    on Apr 2, 2026
  5. karlis-balcers
    added 2 commits that reference this issue on Apr 13, 2026

    docs: update GITHUB_ISSUES_FIXED.md with confirmed-fixed issues

    94e205e

    docs: update GITHUB_ISSUES_FIXED.md with confirmed-fixed issues

    cd7702a
  6. bradygaster
    closed this as completedon Apr 18, 2026
  7. bradygaster
    removed
    squad:flight
    on Sep 11, 2026
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

    go:needs-researchNeeds investigationsquadSquad triage inbox — Lead will assign to a member

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions