fleet.json declares which repositories the fleet may touch and the policies it checks. The CLI reads it with loadConfig, validating it with validateConfig; any violation throws ConfigError with the message Invalid fleet config: <path>: <message>. Related: cikick-fleet CLI, Fleet, Fleet setup.
The selection. Each entry must match ^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$ (owner/repo).
groups
Record<string, string[]>
no
Named subsets of repos. Every member must be in repos.
settingsPolicy
SettingsPolicy
no
Desired repository Actions settings.
secretPolicies
SecretPolicy[]
no
Expected secrets and maximum ages.
Unknown top-level keys are ignored by validation and dropped when saveConfig rewrites the file. saveConfig writes repos sorted, then groups (only if non-empty), settingsPolicy, secretPolicies, as 2-space JSON with a trailing newline.
Whether workflows may approve pull request reviews.
allowedActions
"all" | "local_only" | "selected"
Which actions may run.
selectedActions.githubOwnedAllowed
boolean
Allow GitHub-owned actions (when allowedActions is selected).
selectedActions.verifiedAllowed
boolean
Allow verified-creator actions.
selectedActions.patternsAllowed
string[]
Allowed action patterns; compared as an unordered set.
requireRuleset
{ branch: string }
Report-only: a non-disabled branch ruleset must cover refs/heads/<branch> (or include ~DEFAULT_BRANCH / ~ALL). Never applied. Reported as info when absent, with branch protection only or none as the actual value.
Validation errors: settingsPolicy: expected an object; settingsPolicy.<key>: expected one of ...; expected boolean; settingsPolicy.selectedActions: expected an object; settingsPolicy.selectedActions.patternsAllowed: expected string[]; settingsPolicy.requireRuleset: expected { branch: string } (branch must be a non-empty string).
Restrict the policy to these repos; each must be in top-level repos.
group
string
no
Restrict the policy to this group; must exist in groups.
With neither repos nor group the policy applies to every selected repo. If both are given, repos narrows the group. The --repos/--group CLI options narrow further.
Validation errors (path prefix secretPolicies[i]): .name: expected non-empty string; .scope: expected one of repo, env; .environment: required when scope is "env"; .maxAgeDays: expected positive number; .repos: <r> is not in "repos" (and expected "owner/repo" for malformed entries); .group: unknown group "<g>". For groups: groups.<g>: <r> is not in "repos"; groups: expected an object of name -> repo[]. secretPolicies: expected an array; the root must be an object ($: expected an object).