Skip to content

README.md

Latest commit

 

History

History
112 lines (83 loc) · 5.85 KB

README.md

File metadata and controls

112 lines (83 loc) · 5.85 KB
Raw

Scripts

Standalone developer tools. Run directly from the command line.

pr-dash.py

Local PR dashboard and inbox. Aggregates your PRs, reviews you owe, and worktree status into a single web view, across one or more repos.

pip install flask
python pr-dash.py              # http://127.0.0.1:8765
python pr-dash.py --port 9000  # custom port

Features:

  • Reviews you owe float to the top
  • Color-coded reviewer status (approved / pending / commented); bot reviewers hidden
  • Worktree status: dirty files, unpushed commits, merge conflict warnings
  • CI status with links; running checks are polled every 15 s, settled ones cached
  • Multi-repo: the current repo plus any listed in PR_DASH_REPOS
  • GitHub quota aware: GraphQL batching, REST fallbacks, and a cooldown after a rate-limit response
  • Incremental search, vim-style key bindings

Environment variables:

Variable Default Description
PR_DASH_REPOS (empty) Comma-separated extra repos, each owner/name or owner/name=/path/to/checkout
PR_DASH_BOTS (empty) Comma-separated extra bot logins to hide (any *[bot], *-bot, *-ci login is already a bot)
PR_DASH_DEBUG 0 Verbose logging
PR_DASH_CMD_TIMEOUT 30 Per-command timeout (seconds)
PR_DASH_BATCH_SIZE 15 Branches per GraphQL batch
PR_DASH_PARALLEL 4 Parallel batch workers
PR_DASH_RATE_LIMIT_COOLDOWN 900 Seconds without GitHub calls after a rate-limit response

Requires: Python 3, Flask, gh (GitHub CLI), git

freespace.sh

macOS disk space cleanup. Safe mode by default, deep clean with -f.

./freespace.sh        # safe mode: build caches, app caches, system temp, git gc, secondary-worktree Bazel bases
./freespace.sh -f     # deep clean: + Docker, iOS/Android simulators, toolchains, node_modules, virtualenvs
./freespace.sh -n     # dry run: preview everything without deleting (-nf for a deep-clean preview)

Safe mode cleans build caches (.swc, .next, .turbo, __pycache__, …) in every primary checkout and linked worktree, non-symlinked node_modules in secondary worktrees, Electron/browser/app caches, stale /tmp and ~/Library/Caches files, Bazel output bases of linked worktrees and of interrupted expunges, and runs git gc. Deep clean adds Docker/Colima, unused iOS runtimes and Android emulators, mise/rustup toolchains, and the main-checkout node_modules.

Environment variables:

Variable Default Description
FREESPACE_MAIN_WORKSPACE auto (git toplevel) Repo root whose Bazel output base and node_modules are preserved
FREESPACE_WORKTREE_PARENT ~/workspace Where linked worktrees live
BAZEL_ROOT /private/var/tmp/_bazel_$USER Legacy Bazel output root
PROJECT_CACHE_DIRS (empty) Space-separated dirs relative to each checkout to delete (e.g. a local search index)
LOG_TRUNCATE_DIRS (empty) Space-separated dirs whose *.log files over the threshold are truncated in place
LOG_TRUNCATE_THRESHOLD_KB 102400 Truncation threshold (100 MB)

sparse-branch.sh

Create sparse-checkout worktrees for fast, small branch checkouts. Several names are created in parallel after one shared fetch.

./sparse-branch.sh my-feature                # sparse worktree at ../my-feature
./sparse-branch.sh feat-a feat-b feat-c      # several, in parallel
./sparse-branch.sh --full my-feature         # full checkout
./sparse-branch.sh --min my-feature          # minimal: root files + support dirs
./sparse-branch.sh --min existing-branch     # branch-scoped: only the dirs the branch changes vs base
./sparse-branch.sh --base origin/release my-fix
./sparse-branch.sh --prefix team/ my-feature # branch team/my-feature
./sparse-branch.sh --update my-feature       # refresh symlinks in an existing worktree

Derives the branch prefix from your git username (Jane Doe → jd/my-feature) unless --prefix is given or the name already contains /. The base defaults to origin/HEAD, then main/master. node_modules is symlinked from the main worktree when present.

Environment variables:

Variable Default Description
SPARSE_PATTERNS_FILE everything except node_modules/.git Sparse-checkout patterns for --sparse mode
SPARSE_SUPPORT_DIRS .github Dirs always included in --min and branch-scoped checkouts (agent rules, hook helpers)
SPARSE_EXTRA_PATHS (empty) Paths added after a --sparse checkout (lint configs your hooks need)
SPARSE_SYMLINK_DIRS (empty) Paths to symlink from the main worktree (virtualenvs, build caches)

Branch-scoped --min requires git config extensions.worktreeConfig true.

extract.sh

Extract commits or files to a new branch and create a PR.

./extract.sh my-feature                           # HEAD → draft PR
./extract.sh my-feature "PR title"                # HEAD with custom title
./extract.sh my-feature "" HEAD~3..HEAD           # last 3 commits
./extract.sh my-feature "" abc1234 def5678        # specific commits
./extract.sh my-fix "fix bug" path/to/file.ts     # file copy mode
./extract.sh --min trivial-fix                    # skip pre-commit (fast)

Creates a sparse worktree via sparse-branch.sh, cherry-picks commits (or copies files), runs pre-commit, pushes, and opens a draft PR via make-pr.sh. Idempotent — can be re-run safely. The first commit's body is inserted into the PR description under PR_BODY_MARKER (default **Description**:). BRANCH_PREFIX overrides the initials-derived prefix.

make-pr.sh

Create or update a draft PR from the current branch.

./make-pr.sh "[search] Add conversation loader"

If a PR already exists for the branch, updates the title. Otherwise creates a new draft PR using your project's PR template.