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:
plannotator review --help
- Observe: no help text, the process blocks, and the review server/UI starts.
Environment:
Symptom: Top-level
plannotator --helpprints usage correctly, but the subcommands have no per-subcommand--helphandler. Runningplannotator review --helpdoes not print help and does not exit - the--helptoken is silently ignored and the review UI launches a blocking server (opening a browser tab). The same happens when probing other subcommands such asannotate --help. This makes it easy to accidentally spawn a duplicate instance: any tool or user that probesplannotator <subcommand> --helpto discover flags ends up starting a real session instead.Expected:
plannotator <subcommand> --helpshould print that subcommand's usage and exit 0 (or at least error on the unrecognised flag), rather than launching the UI.Repro:
plannotator review --help