Configuration

Configuration

Zinc reads workspace .zinc/config.yaml and global ~/.zinc/config.yaml.

mode: build
scope: project

runtime:
  parallel: true
  max_parallel: 0

models:
  default: fast

  fast:
    adapter: @responses.adapters.responses
    params:
      model: gpt-4.1-mini
      temperature: 0.2

  careful:
    adapter: @responses.adapters.responses
    params:
      model: gpt-4.1
      temperature: 0.1
      reasoning:
        effort: medium

Runtime

runtime:
  parallel: true
  max_parallel: 0

max_parallel: 0 means unbounded. max_parallel: 1 means serial. parallel: false means serial.

Model presets

Circuitry files select presets with model, but do not define them.

Zinc config defines what a preset means. The selected adapter receives the part name, preset params, instructions, typed inputs, and expected gives. It returns visible text, optional reasoning, typed gives, and artifacts.

Package aliases

A Circuitry file can declare package aliases:

zinc:
  packages:
    browser: zinc://package/browser@0.6.1
    responses: zinc://package/openai-responses@0.1.0

During a run, Zinc merges these aliases into the resolution context so @browser.shapes.search-web and @responses.adapters.responses can resolve.

Modes and scopes

mode controls governed shell policy. scope controls the intended filesystem boundary.

Configuration stays host-owned. Circuitry stays focused on system shape.