/gaia-config-tool

user-facing
Category:
Configuration
Lifecycle phase:
4 -- Implementation

What it does

/gaia-config-tool edits the tool_adapters section of .gaia/config/project-config.yaml. The tool_adapters section maps tool categories (SAST, secrets scanning, SCA, etc.) to specific provider tools and their configuration. The editor preserves all YAML comments and formatting outside the edited section. Every edit goes through a diff preview and confirmation gate before writing.

When to use it

  • You need to add, remove, or modify entries in the tool_adapters configuration section.
  • You set up a new project and need to configure the tool_adapters section.

Prerequisites

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

How to invoke

/gaia-config-tool

What it does step by step

  1. Locate project-config.yaml Resolves the configuration file path.
  2. Extract the tool_adapters section Reads the current tool_adapters block. If the section is missing, offers to scaffold a default.
  3. Present edit menu Shows the current tool_adapters configuration and an operation menu (add, remove, edit, view, exit).
  4. Apply operation Collects the new values and validates them. Provider values should resolve to a built-in or registered adapter.
  5. Diff preview and confirmation Shows a unified diff of what will change. You must confirm before anything is written.
  6. Write back Writes only the modified section, preserving all other content byte-for-byte.
  7. Suggest validation Recommends running /gaia-config-validate to confirm the file still passes schema validation.

Inputs

InputSourceDescription
Project configuration.gaia/config/project-config.yamlThe file containing the tool_adapters section.

Outputs

OutputLocationDescription
Updated tool_adapters section.gaia/config/project-config.yamlThe modified tool_adapters configuration.

Example session

> /gaia-config-tool

Current tool_adapters configuration:
  deploy:
    provider: script-deploy

Operations: [s] set key  [r] remove key  [v] view  [x] exit
> s

Key: dast.provider
Value: owasp-zap

Diff preview:
  tool_adapters:
    deploy:
      provider: script-deploy
  + dast:
  +   provider: owasp-zap

Apply this edit? [y/n]
> y

Tool_adapters section updated. Run /gaia-config-validate to verify.

What to run next

Troubleshooting

tool_adapters section not found

The section does not exist in your config file. The command offers to scaffold a default: 

tool_adapters:
  sast:
    provider: semgrep
  secrets:
    provider: gitleaks
  sca:
    provider: trivy

Edit cancelled

You chose not to apply the edit. The file remains unchanged.