Home

stencila site branch delete

Delete a branch from the site

Usage

stencila site branch delete [OPTIONS] <BRANCH_NAME>

Examples

# Delete a feature branch (with confirmation)
stencila site branch delete feature-xyz

# Delete a branch without confirmation
stencila site branch delete feature-xyz --force

# Delete a branch from another workspace
stencila site branch delete feature-xyz --path /path/to/workspace

Arguments

NameDescription
<BRANCH_NAME>The branch name to delete.

Options

NameDescription
-p, --pathPath to the workspace directory containing .stencila/site.yaml.
-f, --forceSkip confirmation prompt. Possible values: true, false.

Notes

  • Protected branches (main, master) cannot be deleted

  • Deletion is asynchronous and happens in the background

  • Cache will be purged automatically for the deleted branch

© 2026 Stencila