{"id":51094818,"url":"https://github.com/gleanwork/dev-tools","last_synced_at":"2026-06-24T05:30:58.082Z","repository":{"id":350135796,"uuid":"1205457590","full_name":"gleanwork/dev-tools","owner":"gleanwork","description":"Developer productivity tools: AI coding agent commands for PR workflows, a PR dashboard, and shell scripts for worktree management and disk cleanup.","archived":false,"fork":false,"pushed_at":"2026-05-30T22:30:17.000Z","size":112,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T00:14:23.636Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gleanwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-09T01:32:57.000Z","updated_at":"2026-05-30T22:30:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gleanwork/dev-tools","commit_stats":null,"previous_names":["gleanwork/dev-tools"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gleanwork/dev-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gleanwork%2Fdev-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gleanwork%2Fdev-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gleanwork%2Fdev-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gleanwork%2Fdev-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gleanwork","download_url":"https://codeload.github.com/gleanwork/dev-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gleanwork%2Fdev-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34719086,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-24T02:00:07.484Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-24T05:30:56.412Z","updated_at":"2026-06-24T05:30:58.070Z","avatar_url":"https://github.com/gleanwork.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dev-tools\n\nDeveloper productivity tools for AI-assisted workflows: agent commands for PR lifecycle management, a PR dashboard, and shell scripts for worktree management and disk cleanup.\n\n## What's here\n\n### [`commands/`](commands/)\n\nMarkdown instructions that AI coding agents (Cursor, Claude Code) execute as slash commands. Drop them into your project's `.cursor/commands/`, `.codeagent/commands/`, or equivalent.\n\n| Command | What it does |\n|---------|-------------|\n| [`/pr create`](commands/pr-create.md) | Cherry-pick commits into a clean PR branch, auto-name, resolve reviewers by first name, run pre-commit |\n| [`/pr review`](commands/pr-review.md) | Walk through a PR file-by-file (ordered for understanding), post inline comments with approval gate |\n| [`/pr fix`](commands/pr-fix.md) | Find CI failures, diagnose, fix, push, test locally in parallel, iterate until green |\n| [`/pr comments`](commands/pr-comments.md) | Go through reviewer comments one-by-one, propose fixes, wait for approval before applying and replying |\n| [`/pr skeleton`](commands/pr-skeleton.md) | Extract a ~10% architectural skeleton of large PRs for reviewers |\n| [`/git mergetool`](commands/git-mergetool.md) | Resolve merge conflicts by analyzing who changed what from base, using timeline-based reasoning |\n\n### [`scripts/`](scripts/)\n\nStandalone tools you run directly.\n\n| Script | What it does |\n|--------|-------------|\n| [`pr-dash.py`](scripts/pr-dash.py) | Local PR dashboard and inbox — tracks PRs, reviews owed, worktree status, CI state. Flask app with vim keys. |\n| [`freespace.sh`](scripts/freespace.sh) | macOS disk space cleanup — build caches, app/Electron/browser caches, stale bazel output bases, Colima VM disk, system temp, git gc. Safe mode + deep clean (`-f`) + `--stale-days N`. |\n| [`sparse-branch.sh`](scripts/sparse-branch.sh) | Create sparse-checkout worktrees. Three modes: `--sparse`, `--min`, `--full`. Accepts multiple names (created in parallel) and `--base`. |\n| [`extract.sh`](scripts/extract.sh) | Extract commits or files to a new branch and create a PR in one shot. |\n| [`make-pr.sh`](scripts/make-pr.sh) | Create or update a draft PR from the current branch. |\n\n### [`distill/`](distill/)\n\nA small system that watches your coding sessions and suggests when to capture a reusable doc for your AI — a command + an always-on rule + a `stop` hook. Suggest-only.\n\n| Piece | What it does |\n|-------|-------------|\n| [`commands/distill.md`](distill/commands/distill.md) | The writer: a doc-type catalog (system, pr-plan, revert-list, trace-diff, followups, …) + templates |\n| [`rules/distillation.md`](distill/rules/distillation.md) | Always-on: watches the session and suggests `/distill \u003ctype\u003e` at the right moment |\n| [`hooks/distill-detect.sh`](distill/hooks/distill-detect.sh) | Deterministic backstop: nudges toward a pr-plan when a branch drifts too far ahead of base |\n\n## Quick start\n\n### Commands (for Cursor / Claude Code)\n\n```bash\n# Copy to your project\ncp commands/*.md your-project/.cursor/commands/\n# or\ncp commands/*.md your-project/.codeagent/commands/\n\n# Then in your AI agent:\n# /pr create\n# /pr review 12345\n# /pr fix\n```\n\n### PR Dashboard\n\n```bash\npip install flask\npython scripts/pr-dash.py\n# Open http://127.0.0.1:8765\n```\n\n### Scripts\n\n```bash\n# Add to PATH or run directly\nscripts/freespace.sh             # clean disk (dry run: -n, deep clean: -f)\nscripts/freespace.sh --stale-days 0   # also drop every non-main bazel output base\nscripts/sparse-branch.sh my-feature   # create sparse worktree\nscripts/sparse-branch.sh feat-a feat-b feat-c   # create several in parallel\nscripts/extract.sh my-fix \"Fix the bug\" HEAD   # extract commit to PR\n```\n\n## Dependencies\n\n- **Commands**: Any AI coding agent that supports markdown command files (Cursor, Claude Code)\n- **pr-dash.py**: Python 3, Flask, `gh` (GitHub CLI), `git`\n- **Shell scripts**: `gh`, `git`, `pre-commit` (for extract.sh)\n\n## Customization\n\n### freespace.sh\n\nSet `MAIN_WORKSPACE` to your repo root (defaults to `git rev-parse --show-toplevel`). The script has clearly marked sections for project-specific paths — search for \"Add project-specific\" comments.\n\n- `BAZEL_ROOT` — bazel output-base root (defaults to `/private/var/tmp/_bazel_$USER`)\n- `--stale-days N` — drop non-main bazel output bases untouched for N+ days (default 3); `--stale-days 0` drops every non-main base (emergency mode, keeps the shared disk cache)\n- `LOG_TRUNCATE_DIRS` — space-separated dirs whose `*.log` files over `LOG_TRUNCATE_THRESHOLD_KB` (default 100 MB) get truncated in place\n\n### sparse-branch.sh\n\n- `SPARSE_PATTERNS_FILE` — path to a custom sparse-checkout patterns file\n- `SPARSE_EXTRA_PATHS` — space-separated paths your pre-commit hooks need\n- `SPARSE_SYMLINK_DIRS` — directories to symlink from the main worktree (e.g., virtualenvs, build caches)\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgleanwork%2Fdev-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgleanwork%2Fdev-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgleanwork%2Fdev-tools/lists"}