auth-status
Check CLI and ADC logins across providers: expiry, scopes, re-login commands.
Install
npx skills add https://github.com/fmind/dot/tree/main/skills/auth-status
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart
git clone https://github.com/fmind/dot.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole fmind/dot collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Auth Status
Check login state, scopes, and expiry with read-only probes, then give the user the exact interactive re-login command. dot doctor --deep probes core workstation auth; dot-cli authentication owns policy and scopes; each connector skill owns account selection.
Workflow
Run core workstation probes (checks GitHub, gcloud, ADC, and Workspace without exposing tokens;
conditionseparatesunauthenticated,broken, andinsecureplaintexthosts.yml):dot doctor --deep --json | jq -c '.checks[] | select(.group == "auth") | {name, status, condition, details}'Compare granted scopes against policy (
dot config showkeysauth.github.scopes,auth.workspace.scopes,auth.gcp.adc_scopes): inspectgh auth status --active --hostname github.comandgws auth status | jq '{user, token_valid, has_refresh_token, scopes}'. Missing scopes require re-login; excess scopes are leftover one-off grants—report removal viadot setup github(forauth.github.remove_scopes),gh auth refresh -h github.com --remove-scopes <scopes>, ordot login workspace --force.Probe other requested connectors (read-only, checking both exit code and output):
Provider Probe Recovery Colab colab --auth adc sessions(no VM allocated; check stderr before trusting an empty list)dot login colabHugging Face hf auth whoamihf auth loginKaggle kaggle competitions list --page-size 1 >/dev/nullkaggle auth loginAWS SSO aws sts get-caller-identity --profile <profile> --no-cli-pageraws sso login --profile <profile>Databricks databricks auth profiles(validates each profile)databricks auth login --host <url> --profile <profile>Atlassian acli auth status; API-token Jira:acli jira auth statusacli auth loginSonarQube sonar auth statussonar auth loginVault vault token lookup -format=json \| jq '{expire_time, policies}'vault loginBitwarden bw status \| jq '{status, userEmail}'bw login/bw unlockReport only provider-exposed expiry: for AWS SSO, read
jq -r 'select(has("accessToken")) | .expiresAt' ~/.aws/sso/cache/*.jsonwithout printing cache files (client registrations expire separately); otherwise report"unknown"—never infer from mtimes.Detect env overrides (presence only, never values; note
gwsalso loadsGOOGLE_WORKSPACE_CLI_*from ancestor.envfiles):for name in GH_TOKEN GITHUB_TOKEN GOOGLE_APPLICATION_CREDENTIALS CLOUDSDK_AUTH_ACCESS_TOKEN_FILE \ GOOGLE_WORKSPACE_CLI_TOKEN GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE GEMINI_API_KEY GOOGLE_API_KEY \ HF_TOKEN KAGGLE_API_TOKEN KAGGLE_KEY AWS_PROFILE AWS_ACCESS_KEY_ID AWS_SESSION_TOKEN \ DATABRICKS_HOST DATABRICKS_TOKEN DATABRICKS_CLIENT_SECRET SONAR_TOKEN VAULT_TOKEN BW_SESSION; do if [ -n "$(printenv "$name")" ]; then echo "$name is set"; fi doneReport and hand off: list account, status, scope gaps, expiry, and interactive
! <command>per provider—preferringdot loginordot login github|workspace|gcp|colabover raw native commands, since rawgcloud auth application-default logindrops Colab and BigQuery scopes (Colab ADC). Re-probe only failed items after login.
Gotchas
- Never print secrets: forbid
print-access-token,gh auth token,gws auth export,databricks auth token,hf auth token,kaggle auth print-access-token,kaggle config view,aws configure export-credentials,vault print token,bw get,bw unlock --raw, reading~/.sonar/sonarqube-cli/tokens.json, and--show-token. - Exit 0 is not proof:
gh auth status --jsonandcolabcan exit 0 on auth failure—inspect JSON fields and stderr. - Strictly read-only: logging in, switching accounts, changing scopes, or editing
dotconfig requires user action.
Documentation
- gh auth status · gcloud auth · AWS SSO
- Companion skills: dot-cli (login and setup), gcloud, gh, gws, colab.
Files (dot)
-
SKILL.md 5.6 KB
--- name: auth-status description: "Check CLI and ADC logins across providers: expiry, scopes, re-login commands." license: MIT metadata: kind: task author: Médéric HURIER (Fmind) source: github.com/fmind/dot/tree/main/skills/auth-status created: "2026-10-04" updated: "2026-11-11" --- # Auth Status Check login state, scopes, and expiry with read-only probes, then give the user the exact interactive re-login command. `dot doctor --deep` probes core workstation auth; [dot-cli authentication](../dot-cli/references/authentication.md) owns policy and scopes; each connector skill owns account selection. ## Workflow 1. **Run core workstation probes** (checks GitHub, gcloud, ADC, and Workspace without exposing tokens; `condition` separates `unauthenticated`, `broken`, and `insecure` plaintext `hosts.yml`): ```bash dot doctor --deep --json | jq -c '.checks[] | select(.group == "auth") | {name, status, condition, details}' ``` 1. **Compare granted scopes against policy** (`dot config show` keys `auth.github.scopes`, `auth.workspace.scopes`, `auth.gcp.adc_scopes`): inspect `gh auth status --active --hostname github.com` and `gws auth status | jq '{user, token_valid, has_refresh_token, scopes}'`. Missing scopes require re-login; excess scopes are leftover one-off grants—report removal via `dot setup github` (for `auth.github.remove_scopes`), `gh auth refresh -h github.com --remove-scopes <scopes>`, or `dot login workspace --force`. 1. **Probe other requested connectors** (read-only, checking both exit code and output): | Provider | Probe | Recovery | | ------------ | ----------------------------------------------------------------------------------------- | -------------------------------------------------------- | | Colab | `colab --auth adc sessions` (no VM allocated; check stderr before trusting an empty list) | `dot login colab` | | Hugging Face | `hf auth whoami` | `hf auth login` | | Kaggle | `kaggle competitions list --page-size 1 >/dev/null` | `kaggle auth login` | | AWS SSO | `aws sts get-caller-identity --profile <profile> --no-cli-pager` | `aws sso login --profile <profile>` | | Databricks | `databricks auth profiles` (validates each profile) | `databricks auth login --host <url> --profile <profile>` | | Atlassian | `acli auth status`; API-token Jira: `acli jira auth status` | `acli auth login` | | SonarQube | `sonar auth status` | `sonar auth login` | | Vault | `vault token lookup -format=json \| jq '{expire_time, policies}'` | `vault login` | | Bitwarden | `bw status \| jq '{status, userEmail}'` | `bw login` / `bw unlock` | 1. **Report only provider-exposed expiry**: for AWS SSO, read `jq -r 'select(has("accessToken")) | .expiresAt' ~/.aws/sso/cache/*.json` without printing cache files (client registrations expire separately); otherwise report `"unknown"`—never infer from mtimes. 1. **Detect env overrides** (presence only, never values; note `gws` also loads `GOOGLE_WORKSPACE_CLI_*` from ancestor `.env` files): ```bash for name in GH_TOKEN GITHUB_TOKEN GOOGLE_APPLICATION_CREDENTIALS CLOUDSDK_AUTH_ACCESS_TOKEN_FILE \ GOOGLE_WORKSPACE_CLI_TOKEN GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE GEMINI_API_KEY GOOGLE_API_KEY \ HF_TOKEN KAGGLE_API_TOKEN KAGGLE_KEY AWS_PROFILE AWS_ACCESS_KEY_ID AWS_SESSION_TOKEN \ DATABRICKS_HOST DATABRICKS_TOKEN DATABRICKS_CLIENT_SECRET SONAR_TOKEN VAULT_TOKEN BW_SESSION; do if [ -n "$(printenv "$name")" ]; then echo "$name is set"; fi done ``` 1. **Report and hand off**: list account, status, scope gaps, expiry, and interactive `! <command>` per provider—preferring `dot login` or `dot login github|workspace|gcp|colab` over raw native commands, since raw `gcloud auth application-default login` drops Colab and BigQuery scopes ([Colab ADC](../dot-cli/references/authentication.md#colab-adc)). Re-probe only failed items after login. ## Gotchas - **Never print secrets**: forbid `print-access-token`, `gh auth token`, `gws auth export`, `databricks auth token`, `hf auth token`, `kaggle auth print-access-token`, `kaggle config view`, `aws configure export-credentials`, `vault print token`, `bw get`, `bw unlock --raw`, reading `~/.sonar/sonarqube-cli/tokens.json`, and `--show-token`. - **Exit 0 is not proof**: `gh auth status --json` and `colab` can exit 0 on auth failure—inspect JSON fields and stderr. - **Strictly read-only**: logging in, switching accounts, changing scopes, or editing `dot` config requires user action. ## Documentation - [gh auth status](https://cli.github.com/manual/gh_auth_status) · [gcloud auth](https://docs.cloud.google.com/sdk/gcloud/reference/auth) · [AWS SSO](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) - Companion skills: [dot-cli](../dot-cli/SKILL.md) (login and setup), [gcloud](../gcloud/SKILL.md), [gh](../gh/SKILL.md), [gws](../gws/SKILL.md), [colab](../colab/SKILL.md).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.