Heroku CLI v10: Support for Next Generation Heroku Platform

The Heroku CLI is a vital tool for developers, providing a simple, extensible way to interact with the powerful features Heroku offers. We understand the importance of keeping the CLI updated to enhance user experience and ensure stability. With the release of Heroku CLI v10, we’re excited to introduce key changes that enhance the user experience and improve compatibility with the next-generation Heroku platform.

What's New in Version 10.0.0?

Heroku CLI v10 introduces several breaking changes, updates for Fir (the next-generation Heroku platform), and overall performance improvements. Here's a breakdown of the key features:

Breaking Changes

• Node.js 20 Upgrade:
  The CLI has been upgraded to Node.js 20, which brings performance improvements, security fixes, and better compatibility with modern development environments.
• Changes to heroku logs Command:
  
  • The --dyno flag for specifying the process type and dyno name is now deprecated.
  • Cedar apps: The --dyno flag will continue to work but will be deprecated.
  • Fir apps: Users will need to use the new --process-type or --dyno-name flags instead.
• Changes to ps:stop and ps:restart Commands:
  
  • Positional arguments for process type and dyno name are deprecated in ps:stop and ps:restart.
  • Cedar apps: Positional arguments will still work with a deprecation warning.
  • Fir apps: Users must use the --process-type or --dyno-name flags.
• Compatibility with Fir Apps:
  Several commands no longer work with Fir apps, including heroku run, heroku ps:exec, heroku ps:copy, heroku ps:forward, and heroku ps:socks.
  • Users should now use heroku run:inside, which is designed to work with Fir apps but not with Cedar apps.

Support for Next-Generation Heroku Platform (Fir)

• OpenTelemetry Support:
  A new suite of commands under heroku telemetry allows seamless integration with OpenTelemetry for Fir apps, enabling better observability. Check out our DevCenter documentation on telemetry drains for setup instructions.
• Spaces Updates:
  
  • The heroku spaces:create command now supports a new --generation flag, allowing users to specify whether they are creating a Cedar or Fir space.
  • A pilot warning message will appear when Fir is selected.
  • heroku spaces, heroku spaces:info and heroku spaces:wait now display the generation of the space.
• Pipelines and Buildpacks:
  
  • heroku pipelines:diff has been updated to support Fir generation apps.
  • The heroku buildpacks command now lists buildpacks specific to Fir apps, based on the latest release.
• Improved Logs for Fir Apps:
  
  • heroku logs now includes a --tail flag for Fir apps to stream logs in real time.
  • A new "Fetching logs" message is displayed as logs are being retrieved.
  • Color rendering issues have been fixed to ensure consistent log output.

Other Updates

• oclif Upgrade: The CLI has been upgraded to oclif v4.14.36, providing a more stable and modular architecture.
• GitHub Workflows: Updated GitHub workflows and actions now run on Node 20

Why These Updates Matter

The upgrade to Node.js 20 sets a solid foundation for future improvements and feature releases. These changes also help ensure that your Heroku CLI experience stays smooth and reliable as we continue to innovate.

The CLI is now ready for the next-generation Fir platform, making it easier to manage and deploy modern apps with enhanced observability, performance, and flexibility.

Ready to upgrade? Update to CLI version 10.0.0 by running heroku update. For more installation options, visit our Dev Center. We encourage you to try it and share your feedback for enhancing the Heroku CLI and for our full Heroku product via the Heroku GitHub roadmap.