{"id":28251783,"url":"https://github.com/doganarif/giq","last_synced_at":"2025-06-14T07:30:45.938Z","repository":{"id":276145540,"uuid":"928354981","full_name":"doganarif/giq","owner":"doganarif","description":"Git CLI with AI-powered commit messages and insights. Drop-in replacement for git with the same commands.","archived":false,"fork":false,"pushed_at":"2025-03-19T01:40:36.000Z","size":774,"stargazers_count":13,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-09T07:58:09.238Z","etag":null,"topics":["ai","git","llm"],"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/doganarif.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2025-02-06T13:56:50.000Z","updated_at":"2025-05-16T07:55:23.000Z","dependencies_parsed_at":"2025-02-06T15:39:37.714Z","dependency_job_id":null,"html_url":"https://github.com/doganarif/giq","commit_stats":null,"previous_names":["doganarif/giq"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/doganarif/giq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doganarif%2Fgiq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doganarif%2Fgiq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doganarif%2Fgiq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doganarif%2Fgiq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/doganarif","download_url":"https://codeload.github.com/doganarif/giq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doganarif%2Fgiq/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259776688,"owners_count":22909513,"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":["ai","git","llm"],"created_at":"2025-05-19T15:15:32.123Z","updated_at":"2025-06-14T07:30:45.933Z","avatar_url":"https://github.com/doganarif.png","language":"Go","funding_links":[],"categories":["\u003ca name=\"git\"\u003e\u003c/a\u003eGit and accessories"],"sub_categories":[],"readme":"\u003ca href=\"https://syntaks.ai\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/syntaks.ai-AI%20MVPs%20in%204%20Weeks-f39c12?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTEyIDJsMyAxMC0xMCA5eiIgZmlsbD0iIzAwZmY5ZCIvPjwvc3ZnPg==\" alt=\"syntaks.ai - AI MVPs in 4 Weeks\"\u003e\u003c/a\u003e\n\n# giq (Git Intelligence Quickstart)\n\ngiq is a Git wrapper that enhances your Git workflow with AI-powered features. It provides intelligent commit message suggestions and status insights while maintaining full compatibility with standard Git commands.\n\n![demo](https://raw.githubusercontent.com/doganarif/giq/main/demo/demo.gif)\n\n## Features\n\n- **AI-Powered Commit Messages**: Automatically generates contextual commit messages based on your staged changes\n- **Intelligent Status Insights**: Provides AI-enhanced analysis of your working tree status\n- **Multi-Provider Support**: Works with both OpenAI and Azure OpenAI\n- **Git Command Passthrough**: Seamlessly delegates unknown commands to your system's Git\n- **Interactive Setup**: User-friendly configuration wizard\n\n## Installation\n\n### Using Homebrew (Recommended)\n\ngiq is available via Homebrew for macOS (both Apple Silicon and Intel) and Linux:\n\n```bash\n# Add the tap\nbrew tap doganarif/giq\n\n# Install giq\nbrew install giq\n```\n\nTo upgrade to the latest version:\n```bash\nbrew upgrade giq\n```\n\nTo uninstall:\n```bash\nbrew uninstall giq\n```\n\n### Manual Installation\n\n#### Prerequisites\n\n- Go 1.19 or later\n- Git installed and available in your PATH\n- OpenAI API key or Azure OpenAI credentials\n\n#### Building from Source\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/doganarif/giq.git\ncd giq\n```\n\n2. Build the binary:\n```bash\ngo build\n```\n\n3. Move the binary to a location in your PATH:\n```bash\n# Linux/macOS\nsudo mv giq /usr/local/bin/\n\n# Windows\n# Move giq.exe to a location in your PATH\n```\n\n### Installing Pre-built Binaries\n\nPre-built binaries for various platforms are available on the [releases page](https://github.com/doganarif/giq/releases).\n\nSupported platforms:\n- macOS (Apple Silicon/ARM64)\n- macOS (Intel/AMD64)\n- Linux (x86_64)\n- Linux (ARM64)\n\n## Configuration\n\nRun the interactive setup wizard:\n\n```bash\ngiq setup\n```\n\nThis will guide you through:\n1. Selecting your AI provider (OpenAI or Azure OpenAI)\n2. Entering your API credentials\n3. Saving the configuration\n\nConfiguration is stored in `~/.config/giq/config.yaml` (or equivalent on Windows).\n\n### Manual Configuration\n\nYou can also create the configuration file manually:\n\nFor OpenAI:\n```yaml\nai_provider: openai\nai_key: your-openai-api-key\n```\n\nFor Azure OpenAI:\n```yaml\nai_provider: azure_openai\nazure_endpoint: https://your-resource.openai.azure.com/\nazure_deployment_id: your-deployment-id\nazure_api_key: your-azure-api-key\nazure_api_version: 2022-12-01\n```\n\n## Usage\n\n### Committing Changes\n\n```bash\n# Stage your changes as usual\ngit add .\n\n# Generate AI-powered commit message\ngiq commit\n\n# Or provide your own message\ngiq commit -m \"your message\"\n```\n\nWhen using `giq commit` without a message:\n1. View staged files\n2. Choose from AI-generated commit message suggestions\n3. Or enter a custom message\n\n### Checking Status\n\n```bash\ngiq status\n```\n\nShows:\n- Standard Git status output\n- AI-generated insights about your changes\n\n### Other Git Commands\n\ngiq passes through any unrecognized commands to Git:\n\n```bash\n# These work exactly like standard git commands\ngiq push\ngiq pull\ngiq branch\n# etc.\n```\n\n## Environment Variables\n\nYou can configure giq using environment variables:\n\n- `GIQ_AI_PROVIDER`: AI provider (`openai` or `azure_openai`)\n- `GIQ_AI_KEY`: OpenAI API key\n- `GIQ_AZURE_ENDPOINT`: Azure OpenAI endpoint\n- `GIQ_AZURE_DEPLOYMENT_ID`: Azure OpenAI deployment ID\n- `GIQ_AZURE_API_KEY`: Azure OpenAI API key\n- `GIQ_AZURE_API_VERSION`: Azure OpenAI API version\n\nEnvironment variables take precedence over configuration file settings.\n\n## Project Structure\n\n```\ngiq/\n├── internal/\n│   ├── ai/      # AI service integration\n│   ├── app/     # Core application logic\n│   ├── cmd/     # Command implementations\n│   └── config/  # Configuration management\n└── main.go      # Application entry point\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\n- [go-git](https://github.com/go-git/go-git) for Git operations\n- [cobra](https://github.com/spf13/cobra) for CLI interface\n- [bubbletea](https://github.com/charmbracelet/bubbletea) for terminal UI\n- [go-openai](https://github.com/sashabaranov/go-openai) for OpenAI integration\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoganarif%2Fgiq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoganarif%2Fgiq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoganarif%2Fgiq/lists"}