Skip to content

gman logo

gman

Your repos. Under investigation.

gman is a terminal tool for managing the GitHub repositories you own. It puts your whole account on one screen — then lets you prune, retag, archive, sync, and clean up from right there, without a browser tab in sight.

Use it two ways:

  • The TUI — an interactive table of every repo you own. Filter, inspect, multi-select, and act. Start it with gman tui (or gman-tui).
  • The CLI — scriptable commands for everything the TUI does and more: gman list --json, gman bulk --all --delete-branch-on-merge on, gman actions myrepo --clear-artifacts, …

What can it do?

I want to… Reach for
See every repo I own, at a glance gman tui or gman list
Dig into one repo — CI status, traffic, alerts, releases gman info or press Enter in the TUI
Fix descriptions, topics, homepages, settings gman edit or the TUI's edit keys
Apply one change to many repos gman bulk or the TUI's bulk menu
Delete dead repos — safely gman delete --backup or d in the TUI
Keep forks in step with upstream gman sync or s in the TUI
Free GitHub Actions storage gman actions
Start a new repository gman new
Hand a spreadsheet to someone gman excel

Every feature degrades gracefully to what your token allows — fields you can't see show a dash and a hint instead of an error. See Tokens & permissions.

Install

uv tool install gman     # or: pipx install gman  /  pip install gman

That installs two commands:

  • gman — the full CLI (gman --help lists every command)
  • gman-tui — jumps straight into the interactive table

Then head to Getting started to connect your GitHub account — it takes about a minute.