Reference
Global Config
Reference for the ~/.airlock/config.yml configuration file.
The global config file lives at ~/.airlock/config.yml. It controls daemon behavior, agent selection, and storage. All fields are optional — sensible defaults are used when omitted.
The config path follows AIRLOCK_HOME if set. For example, AIRLOCK_HOME=/opt/airlock reads config from
/opt/airlock/config.yml.
Full Example
# ~/.airlock/config.yml
agent:
adapter: claude-code
options:
model: null
max_turns: 50
sync:
on_fetch: true
storage:
max_artifact_age_days: 30agent
Configures the AI agent used by airlock exec agent in workflow steps.
| Field | Type | Default | Description |
|---|---|---|---|
agent.adapter | string | "auto" | Which agent adapter to use (see below) |
agent.options.model | string | — | Model override passed to the adapter |
agent.options.max_turns | number | — | Maximum turns per agent invocation |
Available Adapters
| Value | Agent |
|---|---|
auto | Auto-detect installed agent |
claude-code | Anthropic Claude Code |
codex | OpenAI Codex CLI |
agent:
adapter: claude-codesync
Controls repository sync behavior.
| Field | Type | Default | Description |
|---|---|---|---|
sync.on_fetch | boolean | true | Sync gate repos from upstream on fetch operations |
sync:
on_fetch: truestorage
Controls artifact retention.
| Field | Type | Default | Description |
|---|---|---|---|
storage.max_artifact_age_days | number | 30 | Days to keep artifacts before automatic cleanup |
storage:
max_artifact_age_days: 30Related
- Agent Integration — How agents are used in workflows
- Environment Variables — Variables available to workflow steps
- CLI Reference — The
airlockcommand-line interface