.nh
.TH "pogo" "1" "Dec 2025" "pogo/dev" "Pogo Manual"

.SH NAME
pogo-rm - Remove a change from the repository


.SH SYNOPSIS
\fBpogo rm  [flags]\fP


.SH DESCRIPTION
Remove a change from the repository permanently.

.PP
This is a destructive operation that cannot be undone. Use with caution!

.PP
By default, this command removes:
- The specified change
- All child changes (recursively)
- All associated file data

.PP
With --keep-children flag:
- Only removes the specified change
- Reconnects children to the removed change's parent(s)
- Preserves the rest of the history tree

.PP
You cannot remove:
- The change you're currently working on
- Changes that have bookmarks pointing to them
- The root change of the repository

.PP
This command is useful for:
- Cleaning up experimental branches that didn't work out
- Removing accidentally created changes
- Pruning unnecessary history before archiving

.PP
This command pushes any changes before running.

.PP
In interactive mode, you will be prompted to confirm before deletion.
Use --force to skip confirmation.


.SH OPTIONS
\fB-f\fP, \fB--force\fP[=false]
	Skip confirmation prompt

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for rm

.PP
\fB--keep-children\fP[=false]
	Only remove the specified change and move its children to its parents


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--time\fP[=false]
	Measure command execution time

.PP
\fB-v\fP, \fB--verbose\fP[=false]
	Enable verbose debug logging


.SH EXAMPLE
.EX
# Remove a change and all its descendants
pogo rm experimental-feature-27

# Remove only the specific change, preserving children
pogo rm broken-change-15 --keep-children

# Remove a change that was created by mistake
pogo rm accidental-branch-3

# Skip confirmation prompt
pogo rm experimental-feature-27 --force

# Cannot remove bookmarked changes
pogo rm main  # Error: cannot remove bookmarked change
.EE


.SH SEE ALSO
\fBpogo(1)\fP