Configuration File

aix uses a YAML configuration file to store user preferences and platform overrides. This file is typically located at ~/.config/aix/config.yaml.

File Location#

aix searches for the configuration file in the following order:

1. Environment Variable: The path specified in AIX_CONFIG_DIR.
2. Current Directory: ./config.yaml.
3. XDG Config Home: ~/.config/aix/config.yaml (Linux/macOS) or %APPDATA%\aix\config.yaml (Windows).

You can initialize a new configuration file with defaults by running:

aix init

Structure#

The configuration file is a flat YAML dictionary with the following top-level keys.

version: 1
default_platforms:
  - claude
  - opencode
platforms:
  claude:
    config_dir: "/custom/path/to/claude"

version#

• Type: integer
• Default: 1
• Description: The schema version of the configuration file. Currently, 1 is the only supported version.

default_platforms#

• Type: array of string
• Default: ["claude", "opencode", "codex", "gemini"]
• Description: A list of platforms to target by default when no --platform flag is provided to CLI commands.
• Valid Values: claude, opencode, codex, gemini.

platforms#

• Type: dictionary (Platform Name -> Override Object)
• Default: {} (Empty)
• Description: Platform-specific overrides. Useful if you have installed an AI assistant in a non-standard location.

platforms.<name>.config_dir#

• Type: string
• Description: The absolute path to the configuration directory for the specified platform.
• Example:

  platforms:
    claude:
      config_dir: "/Users/me/.config/claude-dev"

Environment Variables#

You can override configuration values using environment variables prefixed with AIX_.

Example:

export AIX_DEFAULT_PLATFORMS="opencode"
aix skill list  # Will only list OpenCode skills by default