# heroku > CLI to interact with Heroku Latest version **11.10.0** (published 2026-08-19) · ISC license · 0 weekly downloads ## Install ```sh npm install heroku pnpm add heroku yarn add heroku bun add heroku ``` Provides the command `heroku`. ## 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. ## Facts | | | |---|---| | Version | 11.10.0 | | Published | 2026-08-19 | | First published | 2012-01-20 | | Weekly downloads | 0 | | License | ISC | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=20 | | Dependencies | 73 | | Unpacked size | 2.3 MB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 889 | | Author | Heroku | | Maintainers | sbosio_sf, eblack, mars, heroku-johnny, michael.malave, erika.wallace, tlowrimore, sfjonnpm, nrenke | | Keywords | heroku, heroku-cli-plugin | ## Links - npm: https://www.npmjs.com/package/heroku - Repository: https://github.com/heroku/cli - Homepage: https://cli.heroku.com - Issues: https://github.com/heroku/cli/issues - npm.io page: https://npm.io/package/heroku ## Dependencies (73) - [ws](https://npm.io/package/ws.md) ^6.2.2 - [got](https://npm.io/package/got.md) ^13.0.0 - [tmp](https://npm.io/package/tmp.md) ^0.2.5 - [glob](https://npm.io/package/glob.md) ^13.0.2 - [open](https://npm.io/package/open.md) ^10.1.2 - [ssh2](https://npm.io/package/ssh2.md) ^1.16.0 - [yaml](https://npm.io/package/yaml.md) ^2.0.1 - [ansis](https://npm.io/package/ansis.md) ^4 - [bytes](https://npm.io/package/bytes.md) ^3.1.2 - [debug](https://npm.io/package/debug.md) ^4.4.3 - [execa](https://npm.io/package/execa.md) ^9.6.1 - [tldts](https://npm.io/package/tldts.md) ^7.0.27 - [tslib](https://npm.io/package/tslib.md) ^2.8.1 - [urijs](https://npm.io/package/urijs.md) ^1.19.11 - [lodash](https://npm.io/package/lodash.md) ^4.17.21 - [marked](https://npm.io/package/marked.md) ^15.0.12 - [printf](https://npm.io/package/printf.md) 0.6.1 - [keypair](https://npm.io/package/keypair.md) ^1.0.4 - [phoenix](https://npm.io/package/phoenix.md) ^1.6.14 - [date-fns](https://npm.io/package/date-fns.md) ^2.30.0 - [filesize](https://npm.io/package/filesize.md) ^10.1 - [fs-extra](https://npm.io/package/fs-extra.md) ^11.3.0 - [inquirer](https://npm.io/package/inquirer.md) ^8.2.6 - [strftime](https://npm.io/package/strftime.md) ^0.10.0 - [term-img](https://npm.io/package/term-img.md) ^7.1.0 - [commander](https://npm.io/package/commander.md) ^2.15.1 - [true-myth](https://npm.io/package/true-myth.md) 4.1.1 - [tsheredoc](https://npm.io/package/tsheredoc.md) ^1.0.1 - [word-wrap](https://npm.io/package/word-wrap.md) ^1.2.5 - [node-fetch](https://npm.io/package/node-fetch.md) ^2.6.7 - [node-forge](https://npm.io/package/node-forge.md) ^1.3.3 - [portfinder](https://npm.io/package/portfinder.md) ^1.0.32 - [@oclif/core](https://npm.io/package/@oclif/core.md) ^4.8.4 - [chrono-node](https://npm.io/package/chrono-node.md) ^2.7.6 - [eventsource](https://npm.io/package/eventsource.md) ^4 - [shell-quote](https://npm.io/package/shell-quote.md) ^1.8.1 - [@oclif/table](https://npm.io/package/@oclif/table.md) ^0.5.2 - [@sentry/node](https://npm.io/package/@sentry/node.md) ^10.27 - [ansi-escapes](https://npm.io/package/ansi-escapes.md) ^7.3.0 - [cli-progress](https://npm.io/package/cli-progress.md) ^3.12.0 - [netrc-parser](https://npm.io/package/netrc-parser.md) 3.1.6 - [redis-parser](https://npm.io/package/redis-parser.md) ^3.0.0 - [yargs-parser](https://npm.io/package/yargs-parser.md) 18.1.3 - [@types/js-yaml](https://npm.io/package/@types/js-yaml.md) ^3.12.5 - [@heroku/socksv5](https://npm.io/package/@heroku/socksv5.md) ^0.0.9 - [marked-terminal](https://npm.io/package/marked-terminal.md) ^7.3.0 - [natural-orderby](https://npm.io/package/natural-orderby.md) ^5.0.0 - [@heroku/http-call](https://npm.io/package/@heroku/http-call.md) ^5.5.1 - [@inquirer/prompts](https://npm.io/package/@inquirer/prompts.md) ^7.0 - [https-proxy-agent](https://npm.io/package/https-proxy-agent.md) ^7.0.6 - [@heroku-cli/schema](https://npm.io/package/@heroku-cli/schema.md) ^1.0.25 - [@heroku/mcp-server](https://npm.io/package/@heroku/mcp-server.md) ^1.2.5 - [@oclif/plugin-help](https://npm.io/package/@oclif/plugin-help.md) ^6.2.37 - [@opentelemetry/api](https://npm.io/package/@opentelemetry/api.md) ^1.9.0 - [@heroku-cli/command](https://npm.io/package/@heroku-cli/command.md) ^13.0.0 - [@oclif/plugin-which](https://npm.io/package/@oclif/plugin-which.md) ^3.2.44 - [@oclif/plugin-search](https://npm.io/package/@oclif/plugin-search.md) 1.2.38 - [@oclif/plugin-update](https://npm.io/package/@oclif/plugin-update.md) ^4.7.22 - [@oclif/plugin-plugins](https://npm.io/package/@oclif/plugin-plugins.md) ^5.4.73 - [@oclif/plugin-version](https://npm.io/package/@oclif/plugin-version.md) ^2.2.37 - [@sentry/opentelemetry](https://npm.io/package/@sentry/opentelemetry.md) ^10.27.0 - [@oclif/plugin-commands](https://npm.io/package/@oclif/plugin-commands.md) ^4.1.40 - [@heroku/heroku-cli-util](https://npm.io/package/@heroku/heroku-cli-util.md) ^10.10.0 - [@oclif/plugin-not-found](https://npm.io/package/@oclif/plugin-not-found.md) ^3.2.74 - [@opentelemetry/resources](https://npm.io/package/@opentelemetry/resources.md) ^1.25.1 - [@heroku-cli/notifications](https://npm.io/package/@heroku-cli/notifications.md) ^1.2.6 - [@heroku/buildpack-registry](https://npm.io/package/@heroku/buildpack-registry.md) ^1.0.1 - [@opentelemetry/sdk-trace-base](https://npm.io/package/@opentelemetry/sdk-trace-base.md) ^1.25.1 - [@opentelemetry/sdk-trace-node](https://npm.io/package/@opentelemetry/sdk-trace-node.md) ^1.25.1 - [@opentelemetry/instrumentation](https://npm.io/package/@opentelemetry/instrumentation.md) ^0.52.1 - [@opentelemetry/semantic-conventions](https://npm.io/package/@opentelemetry/semantic-conventions.md) ^1.25.1 - [@oclif/plugin-warn-if-update-available](https://npm.io/package/@oclif/plugin-warn-if-update-available.md) ^3.1.55 - [@opentelemetry/exporter-trace-otlp-http](https://npm.io/package/@opentelemetry/exporter-trace-otlp-http.md) ^0.52.1 ## Recent versions - 11.10.0 (latest) — 2026-08-19 - 12.0.0-alpha.0 (alpha) — 2026-09-11 - 11.10.0-beta.0 (beta) — 2026-08-18 - 9.0.0-dev.0 (dev) — 2023-11-08 - 11.9.0 — 2026-08-04 - 11.9.0-beta.0 — 2026-08-04 - 11.8.1 — 2026-07-08 - 11.8.1-beta.0 — 2026-07-08 - 11.8.0 — 2026-07-01 - 11.8.0-beta.0 — 2026-07-01 - 11.8.0-alpha.1 — 2026-06-30 - 11.7.1 — 2026-06-24 - 11.7.1-beta.0 — 2026-06-24 - 11.7.0 — 2026-06-23 - 11.7.0-beta.0 — 2026-06-23 - … 633 more at https://npm.io/package/heroku/versions ## README
Heroku logo

 

[![Node CI Suite](https://github.com/heroku/cli/actions/workflows/ci.yml/badge.svg)](https://github.com/heroku/cli/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/heroku.svg)](https://www.npmjs.com/package/heroku) [![ISC License](https://img.shields.io/github/license/heroku/cli.svg)](https://github.com/heroku/cli/blob/main/LICENSE)
Overview ======== The Heroku CLI is a command-line interface for managing Heroku applications and services. Built with Node.js and [oclif](https://oclif.io), it provides an extensible architecture for interacting with the Heroku platform. For more about Heroku see To get started see Key features of the CLI include: - **App management** - Deploy, scale, and monitor your applications - **Heroku Postgres database management** - Backup, restore, and manage Heroku Postgres databases - **Heroku CI/CD pipelines** - Run automated tests and manage review apps for streamlined deployment workflows - **Add-ons marketplace** - Provision and manage tools and services to extend your application - **SSL certificates and domains** - Configure custom domains and automatically manage SSL/TLS certificates - **Team collaboration** - Manage organization and team access with granular permissions - **Private Spaces** - Deploy applications in network-isolated environments with VPN support - **Logs and monitoring** - Stream application logs and forward them to external services - **Plugin ecosystem** - Extend functionality with community and custom plugins For more on developing plugins, read [Developing CLI Plugins](https://devcenter.heroku.com/articles/developing-cli-plugins) Issues ====== For problems directly related to the CLI, [add an issue on GitHub](https://github.com/heroku/cli/issues/new). For other issues, [submit a support ticket](https://help.heroku.com/). [Contributors](https://github.com/heroku/cli/contributors) # Command Topics * [`heroku access`](docs/access.md) - manage user access to apps * [`heroku accounts`](docs/accounts.md) - list the Heroku accounts in your cache * [`heroku addons`](docs/addons.md) - tools and services for developing, extending, and operating your app * [`heroku apps`](docs/apps.md) - manage apps on Heroku * [`heroku auth`](docs/auth.md) - manage authentication for your Heroku account * [`heroku authorizations`](docs/authorizations.md) - OAuth authorizations * [`heroku autocomplete`](docs/autocomplete.md) - display autocomplete installation instructions * [`heroku buildpacks`](docs/buildpacks.md) - scripts used to compile apps * [`heroku certs`](docs/certs.md) - SSL certificates * [`heroku ci`](docs/ci.md) - test runner for Heroku Pipelines * [`heroku clients`](docs/clients.md) - OAuth clients on the platform * [`heroku config`](docs/config.md) - environment variables of apps * [`heroku container`](docs/container.md) - deploy your Docker-based app to Heroku * [`heroku data`](docs/data.md) - list maintenances for an app's data addons * [`heroku domains`](docs/domains.md) - custom domains for apps * [`heroku drains`](docs/drains.md) - forward logs to syslog or HTTPS * [`heroku features`](docs/features.md) - add/remove app features * [`heroku git`](docs/git.md) - set git remote and clone Heroku repository * [`heroku help`](docs/help.md) - Display help for heroku. * [`heroku keys`](docs/keys.md) - add/remove account ssh keys * [`heroku labs`](docs/labs.md) - add/remove experimental features * [`heroku local`](docs/local.md) - run Heroku app locally * [`heroku logs`](docs/logs.md) - display recent log output * [`heroku maintenance`](docs/maintenance.md) - enable/disable access to app * [`heroku mcp`](docs/mcp.md) - starts the Heroku platform MCP server in stdio mode * [`heroku members`](docs/members.md) - manage organization members * [`heroku notifications`](docs/notifications.md) - display notifications * [`heroku orgs`](docs/orgs.md) - manage organizations * [`heroku pg`](docs/pg.md) - manage postgresql databases * [`heroku pipelines`](docs/pipelines.md) - manage pipelines * [`heroku plugins`](docs/plugins.md) - List installed plugins. * [`heroku ps`](docs/ps.md) - manage app dynos * [`heroku redis`](docs/redis.md) - manage heroku redis instances * [`heroku regions`](docs/regions.md) - list available regions for deployment * [`heroku releases`](docs/releases.md) - display the releases for an app * [`heroku repl`](docs/repl.md) - enter an interactive REPL session to run Heroku CLI commands * [`heroku reviewapps`](docs/reviewapps.md) - manage reviewapps in pipelines * [`heroku run`](docs/run.md) - run a one-off process inside a Heroku dyno * [`heroku search`](docs/search.md) - Search for a command. * [`heroku sessions`](docs/sessions.md) - OAuth sessions * [`heroku spaces`](docs/spaces.md) - list available spaces * [`heroku status`](docs/status.md) - display current status of the Heroku platform * [`heroku teams`](docs/teams.md) - manage teams * [`heroku telemetry`](docs/telemetry.md) - list telemetry drains * [`heroku update`](docs/update.md) - update the Heroku CLI * [`heroku usage`](docs/usage.md) - list usage for metered add-ons attached to an app or apps within a team * [`heroku version`](docs/version.md) - display changelog information for a specific CLI version * [`heroku webhooks`](docs/webhooks.md) - list webhooks on an app Developing ========== After cloning the repo 1. Run `npm install` to install dependencies 2. Run `npm run build` to build the CLI. This will need to be re-run any time you make changes and want to test them locally. To execute Heroku CLI commands locally, use `./bin/run `. For example, to run the `heroku apps` command with your local code, run `./bin/run apps` from the root directory. Testing ======= Run all tests with `npm test`. ## Debugging Using WebStorm (from JetBrains / IntelliJ), you can run/debug an individual test case. - Create a new run/debug configuration - Select the 'Mocha' type Contributing ========= Please review our [Contributing guidelines](./CONTRIBUTING.md) as well as our [PR template](./.github/PULL_REQUEST_TEMPLATE.md). --- _Source: https://npm.io/package/heroku · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._