ACE - Support Config

Shared configuration cascade primitives for ACE libraries and tools. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

Usage Guide ace-support-config provides layered configuration loading and merging for ACE, resolving values from .ace project files, user home defaults, and gem-bundled defaults with deterministic precedence. Used by ace-llm, ace-search, ace-review, and most other ACE packages.

How It Works

  1. A resolver builds a configuration cascade from the nearest .ace directory up to user-home and gem-default layers.
  2. Resolved values are merged using configurable merge strategies with deterministic precedence.
  3. Consumers access resolved config by namespace, file path, or direct lookup.

Use Cases

Load layered configuration safely - combine project, user, and default values with deterministic precedence for any ACE package.

Support project-specific overrides - place .ace files near the execution context to customize behavior while keeping defaults stable across tools like ace-llm and ace-review.

Resolve namespaces consistently - access configuration across tools using shared resolver methods, so ace-llm-providers-cli and ace-search get the same cascade behavior.

Usage Guide | Part of ACE