Config reference

sturn.toml — searched at $STURN_CONFIG, ./sturn.toml, ~/.config/sturn/sturn.toml. Unknown fields are rejected. Secrets never live here.

[repo]
dir = "."              # required — the git repo being coordinated
id = "9aia/sturn"      # topic prefix; default: dir basename
branch = "main"        # snap target; default: main

[wal]
ref_prefix = "refs/sturn/wal"   # default

[bus]
store = "~/.local/state/sturn/bus.redb"   # default
poll_ms = 100                             # daemon fan-out interval
# repos = ["../other-repo"]             # extra repos to fan out

[review]
require = true         # snap refuses unreviewed tree ops

[signing]
key = "~/.ssh/id_ed25519"             # sign every event (ssh-keygen)
# allowed_signers = "..."

[actor]
name = "agent-7"       # default: $STURN_ACTOR → $USER → "anon"

See examples/sturn.toml.example in the repo.