Atmos Settings

Use this skill for global atmos.yaml options that are not owned by a narrower subsystem skill.

Owned Sections

Section	Use for
`settings`	Global CLI behavior, terminal behavior, telemetry, experimental options
`logs`	Log level, log file path, log color, debug output behavior
`errors`	Error output formatting and error reporting options
`env`	Environment variables applied to Atmos operations
`docs`	Documentation generation defaults
`metadata`	Project-level metadata such as name, tags, and version
`version`	Minimum or maximum Atmos version constraints

If a setting belongs to a subsystem such as templates, validation, auth, CI, or toolchain, load that subsystem skill instead.

Common Pattern

settings:
  terminal:
    pager: false
    syntax_highlighting:
      enabled: true
  telemetry:
    enabled: false

logs:
  level: Info

env:
  AWS_REGION: us-east-1

metadata:
  name: platform-infrastructure

YAML Function Execution

Set settings.functions.exec.max_concurrency in atmos.yaml to a positive integer. Default 1 preserves serial execution; a higher limit allows ordinary !exec entries in the same document evaluation to overlap, with results assigned to their original locations. Users are responsible for shell side effects and dependencies. Use atmos-yaml-functions for syntax and output decoding.

Terminal Appearance and Color

settings.terminal controls Atmos's terminal output appearance (color, theme, width, unicode, syntax highlighting, pager). Fields:

settings:
  terminal:
    color: true               # Explicitly force color on (overrides TTY auto-detection)
    no_color: false           # Deprecated: use the --no-color flag or ATMOS_NO_COLOR/NO_COLOR env vars instead
    force_color: false        # ENV-only (ATMOS_FORCE_COLOR) -- not settable from this config field
    theme: dracula             # Theme name; see `atmos theme list` for available names
    max_width: 120
    unicode: true
    syntax_highlighting:
      enabled: true
    pager: false               # false/true/off/on/"less"/a specific pager command

Precedence: no_color (config) is deprecated in favor of the --no-color flag/env vars below. IsColorEnabled logic: no_color forces color off; else explicit color: true forces it on; otherwise Atmos falls back to TTY auto-detection.

Flags and Environment Variables

Flag	Env vars	Effect
`--no-color`	`ATMOS_NO_COLOR`, `NO_COLOR`	Disable all color output, including logs; overrides `--force-color`
`--force-color`	`ATMOS_FORCE_COLOR`, `CLICOLOR_FORCE`	Force color output even when not a TTY (e.g. piped/CI output, screenshots)
`--logs-color`	`ATMOS_LOGS_COLOR`	Log color only (`logs.color`, default `true`); `false` keeps logs plain while UI output stays colored

CLICOLOR=0 disables color unless forced. Nonempty NO_COLOR always wins, even over --no-color=false.

`atmos theme` Commands

Discover and preview themes (a theme controls tables, markdown rendering, and help text colors):

atmos theme list                 # List all available themes
atmos theme list --recommended   # Only themes tested for optimal compatibility
atmos theme show <theme-name>    # Preview a theme's palette and sample UI elements
atmos theme browse               # Interactive/searchable theme gallery (docs site)
atmos list themes                # Alias for 'theme list'; defaults to recommended-only, use --all for all

Activate a theme via ATMOS_THEME=<theme-name> env var or settings.terminal.theme in atmos.yaml.

Command Documentation

Use the global --docs=md flag to retrieve a command's documentation in the terminal:

atmos terraform plan --docs=md --no-color

The source .md URL is printed and the fetched page uses Atmos's shared Markdown renderer. --no-color keeps output plain for agent tool calls. --docs=markdown is an alias; bare --docs prints and opens the web page in a browser. --docs=false disables discovery. Built-in discovery runs before command validation and execution, so no component, stack, credentials, or valid project configuration is required. Use --help=usage for local syntax and --docs=md for extended guidance.

The docs section in atmos.yaml configures documentation generation; --docs=md retrieves published command documentation. See atmos-introspection for retrieval and fallback guidance.

Routing

Need	Load
Template settings	`atmos-templates`
Validation settings and policies	`atmos-validation`, `atmos-schemas`
Auth or identity settings	`atmos-auth`
Native CI settings	`atmos-ci`
Toolchain settings	`atmos-toolchain`
Stack/component `settings` fields	`atmos-stacks`, `atmos-components`

Guardrails

Treat env as global process environment. Use component, workflow, command, or auth-specific env settings when only one execution context needs the variable.
Do not put subsystem-specific details here just because they live under settings; route to the owning skill first.
Prefer explicit, stable global settings over hidden shell assumptions.

SKILL.md