mirror-mirror

Scan your GitHub contributions and generate AI-summarized weekly work reports — ready to paste into Gmail. Optionally get roasted by Elon.

Tracks commits, pull requests, code reviews, and issues — then uses OpenAI to distill them into a two-section status update (Last Week / This Week).

Setup

uv sync

Create a .env file in the project root:

GITHUB_TOKEN=ghp_...
OPENAI_API_KEY=sk-...

• GitHub token — create at github.com/settings/tokens with repo and read:user scopes.
• OpenAI API key — get one at platform.openai.com/api-keys.

Usage

# Generate an AI-summarized report (last 7 days)
uv run mirror

# Copy to clipboard as rich HTML — paste straight into Gmail
uv run mirror --copy

# Filter to a specific GitHub org
uv run mirror --org CareEvolution

# Specify a different user or time range
uv run mirror --user octocat --days 14

# Use a different OpenAI model
uv run mirror --model gpt-4o

# Skip AI summary, output raw data only
uv run mirror --raw

# Save as HTML (opens in browser, or attach to email)
uv run mirror -o weekly-report.html

# Save to a specific markdown file
uv run mirror -o weekly-report.md

# Get roasted by Elon Musk
uv run mirror --roast

Options

Flag	Description	Default
--token	GitHub PAT (or set GITHUB_TOKEN / GH_TOKEN)	—
--user	GitHub username	token owner
--days	Number of days to look back	7
--org	Filter to a specific GitHub organization	all orgs
--model	OpenAI model for summarization	gpt-5-mini
--raw	Skip AI summary, output raw data	off
--copy	Copy report as rich HTML to clipboard (for Gmail)	off
--roast	Append an Elon Musk-style progress review	off
-o, --output	Output file path (.md or .html)	report-<user>-<date>.md

The report is printed to the terminal and saved to a file. Use --copy to paste directly into Gmail with formatting and links preserved.