gws auth login --help (and -h) is silently ignored — starts the OAuth flow instead of printing help
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
- #835 của @nuthalapativarun — đã đóng, không merge
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 68/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Ít trao đổi
- Công nghệ
- rust
- Lĩnh vực
- authentication, cli
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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
- Ngôn ngữ chính
- Rust
- Star
- 32.3k
- Fork
- 2k
- Merge trung bình
- 16 giờ 3 phút
- Pull request đã merge (30 ngày)
- 1
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của googleworkspace/cli
-
`gws auth login` keeps the old token cache, so API calls use a token from the previous grantĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 80/100
googleworkspace/cli#984 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
auth export masks secrets by default with no warning; consumers fail later with invalid_clientĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 64/100
googleworkspace/cli#983 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Replace gemini with agyĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 82/100
googleworkspace/cli#958 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
googleworkspace/cli#921 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Add cli to awesome-ai-plugins?Đang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
googleworkspace/cli#920 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của googleworkspace/cli
Issue tương tự
-
area:cli area:security bug priority:medium
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
rtk-ai/rtk#5127 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
status: new topic: ga4gh-sdk type: bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
comp-rbac
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
ClickHouse/ClickHouse#131875 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug(python): read_transaction raises TypeError on a Rewrite with rewritten indicesCó thể đã có người làm @Borg93 đã nhận hôm nay. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
lance-format/lance#11117 ·
Maintainer thường phản hồi trong vòng 2 ngày