GitLabgitlab-org

cli

main
ply7 git calls40 ms98 KiB6 cachedprotocol v2
73 lines2.3 KiBRaw

Delete local Git branches whose merge request has been merged.

Synopsis

Delete local Git branches whose merge request has been merged on GitLab.

By default, the command queries GitLab for each local branch and only deletes branches that have at least one merged merge request and no merge requests still open from the same source branch.

Protected branches, the default branch, and the currently checked-out branch are never deleted.

This command only affects your local Git repository. Remote branches on GitLab are not touched.

Use --merged to skip the per-branch merge request lookup and instead rely on git branch --merged to decide which branches to delete. The default branch and protected branches are still fetched from GitLab in this mode. Falling back to Git is faster, but only detects fast-forward merges — squash and rebase merges look like distinct commits to Git and will not be reported as merged.

plaintext
glab repo prune [flags]

Examples

console
# Preview branches that would be deleted
glab repo prune --dry-run

# Delete branches with merged MRs (after confirmation)
glab repo prune

# Delete without confirmation
glab repo prune --yes

# Exclude additional branches by name or glob pattern
glab repo prune --exclude wip-*,demo-branch

# Detect merged branches with Git instead of GitLab (faster, but misses squash and rebase merges)
glab repo prune --merged

Options

plaintext
      --dry-run           Preview branches that would be deleted without deleting them.
  -e, --exclude strings   Branch name or glob pattern to exclude. Comma-separated or repeated.
      --merged            Use 'git branch --merged' instead of querying GitLab. Detects fast-forward merges only.
  -y, --yes               Skip the confirmation prompt.

Options inherited from parent commands

plaintext
  -h, --help   Show help for this command.
1---
2title: '`glab repo prune`'
3stage: AI Clients
4group: Developer Clients
5info: To determine the technical writer assigned to the Stage/Group associated with this page, see <https://handbook.gitlab.com/handbook/marketing/product-and-technical-marketing/technical-writing/#assignments>
6---
8<!--
9This documentation is auto generated by a script.
10Please do not edit this file directly. Run `make gen-docs` instead.
11-->
13Delete local Git branches whose merge request has been merged.
15## Synopsis
17Delete local Git branches whose merge request has been merged on GitLab.
19By default, the command queries GitLab for each local branch and only
20deletes branches that have at least one merged merge request and no
21merge requests still open from the same source branch.
23Protected branches, the default branch, and the currently checked-out
24branch are never deleted.
26This command only affects your local Git repository. Remote branches
27on GitLab are not touched.
29Use --merged to skip the per-branch merge request lookup and instead
30rely on `git branch --merged` to decide which branches to delete.
31The default branch and protected branches are still fetched from
32GitLab in this mode. Falling back to Git is faster, but only detects
33fast-forward merges — squash and rebase merges look like distinct
34commits to Git and will not be reported as merged.
36```plaintext
37glab repo prune [flags]
38```
40## Examples
42```console
43# Preview branches that would be deleted
44glab repo prune --dry-run
46# Delete branches with merged MRs (after confirmation)
47glab repo prune
49# Delete without confirmation
50glab repo prune --yes
52# Exclude additional branches by name or glob pattern
53glab repo prune --exclude wip-*,demo-branch
55# Detect merged branches with Git instead of GitLab (faster, but misses squash and rebase merges)
56glab repo prune --merged
58```
60## Options
62```plaintext
63 --dry-run Preview branches that would be deleted without deleting them.
64 -e, --exclude strings Branch name or glob pattern to exclude. Comma-separated or repeated.
65 --merged Use 'git branch --merged' instead of querying GitLab. Detects fast-forward merges only.
66 -y, --yes Skip the confirmation prompt.
67```
69## Options inherited from parent commands
71```plaintext
72 -h, --help Show help for this command.
73```
Diagnostics7 git calls · 40 ms
CallStatusSizeTime040 ms
discover200185 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=185
git.server.agent=git/2.56.g1891de4-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=185
git.pkt.payload.max=35
ls-refs20058 KiB · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=59849
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=731
git.pkt.data=730
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=59849
git.pkt.payload.max=143
git.ls_refs.count=730
git.ls_refs.head=refs/heads/main
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=4273
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4273
git.pkt.payload.max=4173
git.sideband.band1.bytes=4173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=11
git.pack.bytes=4173
git.fetch.wide.objects=11
git.fetch.wide.extra_bytes=3930
git.fetch.wide.blobs=0
fetchtree:0 · deepen 1020032 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=32926
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=22
git.pkt.data=20
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=32926
git.pkt.payload.max=32046
git.sideband.band1.bytes=32046
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=80
git.pack.bytes=32046
git.pack.ofs_delta=36
git.pack.ref_delta=0
git.pack.chain.max=2
git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91
git.pack.full=44
Open pack map
fetchtree:02001.7 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=1744
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=5e4007a5673eb3bf5d0d7f1a1463c3b2ca3fb3bd
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1744
git.pkt.payload.max=1717
git.sideband.band1.bytes=1717
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1717
git.pack.trailer=3f1b9ccc7756e8941d6705e8187c87fd922113e6
Open pack map
fetchtree:0200594 B · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=594
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=8c893c6ca66ed299ac6c67444dad7529c6f1cb76
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=594
git.pkt.payload.max=567
git.sideband.band1.bytes=567
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=567
git.pack.trailer=e9b8ab0109823c026cdae1074e580843e5061d9f
Open pack map
fetch2001.1 KiB · hit30 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=30
git.response.bytes=1079
git.response.cache=HIT
git.response.duration_ms=30
git.fetch.wants=4e5805510f3f4aa572b288065928985b1966acad
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1079
git.pkt.payload.max=1052
git.sideband.band1.bytes=1052
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://gitlab.com/gitlab-org/cli
Ref
refs/heads/main
Commit
0dd7574dce9e385c5c30540e6c15657adc6bdce9
cf-ray
a5e1f8d59a44efe9
Request
25a90dee…
Protocol
v2 · sha1
Agent
git/2.56.g1891de4-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format