TeamHero — developer contribution reports for GitHub organizations
npx claudepluginhub asabaylus/teamhero.cliGenerate developer contribution reports for GitHub organizations — PRs, commits, LOC, Asana tasks, AI-powered visible wins.
asabaylusStop spending Friday night writing status reports.
TeamHero connects to your GitHub, Asana, and meeting transcripts, reconciles the data, flags discrepancies, and writes a defensible engineering report in about 5 minutes for ~$0.02.
$ teamhero report
Fetching GitHub activity for 12 contributors...
Reading Asana sprint board...
Reconciling data sources...
⚠ Discrepancy: PR #847 merged Wed — ticket TKT-291 still "In Progress"
Generating report... done in 4m 38s
✓ Report saved: teamhero-report-my-org-2026-03-14.md
The output is a Markdown report with delivery summaries, per-engineer breakdowns, AI-generated highlights, lines-of-code stats, and a discrepancy log that catches conflicts between your data sources before your boss does.
Integrates with: GitHub, Asana, Google Meet transcripts | Coming soon: Jira, Linear
brew install asabaylus/teamhero/teamhero
curl -fsSL https://apt.teamhero.dev/teamhero.gpg | sudo gpg --dearmor -o /usr/share/keyrings/teamhero.gpg
echo "deb [signed-by=/usr/share/keyrings/teamhero.gpg] https://apt.teamhero.dev stable main" \
| sudo tee /etc/apt/sources.list.d/teamhero.list
sudo apt-get update && sudo apt-get install teamhero
curl -fsSL https://github.com/asabaylus/teamhero.cli/releases/latest/download/install.sh | bash
Downloads the latest release to ~/.local/bin. Pass --version v1.2.3 for a specific version or --install-dir /usr/local/bin to change the install location.
Supported platforms: macOS (Intel + Apple Silicon), Linux (x86_64 + ARM64). Windows is supported under WSL.
teamhero setup # Guided credential wizard
teamhero doctor # Verify everything is working
You'll need:
teamhero setupteamhero report
The interactive TUI walks you through selecting an org, repos, team members, date range, and report sections. When it finishes, it writes a Markdown file to the current directory.
Once you've run interactively, your settings are saved. Future reports can be headless:
teamhero report --headless --no-confirm
Or override specific options:
teamhero report --headless --since 2026-03-01 --until 2026-03-14 --sections loc,individual
Run teamhero report --help for all flags.
Install TeamHero using any method above, then ask Claude to configure it:
You: Install and configure TeamHero for my GitHub org "my-org"
Claude will run teamhero setup to walk through credential configuration, then teamhero doctor to verify. You'll be prompted to paste each credential as Claude drives the setup wizard.
Once configured, ask Claude to generate reports:
You: Generate a TeamHero report for the last two weeks
Credentials are stored at ~/.config/teamhero/.env. Report settings are saved to ~/.config/teamhero/config.json after each interactive run and automatically reused in headless mode.
See Configuration Reference for all options, including cross-system user mapping (GitHub/Asana) and AI model configuration.
Enable OpenAI's flex tier for cheaper (but slower) report generation:
teamhero setup # Select "OpenAI Service Tier" → flex
Or set OPENAI_SERVICE_TIER=flex in ~/.config/teamhero/.env.
Requires Go 1.24+, Bun v1.0+, Node.js 20+, and just.
just install # Installs deps, builds CLI + TUI, links binary
just # List all available recipes
| Recipe | Description |
|---|---|
just build-all | Build everything (TypeScript + Go) |
just test-all | Run all tests (TypeScript + Go) |
just lint | Format and lint (Biome) |
just report | Run a report |
just reset | Clean all build artifacts |
Official prompts.chat marketplace - AI prompts, skills, and tools for Claude Code
Open Design — local-first design app exposed to coding agents over MCP. Install once with your agent's plugin command and projects/files/skills are reachable through stdio.
Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations