github-activity

# 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

```bash
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:

```bash
# 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](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](references/output-format.md)

## Usage Examples

| Request | Action |
|---------|--------|
| "GitHub activity yesterday" | Yesterday's report |
| "2025-11-01 to today" | Date range report |
| "Last week's commits" | Last 7 days |
| "delightroom org activity" | Organization filter |

## Integration

JSON output compatible with `google-calendar-sync` skill for importing activities to Google Calendar.