{"id":30116380,"url":"https://github.com/banghuazhao/go_git_local_status","last_synced_at":"2026-04-20T03:32:26.478Z","repository":{"id":308655990,"uuid":"1033595826","full_name":"banghuazhao/go_git_local_status","owner":"banghuazhao","description":"🚀 A powerful Go CLI tool that generates GitHub-style contribution graphs from your local Git repositories. Track your coding activity across multiple projects with beautiful terminal visualizations. Perfect for developers who want insights into their local development patterns.","archived":false,"fork":false,"pushed_at":"2025-08-07T04:28:32.000Z","size":69,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-07T06:22:11.169Z","etag":null,"topics":["cli","coding-activity","command-line","contribution-graph","developer-tools","development-tracking","git","git-analysis","git-history","git-stats","go","go-cli","golang","local-repositories","productivity","repository-analysis","terminal","terminal-app","visualization"],"latest_commit_sha":null,"homepage":"","language":"Go","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/banghuazhao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-08-07T04:15:12.000Z","updated_at":"2025-08-07T05:19:40.000Z","dependencies_parsed_at":"2025-08-07T06:22:14.579Z","dependency_job_id":"5a780ab5-364d-4179-bac4-421f98ac7de6","html_url":"https://github.com/banghuazhao/go_git_local_status","commit_stats":null,"previous_names":["banghuazhao/go_git_local_status"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/banghuazhao/go_git_local_status","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/banghuazhao%2Fgo_git_local_status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/banghuazhao%2Fgo_git_local_status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/banghuazhao%2Fgo_git_local_status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/banghuazhao%2Fgo_git_local_status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/banghuazhao","download_url":"https://codeload.github.com/banghuazhao/go_git_local_status/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/banghuazhao%2Fgo_git_local_status/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32031562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"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":["cli","coding-activity","command-line","contribution-graph","developer-tools","development-tracking","git","git-analysis","git-history","git-stats","go","go-cli","golang","local-repositories","productivity","repository-analysis","terminal","terminal-app","visualization"],"created_at":"2025-08-10T09:36:19.232Z","updated_at":"2026-04-20T03:32:26.462Z","avatar_url":"https://github.com/banghuazhao.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Go Git Local Status\n\n\u003e **Note**: This project is based on the tutorial [\"Visualize your local Git contributions with Go\"](https://flaviocopes.com/go-git-contributions/) by Flavio Copes. The original tutorial provides a comprehensive guide on building a Git stats analysis CLI tool using Go.\n\n[![Go Version](https://img.shields.io/badge/Go-1.24.5+-blue.svg)](https://golang.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/banghuazhao/go_git_local_status?style=social)](https://github.com/banghuazhao/go_git_local_status)\n[![GitHub Followers](https://img.shields.io/github/followers/banghuazhao?style=social)](https://github.com/banghuazhao)\n\nA powerful Go application that analyzes your local Git repositories and generates a beautiful GitHub-style contribution graph showing your coding activity over the last 6 months. Perfect for developers who want to track their local development activity across multiple repositories!\n\n## ✨ Features\n\n- 🔍 **Smart Repository Discovery** - Recursively scans directories for Git repositories\n- 📊 **GitHub-Style Visualization** - Beautiful contribution graph with colored cells\n- 📅 **6-Month Activity Overview** - Complete view of your coding patterns\n- 🎨 **Intelligent Color Coding** - White, yellow, green based on activity levels\n- ⚡ **Lightning Fast** - Processes hundreds of repositories efficiently\n- 🛡️ **Robust Error Handling** - Gracefully handles problematic repositories\n- 🎯 **Email Filtering** - Focus on your specific contributions\n- 📱 **Cross-Platform** - Works on macOS, Linux, and Windows\n\n## 🎯 Why Use This Tool?\n\n- **Track Your Progress** - See your coding activity patterns over time\n- **Local Development Focus** - Analyze repositories not on GitHub\n- **Multiple Repository Support** - Get insights across all your projects\n- **Beautiful Output** - GitHub-style graphs in your terminal\n- **Privacy First** - All analysis happens locally on your machine\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Go 1.24.5 or higher\n- Git repositories on your local machine\n\n### Installation\n\n1. **Clone the repository:**\n```bash\ngit clone https://github.com/banghuazhao/go_git_local_status.git\ncd go_git_local_status\n```\n\n2. **Install dependencies:**\n```bash\ngo mod tidy\n```\n\n3. **Run the tool:**\n```bash\ngo run . -folder \"/path/to/your/projects\" -email \"your.email@example.com\"\n```\n\n## 📊 Example Output\n\n![Git Local Status Example](screenshots/example.png)\n\n*Example output showing a GitHub-style contribution graph generated from local Git repositories*\n\n## 🎨 Color Legend\n\n- `-` : No commits (gray)\n- `1-4` : Light activity (white background)\n- `5-9` : Medium activity (yellow background)\n- `10+` : High activity (green background)\n\n## ⚙️ Command Line Options\n\n- `-folder string`: Directory to scan for Git repositories\n- `-email string`: Email address to filter commits (default: \"your@email.com\")\n\n## 🔧 How It Works\n\n1. **Repository Discovery**: Recursively scans the specified directory for `.git` folders\n2. **Commit Analysis**: For each repository, reads the Git history and filters commits by email\n3. **Date Calculation**: Calculates days since each commit and applies offset for proper graph alignment\n4. **Graph Generation**: Creates a GitHub-style contribution graph with color-coded cells\n5. **Output Display**: Shows the graph with month labels and day-of-week alignment\n\n## 📁 Project Structure\n\n```\ngo_git_local_status/\n├── main.go          # Main entry point and flag parsing\n├── scan.go          # Repository discovery and Git folder scanning\n├── stats.go         # Commit analysis and graph generation\n├── screenshots/     # Example outputs and documentation\n├── go.mod           # Go module dependencies\n├── go.sum           # Dependency checksums\n└── README.md        # This file\n```\n\n## 🛠️ Dependencies\n\n- [go-git/go-git/v5](https://github.com/go-git/go-git) - Git repository operations\n- Standard Go libraries (flag, fmt, log, os, strings, time)\n\n## 🛡️ Error Handling\n\nThe application gracefully handles:\n- Empty Git repositories\n- Repositories without HEAD references\n- Corrupted Git repositories\n- Permission errors\n- Invalid repository paths\n\n## ⚡ Performance\n\n- Processes multiple repositories efficiently\n- Skips problematic repositories without stopping\n- Memory-efficient commit iteration\n- Fast directory scanning\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help:\n\n1. ⭐ **Star this repository** if you find it useful\n2. 🐛 **Report bugs** by opening an issue\n3. 💡 **Suggest features** through issues\n4. 🔧 **Submit pull requests** for improvements\n5. 📖 **Improve documentation**\n\n### Development Setup\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Make your changes\n4. Add tests if applicable\n5. Commit your changes: `git commit -m 'Add amazing feature'`\n6. Push to the branch: `git push origin feature/amazing-feature`\n7. Open a Pull Request\n\n## 📄 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n## 👨‍💻 Author\n\n**Created by [@banghuazhao](https://github.com/banghuazhao)**\n\n- 🔗 **GitHub**: [@banghuazhao](https://github.com/banghuazhao)\n- 🚀 **More Projects**: Check out my other repositories for more amazing tools!\n\n## ⭐ Show Your Support\n\nIf this project helps you track your development activity, please consider:\n\n- ⭐ **Starring this repository**\n- 👥 **Following me on GitHub**\n- 🐛 **Reporting bugs or suggesting features**\n- 💬 **Sharing with your developer friends**\n\n---\n\n**💡 Pro Tip**: This tool is perfect for developers who work across multiple local repositories and want to visualize their coding patterns, similar to GitHub's contribution graph but for your local development environment.\n\n**🎯 Perfect For**: Software engineers, developers, and anyone who wants to track their local Git activity patterns!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbanghuazhao%2Fgo_git_local_status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbanghuazhao%2Fgo_git_local_status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbanghuazhao%2Fgo_git_local_status/lists"}