---
title: "Heroku CLI v9: Infrastructure Upgrades and oclif Transition"
description: "Heroku CLI 9.0.0 is an architectural upgrade centered on moving all core commands from a partly legacy structure to oclif. Core commands are consolidated into one package, while improved unit and integration coverage, telemetry, and a simpler automated release process support contribution, maintenance, and pre-release testing. The oclif migration provides a modular command architecture with plugin support and is intended to make command behavior more consistent, maintenance easier, and provide better scalability. Users should expect breaking changes including altered whitespace, newlines, table formatting, colors, argument ordering, flag removals, and a required separator for additional flags; deprecated commands including outbound-rules, pg:repoint, orgs:default, certs:chain, certs:key were removed. Changes apply to core commands, not separately installed plugins, and the release can be installed with heroku update."
---

# Heroku CLI v9: Infrastructure Upgrades and oclif Transition

[Heroku](https://yomu.fyi/company/heroku) · Anush DSouza · Jul 25, 2024

**Type:** Announcement

## Summary

Heroku CLI 9.0.0 is an architectural upgrade centered on moving all core commands from a partly legacy structure to oclif. Core commands are consolidated into one package, while improved unit and integration coverage, telemetry, and a simpler automated release process support contribution, maintenance, and pre-release testing. The oclif migration provides a modular command architecture with plugin support and is intended to make command behavior more consistent, maintenance easier, and provide better scalability. Users should expect breaking changes including altered whitespace, newlines, table formatting, colors, argument ordering, flag removals, and a required separator for additional flags; deprecated commands including outbound-rules, pg:repoint, orgs:default, certs:chain, certs:key were removed. Changes apply to core commands, not separately installed plugins, and the release can be installed with heroku update.

## Context

The Heroku CLI needed to stay current while making contributions, building, iteration, maintenance, and feature delivery easier and more confident. Its core command architecture had previously been fragmented between oclif-based and pre-oclif legacy systems.

## Approach / What changed

Heroku moved all core CLI commands to oclif, consolidated them into a single package, improved unit and integration test coverage, added telemetry, and simplified and automated the release process, including support for pre-release versions.

## Takeaways

- All core Heroku CLI commands now use oclif, replacing the previous mixture of oclif and pre-oclif legacy architecture.
- CLI 9.0.0 consolidates core commands into one package and improves testing and release automation, including easier pre-release distribution.
- The upgrade changes output formatting and some command interfaces, removes several deprecated commands, and requires a separator for additional flags; separately installed plugins are unaffected.

**Tags:** [Heroku](https://yomu.fyi/topic/heroku), [oclif](https://yomu.fyi/topic/oclif)

- Source: [Heroku](https://www.heroku.com/blog/heroku-cli-v9-infrastructure-upgrades-oclif-transition)
- Source URL: https://www.heroku.com/blog/heroku-cli-v9-infrastructure-upgrades-oclif-transition
- Ingested by Yomu: 2026-09-10T00:02:53.143Z

[Read original post](https://www.heroku.com/blog/heroku-cli-v9-infrastructure-upgrades-oclif-transition)