gws auth login --help (and -h) is silently ignored — starts the OAuth flow instead of printing help
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
- #835 par @nuthalapativarun — fermée sans fusion
Évaluation
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Accessibilité débutants
- 68/100
- Type d'issue
- Bug
- Clarté
- Plutôt claire
- Activité
- Calme
- Stack technique
- rust
- Domaine
- authentication, cli
Piste de recherche
Start at the gws auth <method> dispatch and compare it with the working top-level and helper-command help paths. Reproduce gws auth login --help, -h, and the other auth methods without triggering their real actions. Done means each auth method prints its help and exits before OAuth, setup, status, export, or logout side effects occur.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
gws auth <method> --help (and -h) is silently ignored — the help flag does not print help, and the subcommand executes
its real action instead. This is at minimum surprising and at worst dangerous for auth login, which triggers an OAuth
flow (printing an authorization URL and waiting on stdin) when the user only intended to read the help text.
Other gws commands handle --help correctly, which makes the inconsistency the most notable part.
Reproduction
Tested on @googleworkspace/cli 0.18.1, macOS 26.4.1, Node 24.14.0.
$ gws auth login --help
Open this URL in your browser to authenticate:
https://accounts.google.com/o/oauth2/auth?scope=...&redirect_uri=http://localhost:52908&...
# → starts a real OAuth flow, binds a localhost redirect port, waits on stdin
$ gws auth login -h
# same — starts the OAuth flow
$ gws auth setup --help
Step 1/6: Checking for gcloud CLI...
✓ gcloud CLI found
# → starts the real interactive setup wizard
$ gws auth status --help
Using keyring backend: keyring
# → runs the status command
For comparison, these work correctly:
$ gws --help
gws — Google Workspace CLI
USAGE: ...
# ✓ prints help
$ gws auth # no subcommand
Usage: gws auth <login|setup|status|export|logout> [options]
# ✓ prints help (this is what `--help` should produce too)
$ gws gmail +triage --help
[Helper] Show unread inbox summary (sender, subject, date)
Usage: gws +triage [OPTIONS]
Options: ...
# ✓ prints help
So --help is honored at the top level (gws --help), at the bare-subcommand level (gws auth), and on helper commands
(gws +triage --help) — but not on any of auth login, auth setup, auth status, auth export, auth logout. The
argument parser appears to be skipped or short-circuited for the auth methods specifically.
Why this matters
gws auth login --helpis a natural thing for a user to type while exploring the CLI. Today it has the side effect of
starting an OAuth flow that binds a localhost port, opens a browser tab in some configurations, and may overwrite saved
credentials when completed. That's a footgun.gws auth setup --helpsimilarly starts the real interactive setup wizard, including gcloud probing. A user trying to
learn what flagssetupaccepts ends up walking through actual setup.- The inconsistency with the rest of the CLI (
--helpworks everywhere else) is a usability bug regardless of the side
effects.
Suggested fix
Have gws auth <method> route through the same argument parser the other subcommands use, so --help/-h short-circuits
before any side effect. The output of gws auth (the bare subcommand) is already a good template for what gws auth login --help should print.
Environment
@googleworkspace/cli0.18.1- macOS 26.4.1 (Darwin 25.4.0), Node 24.14.0
- Langage dominant
- Rust
- Étoiles
- 32.3k
- Forks
- 2k
- Merge moyen
- 16 h 3 min
- PR mergées (30 j)
- 1
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de googleworkspace/cli
-
`gws auth login` keeps the old token cache, so API calls use a token from the previous grantOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 80/100
googleworkspace/cli#984 ·
Les mainteneurs répondent en général sous 1 jour
-
auth export masks secrets by default with no warning; consumers fail later with invalid_clientOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 64/100
googleworkspace/cli#983 ·
Les mainteneurs répondent en général sous 1 jour
-
Replace gemini with agyOuverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
googleworkspace/cli#958 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
googleworkspace/cli#921 ·
Les mainteneurs répondent en général sous 1 jour
-
Add cli to awesome-ai-plugins?Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
googleworkspace/cli#920 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de googleworkspace/cli
Issues similaires
-
crate: spate-kafka priority: low tech-debt
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
Les mainteneurs répondent en général sous 1 jour
-
[Bug]: Executable check only looks at the "others" execute bit, so 0750 binaries are rejectedOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
macOS 菜单栏托盘图标保留橙色,与系统单色图标风格不一致Peut-être pris @xhugoliu l’a pris aujourd’hui. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
YizhengWw/HachimoDock#56 · 1 commentaire ·
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
area:ui bug effort:low P2 source:agent
Difficulté 1/5 Moins d'une heure Accessibilité débutants 86/100
Les mainteneurs répondent en général sous 1 jour