Configuration

Zinc reads the first config file it finds:

.zinc/config.yaml
~/.zinc/config.yaml

Workspace config wins over global config. Zinc does not merge them.

Example

runtime:
  parallel: 4

packages:
  openai-responses:
    packet_limit: 1048576
  unix-bash:
    packet_limit: 262144

runtime:
  parallel: 4

runtime.parallel limits concurrent surface calls in one ready wave. If absent, Zinc runs ready entries serially.

packages:
  unix-bash:
    packet_limit: 262144

packages.<name>.packet_limit controls how much package packet data Zinc keeps for that package.

Zinc chooses the package from the surface ref:

unix-bash.bash -> unix-bash

Config does not choose surfaces. Shape entries choose surfaces.

status:
  surface: unix-bash.bash
  in:
    command: $command
  out:
    output: $output