Heroku CLI Style Guide

Heroku's internal style guide for CLI design, made public to share their lessons in building a polished developer experience. Covers naming, output, error handling, JSON output, and progressive disclosure of power-user features.

API entry from apis.yml

apis.yml Raw ↑
aid: command-line-interface:heroku-cli-style-guide
name: Heroku CLI Style Guide
description: Heroku's internal style guide for CLI design, made public to share their lessons in building
  a polished developer experience. Covers naming, output, error handling, JSON output, and progressive
  disclosure of power-user features.
humanURL: https://devcenter.heroku.com/articles/cli-style-guide
baseURL: https://devcenter.heroku.com
tags:
- Best Practices
- Developer Experience
- Heroku
- Style Guide
properties:
- type: Documentation
  url: https://devcenter.heroku.com/articles/cli-style-guide
x-features:
- Real-world style guide from a CLI-first developer platform
- Covers naming, output, errors, and machine-readable formats
- Aligns with broader CLI Guidelines philosophy
x-useCases:
- Establishing tone and output conventions for a new CLI
- Comparing alternative approaches to error reporting and progress