Skip to main content

Terminal Settings

Atmos provides configurable terminal settings that allow you to customize the output appearance, including syntax highlighting for YAML and JSON outputs. These settings can be configured in your atmos.yaml configuration file.

You will learn

  • Configure syntax highlighting for terminal output
  • Customize color schemes and formatting options
  • Control output pagination and line wrapping
  • Set display preferences for different output formats

General Terminal Settings​

Configure general terminal behavior. These are also the default settings if not specified in your atmos.yaml:

settings:
  terminal:
    max_width: 120        # Maximum width for terminal output
    pager: true          # Pager setting for all terminal output
    colors: true          # Enable colored output
    unicode: true         # Use Unicode characters in output

Syntax Highlighting​

You can customize the syntax highlighting behavior for terminal output using the following settings:

settings:
  terminal:
    syntax_highlighting:
      enabled: true                 # Enable/disable syntax highlighting
      formatter: terminal           # Output formatter
      theme: dracula                # Color scheme to use
      line_numbers: false           # Show line numbers
      wrap: false                   # Wrap long lines

Configuration Options​

enabled
Enable or disable syntax highlighting (default: true)
formatter
Output formatter (default: terminal)
theme

Color scheme for syntax highlighting. Available options include:

  • vim
  • monokai
  • github
  • dracula
  • ...and many other standard themes

You can find the full list of supported themes here.

pager
Whether to use a pager specifically for syntax-highlighted output. This setting is independent of the pager setting (default: false)
line_numbers
Show line numbers in output (default: false)
wrap
Wrap long lines (default: false)

Example Usage​

The syntax highlighting is automatically applied when using commands that output YAML or JSON, such as:

# Display config in YAML format with syntax highlighting
atmos describe config -f yaml
# Display config in JSON format with syntax highlighting
atmos describe config
NOTE:

When the output is piped to another command, syntax highlighting is automatically disabled to ensure compatibility:

# Syntax highlighting is disabled when piping
atmos describe config | grep base_path

Supported Themes​

Atmos supports a wide range of themes for syntax highlighting. You can find the full list of supported themes here.