# wrangler

> Command-line interface for all things Cloudflare Workers

Latest version **4.141.0** (published 2026-09-25) · MIT OR Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install wrangler
pnpm add wrangler
yarn add wrangler
bun add wrangler
```

Provides the commands `wrangler`, `wrangler2`, `cf-wrangler`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 4.141.0 |
| Published | 2026-09-25 |
| First published | 2012-06-19 |
| Weekly downloads | 0 |
| License | MIT OR Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.0.0 |
| Dependencies | 8 |
| Unpacked size | 14.8 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 4549 |
| Author | wrangler@cloudflare.com |
| Maintainers | wrangler-publisher |
| Keywords | assembly, cli, cloudflare, cloudflare workers, compute, edge, emscripten, graphql, http, router, rust, serverless, serverless application, serverless module, typescript, wasm, web, webassembly, workers, wrangler |

## Links

- npm: https://www.npmjs.com/package/wrangler
- Repository: https://github.com/cloudflare/workers-sdk
- Homepage: https://github.com/cloudflare/workers-sdk#readme
- Issues: https://github.com/cloudflare/workers-sdk/issues
- npm.io page: https://npm.io/package/wrangler

## Dependencies (8)

- [unenv](https://npm.io/package/unenv.md) 2.0.0-rc.24
- [esbuild](https://npm.io/package/esbuild.md) 0.28.1
- [workerd](https://npm.io/package/workerd.md) 1.20260925.1
- [miniflare](https://npm.io/package/miniflare.md) 5.20260925.0-alpha
- [blake3-wasm](https://npm.io/package/blake3-wasm.md) 2.1.5
- [path-to-regexp](https://npm.io/package/path-to-regexp.md) 6.3.0
- [@cloudflare/unenv-preset](https://npm.io/package/@cloudflare/unenv-preset.md) 2.16.2
- [@cloudflare/kv-asset-handler](https://npm.io/package/@cloudflare/kv-asset-handler.md) 0.5.0

## Alternatives

- [express-promise-router](https://npm.io/package/express-promise-router.md) — 736.1K weekly downloads
- [next-usequerystate](https://npm.io/package/next-usequerystate.md) — 29.8K weekly downloads
- [@bitkyc08/opencodex](https://npm.io/package/@bitkyc08/opencodex.md) — 4.6K weekly downloads
- [lynkr](https://npm.io/package/lynkr.md) — 575 weekly downloads
- [baremetal.js](https://npm.io/package/baremetal.js.md) — 42 weekly downloads

## Recent versions

- 4.141.0 (latest) — 2026-09-25
- 3.114.17 (legacy) — 2026-01-13
- 2.2.4 (wrangler@2.2.4) — 2022-11-15
- 4.140.0 — 2026-09-25
- 4.139.0 — 2026-09-24
- 4.138.0 — 2026-09-24
- 4.137.0 — 2026-09-23
- 4.136.3 — 2026-09-22
- 4.136.2 — 2026-09-22
- 4.136.1 — 2026-09-21
- 4.136.0 — 2026-09-21
- 4.135.0 — 2026-09-18
- 4.134.0 — 2026-09-17
- 4.133.0 — 2026-09-16
- 4.132.0 — 2026-09-15
- … 4933 more at https://npm.io/package/wrangler/versions

## README

<h1 align="center">Cloudflare Workers SDK</h1>

<p align="center">
<img src="cloudflare-workers-outline.png" alt="workers-logo" width="120px" height="120px"/>
  <br>
  Cloudflare Workers let you deploy serverless code instantly across the globe for exceptional performance, reliability, and scale.
  <br>
</p>

<p align="center">
  <a href="CONTRIBUTING.md">Contribute</a>
  ·
  <a href="https://github.com/cloudflare/workers-sdk/issues">Submit an Issue</a>
  ·
  <a href="https://discord.cloudflare.com/">Join Discord</a>
  <br>
  <br>
</p>

<p align="center">
  <a href="https://www.npmjs.com/wrangler/">
    <img src="https://img.shields.io/npm/v/wrangler.svg?logo=npm&logoColor=fff&label=NPM+package&color=orange" alt="Wrangler on npm" />
  </a>&nbsp;
  <a href="https://discord.cloudflare.com/">
    <img src="https://img.shields.io/discord/595317990191398933.svg?logo=discord&logoColor=fff&label=Discord&color=7389d8" alt="Discord conversation" />
  </a>&nbsp;
  <a href="https://twitter.com/CloudflareDev">
    <img src="https://img.shields.io/twitter/follow/cloudflaredev" alt="X conversation" />
  </a>
</p>

<hr>

## Quick Start

To get started quickly with a new project, run the command below:

```bash
npm create cloudflare@latest
# or
pnpm create cloudflare@latest
# or
yarn create cloudflare@latest
```

For more info, visit our [Getting Started](https://developers.cloudflare.com/workers/get-started/guide/) guide.

## Documentation

Visit the official Workers documentation [here](https://developers.cloudflare.com/workers/).

- [Getting Started](https://developers.cloudflare.com/workers/get-started/guide/)
- [How Workers works](https://developers.cloudflare.com/workers/reference/how-workers-works/)
- [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/)
- [Observability](https://developers.cloudflare.com/workers/observability/)
- [Platform](https://developers.cloudflare.com/workers/platform/)

## Directory

| Package                                                                                                           | Description                                                                                                            | Links                                                           |
| ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| [`wrangler`](https://github.com/cloudflare/workers-sdk/tree/main/packages/wrangler)                               | A command line tool for building [Cloudflare Workers](https://workers.cloudflare.com/).                                | [Docs](https://developers.cloudflare.com/workers/wrangler/)     |
| [`create-cloudflare` (C3)](https://github.com/cloudflare/workers-sdk/tree/main/packages/create-cloudflare)        | A CLI for creating and deploying new applications to Cloudflare.                                                       | [Docs](https://developers.cloudflare.com/pages/get-started/c3/) |
| [`miniflare`](https://github.com/cloudflare/workers-sdk/tree/main/packages/miniflare)                             | A simulator for developing and testing Cloudflare Workers, powered by [workerd](https://github.com/cloudflare/workerd) | [Docs](https://miniflare.dev)                                   |
| [`chrome-devtools-patches`](https://github.com/cloudflare/workers-sdk/tree/main/packages/chrome-devtools-patches) | Cloudflare's fork of Chrome DevTools for inspecting your local or remote Workers                                       |                                                                 |
| [`pages-shared`](https://github.com/cloudflare/workers-sdk/tree/main/packages/pages-shared)                       | Used internally to power Wrangler and Cloudflare Pages. It contains all the code that is shared between these clients. |                                                                 |

## Beta releases

Beta releases are generated by the [pkg.pr.new](https://github.com/stackblitz-labs/pkg.pr.new) tool and are updated on every commit pushed to the `main` branch.

> [!Warning]
> These beta releases get updated over time, so they are ill suited to be used as stable versions for a project (and the proper npm released should be used instead). These should be used only for quick testing of not yet released features/fixes.

Available beta releases are listed below.

<details><summary><b>create-cloudflare</b></summary><p>

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

</p></details>

<details><summary><b>@cloudflare/kv-asset-handler</b></summary><p>

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

</p></details>

<details><summary><b>miniflare</b></summary><p>

```
npm i https://pkg.pr.new/miniflare@main
```

</p></details>

<details><summary><b>@cloudflare/pages-shared</b></summary><p>

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

</p></details>

<details><summary><b>@cloudflare/unenv-preset</b></summary><p>

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

</p></details>

<details><summary><b>@cloudflare/vite-plugin</b></summary><p>

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

</p></details>

<details><summary><b>@cloudflare/vitest-plugin</b></summary><p>

```
npm i https://pkg.pr.new/@cloudflare/vitest-plugin@main
```

</p></details>

<details><summary><b>@cloudflare/workers-editor-shared</b></summary><p>

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

</p></details>

<details><summary><b>wrangler</b></summary><p>

```
npm i https://pkg.pr.new/wrangler@main
```

</p></details>

## Contributing

We welcome new contributors! Refer to the [`CONTRIBUTING.md`](/CONTRIBUTING.md) guide for details.

## Community

Join us in the official [Cloudflare Discord](https://discord.cloudflare.com/) to meet other developers, ask questions, or learn more in general.

## Links

- [Project Board](https://github.com/orgs/cloudflare/projects/1)
- [Discussions](https://github.com/cloudflare/workers-sdk/discussions)

---
_Source: https://npm.io/package/wrangler · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._