Skip to content

CLI: plannotator review --help launches the UI instead of printing help #964

Description

@rrei

Environment:

  • macOS (Darwin 25.5.0), Apple Silicon
  • plannotator v0.21.1, single-file binary at ~/.local/bin/plannotator
  • Driven from Claude Code

Symptom: Top-level plannotator --help prints usage correctly, but the subcommands have no per-subcommand --help handler. Running plannotator review --help does not print help and does not exit - the --help token is silently ignored and the review UI launches a blocking server (opening a browser tab). The same happens when probing other subcommands such as annotate --help. This makes it easy to accidentally spawn a duplicate instance: any tool or user that probes plannotator <subcommand> --help to discover flags ends up starting a real session instead.

Expected: plannotator <subcommand> --help should print that subcommand's usage and exit 0 (or at least error on the unrecognised flag), rather than launching the UI.

Repro:

  1. plannotator review --help
  2. Observe: no help text, the process blocks, and the review server/UI starts.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions