Script reference¶
All scripts self-document with --help. Examples assume cli/ is on your PATH.
Bash scripts run on macOS bash 3.2+; Python scripts need python3.
Git & GitHub¶
gh-merge-pr.sh¶
Merge a PR safely: polls mergeability, refuses CONFLICTING, confirms first.
gh-create-repo.sh¶
Create a repo and optionally init/commit/push a local dir.
gh-rename-repo.sh¶
Rename a repo and rewrite the local origin.
gh-enable-pages.sh¶
Enable GitHub Pages via the API (Actions or branch source). Repo owner.
gh-pr-open.sh¶
Push the current branch and open a PR in one step.
gh-pr-status.py¶
One table of every open PR with CI / review / mergeable state.
gh-release.py¶
Bump version, build a changelog from commits since the last tag, tag, and release.
gh-rename-org.sh¶
Rename an organization. Checks you own it and the new name is free, opens the
settings page (github.com has no rename API), waits until GitHub serves the new
name, repoints remotes under --scan-dir, and lists files still naming the old org.
gh-org-clone.sh¶
Clone every repo of an org into one directory; --pull fast-forwards existing
clones (dirty ones are skipped, never reset).
gh-issues-sync.py¶
Create issues from a JSON list of {title, body, labels}. Missing labels are
created first (priority P1-P3, area:* and type labels get consistent colors);
an issue whose title already exists, open or closed, is skipped, so re-runs never
duplicate. Preview by default (exit 2 when there is something to create).
gh-org-ci.sh¶
Latest GitHub Actions runs for every repo of an org (or --repos), one table, with
the URL of each failed run. --wait polls until nothing is running; exit code 2
when any shown run failed.
git-split-repo.sh¶
Extract files or directories into a new repo, keeping their commit history
(via git-filter-repo). Paths can be moved, including to the root; the source
repo is never modified. --publish creates the GitHub repo and pushes.
git-split-repo.sh <source-repo> <target-dir> (-p src[=dest] | -m manifest)... [-b branch]
[--publish owner/name] [--public|--private] [-d desc] [-y]
Manifest lines are <src> [<dest>]; . as dest moves a directory to the root;
a line !<path> drops that path (and its history) from inside a kept directory.
git-replace.sh¶
Replace a literal string in every tracked text file. Preview by default (exit 2
when matches exist), --apply to write; pathspecs include or exclude files.
git-conflict-helper.sh¶
Rule-based guide to merge/rebase conflicts. See Resolving conflicts.
git-safe-checkout.sh¶
Switch branches without silently losing uncommitted work.
git-clean-branches.sh¶
Delete branches already merged into the base (local, and --remote).
git-sync.sh¶
Catch up: fetch, fast-forward base, prune, rebase current branch. Refuses a dirty tree.
Dev environment¶
dev-doctor.sh¶
Report which required tools are present, with install hints. Non-zero if a core tool is missing.
proj-bootstrap.sh¶
Scaffold a new project: git, ignore, README, pre-commit, CI, optional license.
proj-bootstrap.sh [dir] [--name n] [--flavor python|node|generic] [--license mit|none] [--no-git] [-y]
precommit-install.sh¶
Install (and optionally scaffold) pre-commit hooks; offers to pip-install pre-commit.
py-venv-rebuild.sh¶
Rebuild a virtualenv whose interpreter went stale; reinstall requirements.
py-check.sh¶
Run ruff + mypy + pytest (+ coverage) in one pass; skips missing tools.
Cross-language dependency & library tooling¶
Python-powered, polyglot: each detects the manifests present
(requirements.txt/pyproject.toml, package.json, go.mod, Cargo.toml,
Gemfile, pom.xml) and acts on all of them. Toolchains that aren't installed
are skipped with a note rather than failing.
deps-outdated.py¶
Outdated packages across pip / npm / cargo / go, one table.
deps-unused.py¶
Declared-but-never-imported dependencies (Python + Node, heuristic).
lockfile-drift.py¶
Flag manifests whose lockfile is missing or older than the manifest.
vuln-scan.py¶
Run each ecosystem's audit tool (pip-audit/npm audit/cargo audit/govulncheck) and normalize.
lic-audit.py¶
Collect dependency licenses; flag GPL/AGPL/LGPL and unknown.
version-bump.py¶
Bump the project version in whatever manifest(s) the repo uses, atomically.
env-check.py¶
Diff .env against .env.example; report missing/extra keys. Language-agnostic.
Data & housekeeping¶
data-convert.py¶
Convert between CSV, JSON, and YAML (YAML needs PyYAML).
clean-artifacts.sh¶
Delete build/cache junk (__pycache__, dist, caches, .DS_Store, …). Dry-run by default.
secret-scan.py¶
Scan staged files (or given paths) for likely secrets; exits non-zero on a hit.
snapshot.sh¶
Timestamped tar.gz of a directory before a risky operation.
port-kill.sh¶
Kill the process listening on a TCP port (not a client connected to it).