{"id":28861926,"url":"https://github.com/shubhpreet-rana/codegenius","last_synced_at":"2026-04-27T18:32:06.091Z","repository":{"id":299696208,"uuid":"965284125","full_name":"Shubhpreet-Rana/codegenius","owner":"Shubhpreet-Rana","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-18T20:14:06.000Z","size":146800,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"latest","last_synced_at":"2025-06-20T06:07:59.413Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shubhpreet-Rana.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-04-12T20:18:32.000Z","updated_at":"2025-06-18T20:14:09.000Z","dependencies_parsed_at":"2025-06-17T21:46:31.457Z","dependency_job_id":null,"html_url":"https://github.com/Shubhpreet-Rana/codegenius","commit_stats":null,"previous_names":["shubhpreet-rana/codegenius"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Shubhpreet-Rana/codegenius","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shubhpreet-Rana%2Fcodegenius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shubhpreet-Rana%2Fcodegenius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shubhpreet-Rana%2Fcodegenius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shubhpreet-Rana%2Fcodegenius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shubhpreet-Rana","download_url":"https://codeload.github.com/Shubhpreet-Rana/codegenius/tar.gz/refs/heads/latest","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shubhpreet-Rana%2Fcodegenius/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260891177,"owners_count":23077914,"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","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":[],"created_at":"2025-06-20T06:07:58.271Z","updated_at":"2025-11-03T17:39:29.389Z","avatar_url":"https://github.com/Shubhpreet-Rana.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CodeGenius CLI 🤖✨\n\nAn intelligent Git commit message generator and code reviewer powered by AI with a **beautiful terminal user interface**. Use CodeGenius anywhere on your system - just like Firebase CLI!\n\n## 🌟 Features\n\n- **🎨 Beautiful Terminal UI**: Modern, interactive interface with multi-select, input fields, and elegant styling\n- **🤖 AI-Powered Commit Messages**: Generate conventional, meaningful commit messages using Google's Gemini AI\n- **🔍 Interactive Code Reviews**: Multi-select review types with additional context input (security, performance, style, structure)\n- **📊 Work History Tracking**: Visual progress tracking with statistics and filtering\n- **💬 Context-Aware**: Add custom context to both commits and reviews for better AI analysis\n- **⚙️ Fully Configurable**: Customizable templates, review settings, and project configuration\n- **🌍 Global CLI Tool**: Install once, use anywhere on your system\n\n## 🚀 **Installation Status - All Methods Working!**\n\n| Method | Status | Version | One-Line Install |\n|--------|--------|---------|------------------|\n| **🍺 Homebrew** | ✅ **Working** | v1.1.2 | `brew tap Shubhpreet-Rana/codegenius \u0026\u0026 brew install codegenius` |\n| **📦 NPM** | ✅ **Working** | v1.1.4 | `npm install -g codegenius-cli` |\n| **🌐 Curl** | ✅ **Working** | v1.1.2 | `curl -fsSL https://raw.githubusercontent.com/Shubhpreet-Rana/codegenius/latest/install.sh \\| bash` |\n| **🔧 Go** | ✅ **Working** | Latest | `go install github.com/Shubhpreet-Rana/codegenius@latest` |\n\n**Choose your preferred method and get started in seconds! 🚀**\n\n## 🚀 Installation Methods\n\nChoose your preferred installation method:\n\n### 🍺 Homebrew (macOS/Linux) - ✅ Available Now!\n```bash\n# Add the tap\nbrew tap Shubhpreet-Rana/codegenius\n\n# Install CodeGenius\nbrew install codegenius\n```\n**✅ Clean installation, automatic updates, easy uninstall**\n\n### 📦 NPM (Node.js) - ✅ Published!\n```bash\nnpm install -g codegenius-cli\n```\n**✅ Easy updates, clean uninstall, works everywhere Node.js does**\n\n### 🌐 One-Line Install (Alternative)\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Shubhpreet-Rana/codegenius/latest/install.sh | bash\n```\n**✅ Automatic platform detection, PATH setup, instant global access**\n\n### 🔧 Go Install (Developers)\n```bash\ngo install github.com/Shubhpreet-Rana/codegenius@latest\n```\n**✅ Build from source, latest features, automatic updates**\n\n### 💾 Manual Download\nDownload the latest release for your platform:\n- [macOS Intel](https://github.com/Shubhpreet-Rana/codegenius/releases/latest/download/codegenius-darwin-amd64)\n- [macOS Apple Silicon](https://github.com/Shubhpreet-Rana/codegenius/releases/latest/download/codegenius-darwin-arm64)  \n- [Linux x86_64](https://github.com/Shubhpreet-Rana/codegenius/releases/latest/download/codegenius-linux-amd64)\n- [Linux ARM64](https://github.com/Shubhpreet-Rana/codegenius/releases/latest/download/codegenius-linux-arm64)\n- [Windows x64](https://github.com/Shubhpreet-Rana/codegenius/releases/latest/download/codegenius-windows-amd64.exe)\n\nThen install:\n```bash\n# macOS/Linux\nchmod +x codegenius-*\nsudo mv codegenius-* /usr/local/bin/codegenius\n\n# Windows: Move .exe to a folder in your PATH\n```\n\n### 📋 Platform Support\n| Platform | Homebrew | NPM | Curl | Go | Manual |\n|----------|----------|-----|------|----|--------|\n| **macOS Intel** | ✅ | ✅ | ✅ | ✅ | ✅ |\n| **macOS ARM64** | ✅ | ✅ | ✅ | ✅ | ✅ |\n| **Linux x64** | ✅ | ✅ | ✅ | ✅ | ✅ |\n| **Linux ARM64** | ✅ | ✅ | ✅ | ✅ | ✅ |\n| **Windows** | ❌ | ✅ | ✅ | ✅ | ✅ |\n\n**💡 Recommended: Use Homebrew on macOS/Linux or NPM for cross-platform**\n\n## ⚡ Quick Start\n\n### 1. Setup (One-time)\n```bash\n# Get your API key from: https://makersuite.google.com/app/apikey\nexport GEMINI_API_KEY=\"your-gemini-api-key\"\n\n# Add to your shell profile\necho 'export GEMINI_API_KEY=\"your-gemini-api-key\"' \u003e\u003e ~/.zshrc\n```\n\n### 2. Use in Any Git Repository\n```bash\n# Navigate to any Git project\ncd your-project\n\n# Initialize CodeGenius (creates .codegenius.yaml)\ncodegenius --init\n\n# Stage your changes\ngit add .\n\n# Use the beautiful TUI\ncodegenius --tui\n\n# Or traditional CLI\ncodegenius          # Generate commit message\ncodegenius --review # Perform code review\n```\n\n## 🎯 Global Usage Examples\n\n### Smart Commit Generation\n```bash\n# In any Git repository\ncd ~/my-awesome-project\ngit add .\ncodegenius --tui\n```\n\n### Code Review Anywhere\n```bash\n# Review staged changes in any project\ncd ~/work/client-app\ngit add src/\ncodegenius --review\n```\n\n### Project History\n```bash\n# View your work history\ncodegenius --history \"Dec 2024\"\n```\n\n### Global Configuration\n```bash\n# Your preferences follow you everywhere\ncodegenius --init  # Creates .codegenius.yaml in current directory\n```\n\n## 🎯 Usage\n\n### Basic Commands (Work Anywhere!)\n\n```bash\n# Generate commit message for staged changes\ncodegenius\n\n# Perform code review\ncodegenius --review\n\n# View work history\ncodegenius --history \"Dec 2024\"\n\n# Interactive mode\ncodegenius --interactive\n\n# Beautiful TUI mode (recommended)\ncodegenius --tui\n\n# Initialize configuration\ncodegenius --init\n\n# Show help\ncodegenius --help\n```\n\n### TUI Mode (Recommended)\n```bash\n# Launch beautiful terminal interface\ncodegenius --tui\n```\n\nThe TUI provides:\n- **🤖 Smart Commit Generation** with context input\n- **🔍 Interactive Code Review** with multi-select options\n- **📊 Visual History \u0026 Statistics**\n- **⚙️ Configuration Management**\n\n## 🌍 How It Works Globally\n\nCodeGenius is designed to work seamlessly across your entire system:\n\n1. **Install Once**: Single installation works everywhere\n2. **Per-Project Configuration**: Each project can have its own `.codegenius.yaml`\n3. **Global Settings**: Your API key and preferences travel with you\n4. **Context Aware**: Automatically detects project language and Git status\n5. **Cross-Platform**: Works on macOS, Linux, and Windows\n\n## 📁 Project Structure\n\n```\nCLI_GO/\n├── main.go                  # Global CLI entry point\n├── internal/\n│   ├── tui/                 # Beautiful terminal UI\n│   ├── interfaces/          # Clean architecture\n│   ├── container/           # Dependency injection\n│   ├── ai/                  # AI integration\n│   ├── config/              # Configuration management\n│   ├── git/                 # Git operations\n│   ├── history/             # Work history tracking\n│   └── review/              # Code review functionality\n├── .codegenius.yaml         # Project-specific configuration\n├── install.sh              # Global installation script\n├── go.mod                   # Go module definition\n└── README.md               # This file\n```\n\n## ⚙️ Configuration\n\nCodeGenius works with both global and project-specific configurations:\n\n### Global Configuration\nYour API key and global preferences:\n```bash\nexport GEMINI_API_KEY=\"your-api-key\"\n```\n\n### Project Configuration (`.codegenius.yaml`)\nEach project can have its own settings:\n```yaml\nproject:\n  name: \"Your Project\"\n  language: \"go\"\n  overview: \"Project description\"\n  scopes:\n    - core\n    - api\n    - docs\n  standards: \"https://golang.org/doc/effective_go.html\"\n\nai:\n  model: \"gemini-2.0-flash\"\n  max_tokens: 4000\n  context_templates:\n    default: \"Standard commit message generation\"\n    bugfix: \"Focus on bug fixes and impact\"\n    feature: \"Emphasize new functionality\"\n\nreview:\n  enabled_types:\n    - security\n    - performance\n    - style\n    - structure\n  text_only: true  # No code snippets in reviews\n  security_patterns:\n    - '(?i)(password|secret|key|token)\\s*[:=]\\s*[\"'\"'\"'][^\"'\"'\"']+[\"'\"'\"']'\n```\n\n## 🛠️ Development \u0026 Contributing\n\n### For Contributors\n```bash\n# Clone and setup\ngit clone https://github.com/Shubhpreet-Rana/codegenius.git\ncd CLI_GO\nmake dev-setup\n\n# Build locally\nmake build\n\n# Test globally\nsudo cp bin/codegenius /usr/local/bin/\ncodegenius --help\n```\n\n### Building Releases\n```bash\n# Build for multiple platforms\nmake build-all\n\n# Create release\nmake release\n```\n\n## 🌟 Use Cases\n\n### Individual Developers\n```bash\n# Work on multiple projects seamlessly\ncd ~/project1 \u0026\u0026 codegenius --tui\ncd ~/project2 \u0026\u0026 codegenius --review\ncd ~/project3 \u0026\u0026 codegenius --history\n```\n\n### Teams\n```bash\n# Consistent commit messages across team\ncodegenius --init  # Share .codegenius.yaml with team\ngit add .codegenius.yaml \u0026\u0026 git commit -m \"Add CodeGenius config\"\n```\n\n### CI/CD Integration\n```bash\n# Use in build scripts\ncodegenius --review \u003e review-report.txt\n```\n\n## 📦 Distribution\n\nCodeGenius is distributed through multiple channels:\n\n- **Homebrew**: `brew tap Shubhpreet-Rana/codegenius \u0026\u0026 brew install codegenius` (v1.1.2)\n- **NPM**: `npm install -g codegenius-cli` (v1.1.4)\n- **GitHub Releases**: Pre-built binaries for all platforms (v1.1.2)\n- **Go Modules**: `go install github.com/Shubhpreet-Rana/codegenius@latest`\n- **Curl Installer**: One-line installation script (v1.1.2)\n\n## 🔧 API Integration\n\nOther applications can integrate CodeGenius:\n\n```go\nimport \"github.com/Shubhpreet-Rana/codegenius/internal/interfaces\"\n\n// Use as a library\nservice := buildCodeGeniusService()\nmessage, err := service.AI.GenerateCommitMessage(diff, files, branch, context)\n```\n\n## 💻 System Requirements\n\n- **OS**: macOS, Linux, Windows\n- **Git**: Any version (for Git operations)\n- **Internet**: For AI features (Gemini API)\n- **Go**: Optional (only for `go install` method)\n\n## 🚀 Performance\n\n- **Fast**: Typically generates commits in 2-3 seconds\n- **Lightweight**: ~10MB binary, minimal memory usage\n- **Offline**: Some features work without internet\n- **Concurrent**: Multiple operations can run simultaneously\n\n## 🔒 Privacy \u0026 Security\n\n- **No Code Storage**: Your code never leaves your machine (except for AI analysis)\n- **Secure API**: Uses HTTPS for all AI communications\n- **Local History**: Work history stored locally\n- **Configurable**: Control what data is sent to AI\n\n## 🎉 What's New in v1.1.4\n\n- **✅ NPM Package Fixed**: All installation issues resolved in `codegenius-cli@1.1.4`\n- **✅ Homebrew Support**: Official Homebrew tap available and working\n- **🔐 Verified Binaries**: All releases signed and verified with real SHA256 hashes\n- **🛠️ Enhanced Installation**: Multiple working installation methods\n- **📦 GitHub Releases**: Pre-built binaries for all platforms (v1.1.2)\n- **🔄 Automatic Updates**: Easy updates via package managers\n\n## 📄 License\n\n[MIT License](LICENSE)\n\n## 🙏 Acknowledgments\n\n- Google Gemini AI for intelligent code analysis\n- The Charm team for amazing TUI libraries\n- The Go community for excellent tooling\n- Contributors and users of CodeGenius\n\n---\n\n**Ready to revolutionize your Git workflow? Install CodeGenius and use it anywhere! 🚀✨**\n\n## 💡 Pro Tips\n\n```bash\n# Create aliases for faster access\necho 'alias cg=\"codegenius --tui\"' \u003e\u003e ~/.zshrc\necho 'alias cgr=\"codegenius --review\"' \u003e\u003e ~/.zshrc\n\n# Quick commit workflow\ngit add . \u0026\u0026 cg\n\n# Quick review workflow\ngit add . \u0026\u0026 cgr\n```\n\n**Experience the future of Git workflow with CodeGenius CLI - your global AI-powered Git assistant! 🤖⚡** ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshubhpreet-rana%2Fcodegenius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshubhpreet-rana%2Fcodegenius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshubhpreet-rana%2Fcodegenius/lists"}