cli-tools

Personal shell utilities for git branch hygiene, GPG cache warming, and Claude plugin static analysis.

Installation

Homebrew (recommended)

brew tap 1shooperman/tap
brew install cli-tools

Manual

Add bin/ to your $PATH:

export PATH="$PATH:/path/to/cli-tools/bin"

Tools

gitprune [--force]

Deletes local branches that no longer exist on the remote, then runs git gc and git fetch -p.

Flag	Behavior
(none)	Safe delete — skips unmerged branches (-d)
--force	Force delete — removes unmerged branches too (-D)

gitprune          # safe
gitprune --force  # nuke unmerged branches too

gitrefresh [branch]

Checks out a branch (default: main), pulls the latest, then force-prunes stale local branches twice to handle cascading deletions.

gitrefresh        # resets to main
gitrefresh dev    # resets to dev

cache-gpg

Warms the GPG agent cache by performing a throwaway clearsign. Useful to pre-unlock the key before a commit flow that requires signing.

cache-gpg

sast

Static analysis for Claude plugin markdown files. Scans plugins/ for risky allowed-tools declarations in YAML frontmatter.

Severity	Check
ERROR	Bare Bash or Bash(*) — unrestricted shell access
ERROR	Wildcard [*], Agent(*), or Skill(*) — all tools granted
WARN	Bare WebFetch — any domain fetchable

sast

Exits non-zero if any ERROR findings are found.

Structure

bin/
  cache-gpg     # warms GPG agent cache
  gitprune      # wrapper for gitprune()
  gitrefresh    # wrapper for gitrefresh()
  sast          # static analysis for claude plugin frontmatter
lib/
  gitcmds.sh    # shared function definitions

License

MIT — see LICENSE.