pr-cleanup

A command for cleaning up local and remote Git branches and worktrees after pull requests are merged or closed. A worktree is another working folder linked to the same Git repository.

In plain words
What is it for?
Use it to clean up selected pull requests or all merged or closed ones, optionally remove a worktree, preview the changes, or force cleanup of an unmerged branch.
Why use it?
It removes leftover branches and folders while checking that the current or protected branches are not deleted by mistake.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/byx-darwin/gitflow-cli/pr-cleanup
Clone the repo
git clone --depth 1 https://github.com/byx-darwin/gitflow-cli
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 892 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00892
Opus 5 $0.00000 $0.00446
Sonnet 5 $0.00000 $0.00178
Haiku 4.5 $0.00000 $0.00089

Measured yesterday against content hash a29c3d410141, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

pr-cleanup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/commands/pr-cleanup.md · 151 lines

How it starts

The opening of the file, as written. The whole thing — 151 lines — stays where its author put it; the contents beside it link to each section on GitHub.

gf pr cleanup

Safely clean up branches and worktrees after PR merge.

Synopsis

gf pr cleanup <NUMBER>... [OPTIONS]
gf pr cleanup --merged [OPTIONS]
gf pr cleanup --closed [OPTIONS]

Description

The cleanup command safely removes branches and worktrees associated with merged or closed pull requests. It performs safety checks to prevent accidental deletion of protected branches or the current branch.

This command is particularly useful in worktree-based workflows where gh pr merge --delete-branch fails because the branch is checked out in a worktree.

Arguments

<NUMBER>... : One or more PR numbers to clean up. Mutually exclusive with --merged and --closed.

Options

--worktree <PATH> : Remove the specified worktree path after cleanup.

--remote : Delete remote branches (default: true).

--local : Delete local branches (default: true).

--force : Force cleanup of unmerged branches. Bypasses PR state check but not protected branch check.

--dry-run : Show what would be done without actually deleting anything.

--yes, -y : Skip interactive confirmation.

--merged : Clean up all merged PRs. Mutually exclusive with <NUMBER>....

--closed : Clean up all closed PRs. Mutually exclusive with <NUMBER>....

Safety Checks

The command performs the following safety checks before deletion:

  1. PR State: Only allows cleanup of merged or closed PRs (unless --force is used)
  2. Protected Branches: Refuses to delete protected branches (main, master, develop, release/*)
  3. Current Branch: Refuses to delete the currently checked-out branch

These checks cannot be bypassed except for the PR state check (using --force).

Worktree Handling

When running in a worktree:

  1. Automatically detects if currently in a worktree
  2. Exits the worktree and returns to the main repository
  3. If --worktree <PATH> is specified, removes the worktree directory
  4. If --worktree is not specified, preserves the worktree directory and displays a message

Read the full file on GitHub · 151 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 151 lines · 0 tokens per session scan A a29c3d410141

Subscribe to this mod's changes

pr-cleanup is a command published in the GitHub repository byx-darwin/gitflow-cli (2 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 892 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.