Skip to main content

atmos theme list

Purpose

Use this command to discover and browse available terminal themes that can be used to customize the appearance of Atmos CLI output, including tables, markdown rendering, and help text.

atmos theme list --help

Usage​

atmos theme list [options]

By default, this command lists all available themes. Use the --recommended flag to show only themes tested for optimal compatibility.

Examples​

# List all available themes
atmos theme list

# Show only recommended themes for best compatibility
atmos theme list --recommended

Arguments​

This command does not require any arguments.

Flags​

--recommended
Show only recommended themes that have been tested for optimal readability and compatibility with Atmos

Output​

The command displays a table with the following information:

  • Name - The theme name to use with ATMOS_THEME environment variable or settings.terminal.theme in atmos.yaml
  • Type - Whether the theme is optimized for Dark or Light terminals
  • Rec - Shows "★" for recommended themes when listing all themes
  • Source - Attribution or link to the theme's original source

Setting a Theme​

To use a theme from the list:

  1. Environment variable: Set ATMOS_THEME=<theme-name> before running Atmos commands
  2. Configuration file: Add to your atmos.yaml: 
    settings:
      terminal:
        theme: <theme-name>

Alias​

The atmos list themes command is an alias for atmos theme list and behaves identically, except it shows only recommended themes by default and uses the --all flag to show all themes.