CLIPlaybook

How to

Remove generated output

Delete managed channel files before reset or resync.

What changes

clean removes generated Playbook outputs so a repo can reset channel artifacts or preview deletions before changing channels.

When this helps

  • A channel was disabled and managed output should be removed.
  • Generated files are stale and you want a clean sync.
  • You need to preview cleanup before deleting files.

Run this command

terminal
sumr playbook clean --dry-run# preview deletionssumr playbook clean --channel codex# clean one channel

Flags you can use

--channel <id>

Clean only one AI Channel. Supported ids are claude, codex, cursor, copilot, gemini, and opencode.

--dry-run

List files that would be removed without deleting them.

--json

Return a structured JSON envelope for scripts, CI jobs, and AI assistants.

--help, -h

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

Keep in mind

  • This command targets SUMR-managed outputs. Do not use it as a general repo cleanup tool.
  • Run sync after cleanup when you still want generated files for enabled channels.