{"id":28938659,"url":"https://github.com/dbtreasure/pull-request-report","last_synced_at":"2026-02-17T03:05:54.754Z","repository":{"id":299296631,"uuid":"1002569667","full_name":"dbtreasure/pull-request-report","owner":"dbtreasure","description":"A CLI tool that uses Claude Code to review your pull requests and build a report of where you excel, and where you need more work.","archived":false,"fork":false,"pushed_at":"2025-06-16T03:50:43.000Z","size":73,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-12T23:25:46.314Z","etag":null,"topics":["claude-code","github-cli"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dbtreasure.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-15T18:40:01.000Z","updated_at":"2025-06-17T15:17:21.000Z","dependencies_parsed_at":"2025-06-18T03:00:38.271Z","dependency_job_id":null,"html_url":"https://github.com/dbtreasure/pull-request-report","commit_stats":null,"previous_names":["dbtreasure/pull-request-report"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dbtreasure/pull-request-report","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbtreasure%2Fpull-request-report","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbtreasure%2Fpull-request-report/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbtreasure%2Fpull-request-report/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbtreasure%2Fpull-request-report/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dbtreasure","download_url":"https://codeload.github.com/dbtreasure/pull-request-report/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbtreasure%2Fpull-request-report/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006350,"owners_count":26084086,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","github-cli"],"created_at":"2025-06-22T23:08:32.486Z","updated_at":"2025-10-11T05:39:14.702Z","avatar_url":"https://github.com/dbtreasure.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pull Request Report\n\nAn AI-powered tool for analyzing code review feedback patterns to help developers improve their code quality.\n\n## 🚀 Quick Start (1 minute)\n\n### Prerequisites\n- **[uvx](https://github.com/astral-sh/uv)** - Python package runner (for easy execution)\n- **GitHub CLI** - `brew install gh` (macOS) or [see installation](https://github.com/cli/cli#installation)\n\n### One-Command Setup\n```bash\n# 1. Clone and run setup\ngit clone https://github.com/dbtreasure/pull-request-report \u0026\u0026 cd pull-request-report\n./scripts/setup.sh\n```\n\nThat's it! The setup script will check prerequisites and guide you through configuration. 🎉\n\n## 🔧 Alternative: Using Claude Code\n\nIf you prefer AI-guided setup with Claude Code:\n\n### Installing Claude Code\n```bash\n# 1. Install Claude Code (requires Node.js 18+)\nnpm install -g @anthropic-ai/claude-code\n\n# 2. Navigate to your project directory\ncd pull-request-report\n\n# 3. Start Claude Code\nclaude\n\n# 4. Tell Claude: \"Set me up\"\n```\n\n**System Requirements:**\n- macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows via WSL\n- Node.js 18+ \n- 4GB RAM minimum\n- Claude Pro/Max plan or Anthropic Console access\n\n**📖 Full Installation Guide:** [docs.anthropic.com/claude-code/getting-started](https://docs.anthropic.com/en/docs/claude-code/getting-started)\n\n## 📖 Detailed Setup\n\nFor manual setup or troubleshooting, see [SETUP.md](SETUP.md).\n\n## 🎯 What This Does\n\nThis tool analyzes your pull request comments to help you:\n- **Identify patterns** in code review feedback\n- **Track improvement** over time\n- **Focus learning** on specific areas (async, API design, testing, etc.)\n- **Level up** your code quality\n\n## 💬 How to Use\n\n### Option 1: Convenience Scripts\n```bash\n# Analyze your PRs\n./scripts/analyze.sh\n\n# Convert reports to PDF\n./scripts/convert.sh\n\n# Run tests\n./scripts/test.sh\n```\n\n### Option 2: Direct uvx Commands\n```bash\n# Setup and configuration\nuvx --from . pr-report setup\n\n# Analyze PRs (10 by default)\nuvx --from . pr-report analyze --repo owner/repo --count 20\n\n# Convert markdown to styled PDF\nuvx --from . pr-report convert --pdf\n\n# Run comprehensive tests\nuvx --from . --with pytest python test/run_tests.py\n```\n\n### Option 3: Using Claude Code\nTell Claude any of these:\n- **\"Analyze my recent PRs\"** - Run analysis on all configured repos\n- **\"Show me my improvement areas\"** - See feedback patterns\n- **\"Add another repository\"** - Expand your analysis\n- **\"Convert reports to PDF\"** - Generate professional PDFs\n\n## 📊 Example Output\n\nClaude creates detailed reports showing:\n```\nreports/\n└── my-api-project/\n    └── pull-requests/\n        ├── PR-123-add-auth.md      # What reviewers said\n        ├── PR-125-refactor-db.md   # How to improve\n        └── summary.md              # Your patterns\n```\n\n## 🔒 Privacy\n\n- All reports stay local (gitignored)\n- Your code never leaves your machine\n- Each developer gets their own private analysis\n\n## What Gets Analyzed\n\nFor each pull request, the tool examines:\n- Review comments and suggestions\n- Requested code changes\n- Approval status and conditions\n- Common themes across reviews\n\nThe analysis produces:\n- Detailed breakdowns of each PR's feedback\n- Key takeaways for improvement\n- Actionable steps to avoid similar issues\n- Progress tracking over time\n\n## Privacy\n\n- All analysis reports are stored locally in the `reports/` directory\n- The `reports/` directory is gitignored by default\n- Your code and review comments never leave your machine\n- Only you can see your analysis results\n\n## Example Output\n\nAfter analysis, you'll find reports like:\n\n```\nreports/\n└── my-api-project/\n    ├── intro.md\n    └── pull-requests/\n        ├── PR-123-add-user-auth.md\n        ├── PR-125-refactor-database.md\n        └── summary.md\n```\n\nEach report includes:\n- PR overview and purpose\n- Detailed review feedback\n- Specific improvement recommendations\n- Patterns to watch for in future PRs\n\n## Contributing\n\nFeel free to submit issues or PRs to improve this tool!\n\n## 📄 License\n\nThis project is licensed under the MIT License - see below for details.\n\n### MIT License\n\n```\nMIT License\n\nCopyright (c) 2025 Pull Request Report Contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n### Usage and Attribution\n\nThis software is free to use, modify, and distribute. When using or modifying this tool:\n\n- ✅ **Use for any purpose** (personal, commercial, educational)\n- ✅ **Modify and distribute** freely\n- ✅ **No attribution required** (but appreciated!)\n- ✅ **Include in larger projects** without restriction\n\n**Optional Attribution:** If you find this tool helpful, consider linking back to the original repository or mentioning it in your project documentation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbtreasure%2Fpull-request-report","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdbtreasure%2Fpull-request-report","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbtreasure%2Fpull-request-report/lists"}