GitHub Activity Reporter

Collect GitHub activity (PRs, Issues, Commits) via GitHub CLI and generate time-organized markdown reports.

Prerequisites

• GitHub CLI (

  gh

  ) authenticated with

  repo

  and

  read:org

  scopes
• Verify:

  gh auth status

Workflow

1. Get User Info

gh api user --jq '.login'

If authentication fails:

gh auth login

2. Calculate Date Range

• Explicit: "2025-11-05" -> use directly
• Relative: "yesterday" ->

  date -v-1d '+%Y-%m-%d'

  (macOS)
• Default: yesterday

Format:

${start_date}..${end_date}

3. Collect Activity Data

Execute in parallel:

# PRs
gh search prs --involves=@me --updated="${date_range}" \
  --json number,title,repository,state,url,createdAt,closedAt,author

# Issues
gh search issues --involves=@me --updated="${date_range}" \
  --json number,title,repository,state,url,createdAt,author

# Commits (public repos only)
gh search commits --author=@me --committer-date="${date_range}" \
  --json commit,repository,sha,url

# Private commits: extract from each PR
gh pr view NUMBER --repo OWNER/REPO --json commits,additions,deletions,changedFiles

For complete CLI reference: references/cli-reference.md

4. Process Data

• Convert UTC to local timezone
• Group by hour and repository
• Deduplicate commits by SHA

5. Generate Reports

Output location:

~/.claude/tmp/github-activity/reports/

Files:

• YYYY-MM-DD.md

  - Human-readable markdown

• YYYY-MM-DD.json

  - Machine-readable (for calendar-sync)

For format specification: references/output-format.md

Usage Examples

Integration

JSON output compatible with

google-calendar-sync

Troubleshooting

gh auth login

export TZ=Asia/Seoul