feat(wrangler): add wrangler auth token command

[ascorbic]

Fixes #10095.

Adds a new wrangler auth token command that retrieves the current authentication credentials for use with other tools and scripts. This is similar to gh auth token in the GitHub CLI.

The command supports all Wrangler authentication methods:

• OAuth token from wrangler login (automatically refreshed if expired)
• API token from CLOUDFLARE_API_TOKEN environment variable
• API key/email from CLOUDFLARE_API_KEY + CLOUDFLARE_EMAIL (requires --json flag)

Basic usage:

wrangler auth token

JSON output with token type:

wrangler auth token --json
# Returns: { "type": "oauth", "token": "..." }
# Or: { "type": "api_token", "token": "..." }
# Or: { "type": "api_key", "key": "...", "email": "..." }

Implementation notes:

• Outputs raw token value (no banner) for easy scripting via printBanner: false
• Errors with helpful message if using API key/email without --json (no single token to return)
• Refactored internal LocalState to localState for consistency
• Added getOAuthTokenFromLocalState() function that only handles OAuth tokens from local state
• Added JSDoc documentation for auth priority behavior in getAuthFromEnv()

Human Review Checklist:

• Verify the --json output format is appropriate for all three auth types
• Verify the error message for API key/email without --json is helpful
• Verify the auth namespace is the appropriate location for this command

---

Devin PR requested by mkane@cloudflare.com

Link to Devin run: https://app.devin.ai/sessions/d407c26dd1da4edf905944a95e90226a

• Tests
  • Tests included/updated
  • Tests not necessary because:
• Public documentation
  • Cloudflare docs PR(s): docs: add wrangler auth token command documentation cloudflare-docs#27219
  • Documentation not necessary because:
• Wrangler V3 Backport
  • Wrangler PR:
  • Not necessary because: New feature, not a patch fix

[changeset-bot]

🦋 Changeset detected

Latest commit: e1e8955

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[claude]

Claude finished @ascorbic's task —— View job

---

Changeset Review

✅ All changesets look good

The changeset file .changeset/auth-token-command.md passes all validation checks:

• ✅ Version Type: Correctly set to minor (new CLI command)
• ✅ Changelog Quality: Clear description with usage examples for the new feature
• ✅ Markdown Headers: No h1/h2/h3 headers present
• ✅ Format: Follows the recommended format with title and explanatory body
• ✅ Examples: Includes practical usage examples with bash code blocks

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11682

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11682

miniflare

npm i https://pkg.pr.new/miniflare@11682

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11682

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11682

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11682

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11682

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11682

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11682

wrangler

npm i https://pkg.pr.new/wrangler@11682

commit: e1e8955

[ascorbic]

Looks good. Tested locally.

[devin-ai-integration]

Thanks for testing and reviewing! The PR is ready for merge whenever you're ready.

[ascorbic]

(aside) This does need docs. I'll add them if everyone agrees this is the right API

[vicb]

Thanks Matt!

[karalabe]

Ty ❤️