# 使用 Homebrew, Nix, winget 安装 heroku

查看 heroku 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:heroku
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install heroku
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#heroku
```

  证据: nixpkgs package indexes: pkgs/by-name/he/heroku/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id Heroku.HerokuCLI -e
```

  证据: Windows Package Manager source index: Heroku.HerokuCLI from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:heroku
- **软件包管理器:** Homebrew
- **版本:** 11.8.1
- **来源摘要:** CLI for Heroku
- **主页:** <https://www.npmjs.com/package/heroku/>
- **最后更新:** 2026-07-10T03:02:15Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- heroku (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 11.8.1
## 项目历史与用法

The Heroku CLI is the command-line interface for managing Heroku applications and services. Historically it is one of the defining cloud-platform CLIs: it carried Heroku's git-push deployment workflow, add-ons, dyno management, logs, config vars, database operations, teams, plugins, and local development commands into a single terminal tool.

### 项目历史

Heroku's command-line story predates the Node.js repository. In March 2012, Heroku announced the Heroku Toolbelt as a package of the Heroku CLI, Foreman, and Git for OS X, Windows, and Debian/Ubuntu Linux. The post explained that the CLI used Ruby under the hood, while Toolbelt packaging isolated its libraries so developers outside Ruby ecosystems could use Heroku without managing RubyGems themselves.

The `heroku/cli` repository was created on December 20, 2014. The repository README describes the modern CLI as a Node.js and oclif-based command-line interface for Heroku applications and services, with an extensible plugin architecture.

In 2024, Heroku described CLI v9.0.0 as a major architecture release that moved all core commands onto oclif, consolidated commands into a single package, improved tests, and simplified release processes. Heroku noted that earlier commands had been split across legacy and pre-oclif architectures.

In March 2026, Heroku described CLI v11 as a modernization that completed migration to ECMAScript Modules and oclif v4, shipped with Node.js 22 while retaining Node.js 20 compatibility, and added semantic color behavior and workflow changes such as command search and unified data-maintenance commands.

### 采用历史

The CLI's adoption follows Heroku's role as an early platform-as-a-service developer workflow. For many users, `heroku create`, `git push heroku`, `heroku config`, `heroku ps`, `heroku logs`, `heroku run`, and add-on commands were the ordinary interface to cloud deployment before web dashboards or infrastructure-as-code tools became default for every platform.

The Dev Center article says the CLI used to be part of the Heroku Toolbelt, then documents standalone installation through Homebrew, installers, and npm. That transition mirrors a broader shift from Ruby-era Heroku tooling to a Node.js/oclif CLI with plugins and generated command documentation.

Heroku's 2016 changelog item for Teams support shows the CLI tracking platform features over time: the old Toolbelt CLI gained commands and flags for team operations as Heroku's collaboration model evolved.

### 使用方式

The CLI manages app lifecycle, deployment, scaling, logs, add-ons, Heroku Postgres, Heroku Redis, SSL certificates, domains, pipelines, teams, private spaces, and plugin commands. The README's command-topic list functions as a map of Heroku's platform surface area exposed through the terminal.

Authentication is stored through the CLI's credential flow; Heroku Dev Center troubleshooting notes that `.netrc` is where the CLI stores credentials on Unix-like systems, with `_netrc` on Windows.

The CLI also has a plugin culture. The README points developers to Heroku's CLI plugin documentation, and Heroku's architecture writing emphasizes oclif's modular structure and plugin support.

### 为什么软件包爱好者会关心

Heroku CLI is a canonical example of a vendor CLI that became an operational dependency. It is not just a client for one API: package managers ship it because developers expect deployments, logs, config, add-ons, and database maintenance to be available from scripts, CI, and shell sessions.

Its packaging history is a miniature history of language ecosystems in CLIs: RubyGem-era `heroku`, Toolbelt bundling to hide Ruby from non-Ruby users, then a Node.js and oclif architecture with npm distribution, Homebrew packaging, and plugin commands.

oclif itself is historically tied to Heroku. Heroku's 2024 CLI v9 post says Heroku pioneered oclif and then moved all core CLI commands to it, making Heroku CLI both a consumer and a proving ground for a framework used by other large CLIs.

### 时间线

- 2012-03-09: Heroku announced Heroku Toolbelt, bundling the CLI, Foreman, and Git.
- 2014-12-20: `heroku/cli` GitHub repository creation date recorded by GitHub.
- 2016-10-18: Heroku Teams support was announced for the Heroku Toolbelt CLI.
- 2024-07-25: Heroku published its CLI v9 architecture and oclif-transition post.
- 2026-03-18: Heroku Dev Center changelog announced CLI v11.0.0.
- 2026-03-19: Heroku published its CLI v11 modernization post.

### Related projects

- Foreman is part of the Heroku Toolbelt origin story and remains associated with local process workflows shaped by Heroku's Procfile model.
- oclif is the CLI framework Heroku uses for the command architecture and plugin model.
- Heroku platform services such as Heroku Postgres, Redis, Pipelines, Teams, Private Spaces, add-ons, and the Dev Center are exposed or supported by CLI command groups.

### 来源

- Heroku CLI GitHub README for repository identity, command scope, and oclif/Node.js architecture.
- Heroku Dev Center CLI article for installation, credentials, Toolbelt note, and architecture.
- Heroku Toolbelt announcement for the Ruby-era bundle and cross-platform installer history.
- Heroku blog and Dev Center changelog entries for CLI v9 and v11 architectural milestones.


## 安全说明

没有找到 heroku 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Credential files

- Unix: ~/.netrc
## 其他软件包管理器记录

- Nix - heroku: normalized package name match | nixpkgs package indexes: pkgs/by-name/he/heroku/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - Heroku.HerokuCLI: normalized package name match | Windows Package Manager source index: Heroku.HerokuCLI from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/heroku.yml](https://github.com/mxcl/pkgdb/blob/main/combined/heroku.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph