gh-standup
Generate a standup summary from GitHub activity since the last standup day.
Quick Start
# Single repo, weekly Friday standup
python3 scripts/standup.py --repo ORG/REPO --standup-days Friday
# Multiple standup days
python3 scripts/standup.py --repo ORG/REPO --standup-days Monday,Thursday
# Whole org, specific author
python3 scripts/standup.py --org MY_ORG --standup-days Friday --author username
Parameters
| Flag | Required | Default | Description |
|---|---|---|---|
--repo | one of | — | Single repo (org/repo) |
--org | one of | — | Entire GitHub org (all repos) |
--standup-days | no | Friday | Comma-separated weekdays |
--author | no | @me | GitHub username or @me |
Workflow
- Run
scripts/standup.pywith the user's repo/org and standup days - The script calculates the most recent past standup day and uses it as
since - Output: merged PRs + direct commits (PR commits de-duped) since that date
- Post the output as the standup message
Requirements
ghCLI authenticated (gh auth status)- Python 3.10+
Notes
--orgfetches all repos in the org; can be slow for large orgs — prefer--repowhen possible- PRs are matched by merge date; commits by author date
- Commits that belong to a merged PR are excluded from "Direct Commits" to avoid duplication