feat(wrangler): add shell completions (bash, zsh, fish)

[dmmulroy]

Fixes #53

Summary

Adds wrangler completions command generating shell completion scripts for bash, zsh, fish.

Approach

Uses dynamic completions via a hidden wrangler __complete command which is the same pattern used by kubectl, docker, and cobra-based CLIs. Shell scripts call wrangler __complete at runtime, which outputs tab-separated completions.

Completions derive from the same registry as --help, so new commands/flags are automatically included.

Installation

# Bash
wrangler completions bash >> ~/.bashrc

# Zsh  
wrangler completions zsh >> ~/.zshrc

# Fish
wrangler completions fish > ~/.config/fish/completions/wrangler.fish

---

• Tests
  • Tests included/updated
  • Tests not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: feature is self-documenting via wrangler completions --help
• Wrangler V3 Backport
  • Wrangler PR:
  • Not necessary because: new feature (minor version bump)

[changeset-bot]

🦋 Changeset detected

Latest commit: 9bb2d3e

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

[kiritocode1]

Crazy work @dmmulroy

[elithrar]

@claude review this. Focus on bugs and gaps in testing, if any.

[claude]

Claude encountered an error —— View job

Failed with exit code 128

---

I'll analyze this and get back to you.

[ascorbic]

The reason the PR description workflow is failing is because it relies on the specific format of the PR template checklist, so you'll need to add that for it to pass.

[NuroDev]

The reason the PR description workflow is failing is because it relies on the specific format of the PR template checklist, so you'll need to add that for it to pass.

Yeah, if you copy this template @dmmulroy it should fix that PR description CI.

[dmmulroy]

The reason the PR description workflow is failing is because it relies on the specific format of the PR template checklist, so you'll need to add that for it to pass.

Yeah, if you copy this template @dmmulroy it should fix that PR description CI.

Thanks for the review - I missed the tree params when I was reviewing claudes changes/impl 🤦‍♂️ . Addressed all feedback 🫡

[pkg-pr-new]

create-cloudflare

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

@cloudflare/kv-asset-handler

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

miniflare

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

@cloudflare/pages-shared

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

@cloudflare/unenv-preset

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

@cloudflare/vite-plugin

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

@cloudflare/vitest-pool-workers

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

@cloudflare/workers-editor-shared

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

@cloudflare/workers-utils

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

wrangler

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

commit: 9bb2d3e

[ascorbic]

There is an existing PR open that does the same thing, but using @bomb-sh/tab. I'm not sure what the best approach is. The other one is simpler because it uses the library, but this one has comprehensive tests.

[NuroDev]

There is an existing PR open that does the same thing, but using @bomb-sh/tab. I'm not sure what the best approach is. The other one is simpler because it uses the library, but this one has comprehensive tests.

I've tested both this and the other PR and this PR seems to be slightly better in terms of (slightly) better DX, full control of the completions logic (Should we ever want to make tweaks it'll be easier) and also more comprehensive tests to cover this new feature.

[dmmulroy]

chatted internally we're going to reopen #11113 and take that approach