Generate a TL;DR summary of your GitHub activity
npm install gh-tldr
AI-powered TL;DR of your GitHub activity
Stop manually tracking what you did this week. gh-tldr fetches your GitHub activity and uses Claude AI to generate a human-readable summary—perfect for standups, status updates, or weekly reports.

``bash`
npx gh-tldr
That's it. Follow the prompts.
- 📊 Summarizes PRs, reviews, commits, and issues
- 📈 Tracks lines of code changed (additions/deletions)
- 🤖 Powered by Claude AI for natural language summaries
- 🎯 Custom prompt support for focused summaries
- 🔄 Interactive or scripted mode
- 📝 Multiple output formats (plain text, markdown, slack)
- 🔒 Private repository support
- 🏢 Organization/scope filtering
- 🌍 English and German output
- Node.js >= 18
- GitHub CLI (gh) - authenticatedclaude
- Claude Code ()
macOS quick setup
`bash`
brew install gh node
gh auth login
The easiest way is npx gh-tldr (no install needed).
Alternative: Install globally
`bash`
git clone https://github.com/yungweng/gh-tldr.git
cd gh-tldr
pnpm install
pnpm build
pnpm link --global
Note for Aikido Safe-Chain users
If you use Aikido Safe-Chain, you may need to bypass it:
`bashBash/Zsh
\npx gh-tldr
Or add an alias:
`bash
~/.bashrc or ~/.zshrc
alias gh-tldr='\npx gh-tldr'~/.config/fish/config.fish
alias gh-tldr='command npx gh-tldr'
`Usage
$3
`bash
gh-tldr
``
? GitHub username (leave empty for authenticated user)
? Time period › Last 24 hours / Last 7 days / Last 30 days
? Language › English / German
? Summary verbosity › Brief / Normal / Detailed
? Output format › Plain text / Markdown / Slack
? Include private repos? (y/N)
? Filter by scope › All / org-name / username
? Claude model (leave empty for default)
? Any specific focus for the summary? (optional)
`$3
`bash
gh-tldr [username] [options]
`| Option | Description |
|--------|-------------|
|
-d, --days | Time period in days (default: 1) |
| -e, --english | Output in English (default: German) |
| -f, --format | Output: plain \| markdown \| slack |
| -v, --verbosity | Summary length: brief \| normal \| detailed |
| -p, --public-only | Exclude private repositories |
| -o, --orgs | Filter by organizations/accounts (comma-separated) |
| -m, --model | Claude model (e.g., haiku, sonnet, opus) |
| -P, --prompt | Custom instructions for Claude |
| -i, --interactive | Force interactive mode |
| -h, --help | Show help |$3
`bash
Last 7 days in English
gh-tldr --days 7 --englishSpecific user, public repos only
gh-tldr yungweng --public-onlyFilter by organization
gh-tldr --orgs my-company,my-orgCustom focus for standup
gh-tldr -P "Focus on bug fixes and blockers"Brief summary with Haiku model
gh-tldr --verbosity brief --model haikuMarkdown output for documentation
gh-tldr --days 30 --format markdown
`Example Output
`
tl;dr 28.12.2025• 3 PRs created (repo-a, repo-b)
• 5 PRs reviewed (repo-c)
• 2 PRs merged (repo-a)
• 1 issue closed (repo-d)
• 12 commits (repo-a, repo-b)
• +1,234 / -567 lines changed (15 files)
Repos: org/repo-a, org/repo-b, org/repo-c, org/repo-d
---
Mainly worked on Feature X. Completed and merged PR "Add user authentication".
Did several code reviews for the team, including the new API endpoint.
`Development
`bash
pnpm dev # Run in dev mode
pnpm build # Build
pnpm typecheck # Type check
``Issues and PRs welcome! See open issues.
- Repository
- Issues
- npm
Maintained by @yungweng
MIT