/gaia-config-show

user-facing
Category:
Configuration
Lifecycle phase:
4 -- Implementation
Arguments:
[section-name]

What it does

/gaia-config-show displays your .gaia/config/project-config.yaml file in read-only mode. With no argument, it shows the entire file. With a section name argument (e.g., environments, stacks), it shows only that section. Output is byte-verbatim -- comments and formatting are preserved exactly.

When to use it

  • You want to check the current configuration before or after making edits.
  • You want to view a specific section without opening the file manually.

Prerequisites

  • project-config.yaml must exist. Run /gaia-init to create one.

How to invoke

/gaia-config-show
/gaia-config-show environments

What it does step by step

  1. Locate project-config.yaml Resolves the configuration file path.
  2. Render the file or section Outputs the entire file or the named section verbatim. Uses syntax highlighting when available.

Inputs

InputSourceDescription
section-nameCommand argument (optional)A top-level section name: project, stacks, platforms, regimes, ci_cd, environments, test_execution, tool_adapters, rubrics, compliance, deployment.

Outputs

OutputLocationDescription
Console outputTerminalThe configuration content displayed verbatim.

Example session

> /gaia-config-show environments

environments:
  staging:
    url: https://staging.example.com
    credentials:
      db_password: STAGING_DB_PASSWORD_VAR
  production:
    url: https://app.example.com
    credentials:
      db_password: PROD_DB_PASSWORD_VAR

What to run next

  • Use the corresponding /gaia-config-* editor to modify a section.
  • /gaia-config-validate -- validate the configuration.

Troubleshooting

Section not found

The section name you provided does not exist in the config file. Check the available section names (project, stacks, platforms, etc.).

project-config.yaml not found

No configuration file exists. Run /gaia-init to create one.