How to

Create sumr.yaml

Write the repo config that CLI workflows read.

What changes

sumr init writes the sumr.yaml file used by Playbook sources and enabled AI Channels. Run it once per repo, then adjust workflow-specific config as the repo grows.

When this helps

A repository has no sumr.yaml yet.
Playbook needs explicit docs source paths.
You want a repeatable repo setup step before workflow-specific commands.

Run this command

terminal

$sumr init# create config interactively$sumr init --yes# use defaults$sumr init --source docs,standards# set docs paths

Flags you can use

--source <paths>

Set comma-separated Playbook source folders, such as docs or docs,standards.

--yes

Skip prompts and create or update sumr.yaml with defaults. Use in scripts only when overwriting is expected.

--help, -h

Show the command syntax, supported flags, and examples without changing files.

Keep in mind

Do not run this blindly in a dirty repo if a hand-authored sumr.yaml already exists.
After changing Playbook source paths, run sumr playbook status to confirm the repo sees them.