Config reference
Generated by
bun scripts/gen-config-reference.tsfrom the canonical zod schema in@actup/core(configJsonSchema()). Do not edit by hand — editpackages/core/src/config.tsand regenerate.
Config is discovered from (first hit wins): actup.json, .actup.json, .config/actup.json, then the .toml equivalents, then $XDG_CONFIG_HOME/actup/config.json (default ~/.config/actup/config.json). Missing config is not an error — defaults apply.
<key> denotes an arbitrary map key (e.g. a host name under hosts). [] denotes array-element fields. overrides[].policy.* is a partial overlay: an omitted key has no default — it inherits the resolved base policy for the matched action.
| Path | Type | Required | Default | Constraints |
|---|---|---|---|---|
defaultHost | string | no | github.com | — |
fetch | object | no | — | — |
fetch.apiMode | graphql | rest | no | graphql | — |
fetch.maxTagsPerRepo | integer | no | 20 | min 1, max 255 |
fetch.cacheTtl | integer | no | 3600 | min 0 |
fetch.offline | boolean | no | false | — |
hosts | map<string, object> | no | {} | — |
hosts.<key> | object | no | — | — |
hosts.<key>.kind | github | gitlab | gitea | yes | — | — |
hosts.<key>.apiBase | string (uri) | no | — | — |
hosts.<key>.tokenEnv | string | no | — | minLength 1 |
policy | object | no | — | — |
policy.track | keep | major | exact | no | major | — |
policy.pin | keep | tag | sha | no | keep | — |
policy.bump | patch | minor | major | latest | no | major | — |
scan | object | no | {} | — |
scan.patterns | array<string> | no | — | — |
scan.ignore | array<string> | no | — | — |
scan.extraPaths | array<string> | no | — | — |
output | object | no | — | — |
output.format | human | json | sarif | no | human | — |
output.githubAnnotations | boolean | no | false | — |
overrides | array<object> | no | [] | — |
overrides[] | object | no | — | — |
overrides[].pattern | string | yes | — | minLength 1 |
overrides[].policy | object | yes | — | — |
overrides[].policy.track | keep | major | exact | no | — | — |
overrides[].policy.pin | keep | tag | sha | no | — | — |
overrides[].policy.bump | patch | minor | major | latest | no | — | — |