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 skill for importing activities to Google Calendar.

Troubleshooting