{"id":51040072,"url":"https://github.com/zillowe/gct","last_synced_at":"2026-07-10T12:01:01.923Z","repository":{"id":311402550,"uuid":"1043235937","full_name":"Zillowe/GCT","owner":"Zillowe","description":"Smart, interactive Git tool powered by AI, GitLab mirror","archived":false,"fork":false,"pushed_at":"2025-09-01T16:31:19.000Z","size":230,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-01T18:09:11.647Z","etag":null,"topics":["ai","cli","git","go"],"latest_commit_sha":null,"homepage":"https://gitlab.com/Zillowe/Zillwen/Zusty/GCT","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zillowe.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-23T12:26:36.000Z","updated_at":"2025-09-01T16:31:22.000Z","dependencies_parsed_at":"2025-08-24T14:26:47.213Z","dependency_job_id":"b53eb2a6-3fb7-45fe-b7c8-61628361f508","html_url":"https://github.com/Zillowe/GCT","commit_stats":null,"previous_names":["zillowe/gct"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Zillowe/GCT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zillowe%2FGCT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zillowe%2FGCT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zillowe%2FGCT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zillowe%2FGCT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zillowe","download_url":"https://codeload.github.com/Zillowe/GCT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zillowe%2FGCT/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35330738,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"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":["ai","cli","git","go"],"created_at":"2026-06-22T10:00:29.151Z","updated_at":"2026-07-10T12:01:01.917Z","avatar_url":"https://github.com/Zillowe.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n    \u003cimg width=\"120\" height=\"120\" hspace=\"10\" alt=\"ZDS Logo\" src=\"https://gitlab.com/Zillowe/Zillwen/Zusty/ZDS/-/raw/main/img/zds.png\"/\u003e\r\n    \u003ch1\u003eGCT\u003c/h1\u003e\r\n    \u003cstrong\u003eAn intelligent, AI-powered Git assistant.\u003c/strong\u003e\r\n    \u003cbr/\u003e\r\n    \u003cp\u003eGo beyond simple commits. Let GCT explain, create, and conversationally refine your code changes with the power of AI.\u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ca href=\"https://github.com/Zillowe/Zillwen/Zusty/Zoidberg\"\u003e\r\n    \u003cimg alt=\"Get it on Zoidberg\" src=\"https://gitlab.com/Zillowe/Zillwen/Zusty/Zoi/-/raw/main/app/images/get-it-on-zoidberg-small.svg\"/\u003e\r\n  \u003c/a\u003e\r\n\r\n\u003c/div\u003e\r\n\r\n\u003chr/\u003e\r\n\u003cbr/\u003e\r\n\r\n## ✨ Features\r\n\r\n- **Conversational AI Commits:** Generate a commit message and then \"chat\" with the AI to refine it until it's perfect.\r\n- **Smart Atomic Commits:** Automatically breaks large changes into logical, atomic commits with context awareness.\r\n- **Interactive Review:** Review and edit AI-proposed commit groups in a scrollable TUI before execution.\r\n- **Multi-Provider Support:** Works with over 10 AI providers, including OpenAI, Anthropic, Google, Mistral, Amazon Bedrock, and any OpenAI-compatible endpoint.\r\n- **Real-time Streaming:** AI responses are streamed to your terminal in real-time for faster feedback.\r\n- **AI-Powered Diff Analysis:** Get a high-level explanation of any commit, branch, or staged changes (`gct ai diff`).\r\n- **AI-Generated Changelogs:** Automatically create user-facing changelogs from any set of git changes (`gct ai log`).\r\n- **Guided Setup:** An interactive wizard (`gct init`) makes setup for any provider simple and fast.\r\n- **Custom Guidelines:** Enforce project-specific styles for commits and changelogs by providing your own guide files.\r\n\r\n## 🚀 Getting Started\r\n\r\nThe easiest way to get started is with the **model preset wizard**. It provides a curated list of popular, high-performance models and configures the provider for you. In your project directory, run:\r\n\r\n```sh\r\ngct init model\r\n```\r\n\r\nFor a fully manual setup where you enter the provider and model name yourself, run `gct init`.\r\n\r\n## ⚙️ Configuration\r\n\r\nGCT is highly flexible. You can configure it using a local `gct.yaml` file, a global config file (e.g. `~/.config/gct/config.yaml`), or with environment variables. This allows you to set project-specific guidelines while keeping your API keys global or managed by your shell.\r\n\r\nFor a detailed guide on the configuration hierarchy and all available options, please see the [Configuration Reference](https://zillowe.qzz.io/docs/zds/gct/project-config).\r\n\r\n**Security Note:** When using file-based configuration, your API key is stored in plain text. The `gct init` command will automatically add `gct.yaml` to your `.gitignore` file to prevent accidentally committing secrets.\r\n\r\n### Supported Providers\r\n\r\nGCT supports a wide range of providers:\r\n`Google AI Studio`, `Google Vertex AI`, `OpenAI`, `OpenAI Compatible`, `Azure OpenAI`, `Anthropic`, `OpenRouter`, `DeepSeek`, `Mistral`, `Alibaba`, `Hugging Face`, `Amazon Bedrock`, and `xAI`.\r\n\r\n### Configuration Fields\r\n\r\n- `provider`: The AI service you want to use.\r\n- `model`: The specific model/deployment name from your chosen provider.\r\n- `api`: Your secret API key.\r\n- `commits.guides` \u0026 `changelogs.guides`: Lists of local files containing formatting rules.\r\n- `endpoint`: (Optional) The base URL, only for the `\"OpenAI Compatible\"` provider.\r\n- `gcp_project_id`, `gcp_region`: (Optional) Required only for `\"Google Vertex AI\"`.\r\n- `aws_region`, `aws_access_key_id`, `aws_secret_access_key`: (Optional) Required only for `\"Amazon Bedrock\"`.\r\n- `azure_resource_name`: (Optional) Required only for `\"Azure OpenAI\"`.\r\n- `cache.enabled`: (Optional) To store generated responses locally and reduce costs.\r\n\r\n## 🤖 Model Recommendations\r\n\r\nChoosing a model can be tough. Here are some recommended starting points for GCT's use case:\r\n\r\n| Recommendation           | Model ID                               | Best For...                                           |\r\n| :----------------------- | :------------------------------------- | :---------------------------------------------------- |\r\n| **Best Overall**         | `gpt-5.4-mini` (OpenAI)                | Top-tier reasoning, speed, and instruction following. |\r\n| **Best Balance**         | `claude-sonnet-4-6` (Anthropic)        | Excellent performance at a great price point.         |\r\n| **Fastest \u0026 Best Value** | `gemini-3-flash-preview` (Google)      | High-speed, low-cost tasks like `ai log` \u0026 chat.      |\r\n| **Best Open Model**      | `openai/gpt-oss-120b` (via OpenRouter) | State-of-the-art open-source performance.             |\r\n\r\n## ✨ Commands\r\n\r\nGCT is a command-line tool. Here are the available commands, grouped by category:\r\n\r\n### Core Commands\r\n\r\n| Command          | Description                                                       |\r\n| :--------------- | :---------------------------------------------------------------- |\r\n| `gct init model` | Starts a wizard with recommended models for easy setup.           |\r\n| `gct init`       | Interactively creates a `gct.yaml` config file with manual input. |\r\n| `gct version`    | Shows GCT version information.                                    |\r\n| `gct help`       | Shows the detailed help message.                                  |\r\n\r\n### Manual Git Commands\r\n\r\n| Command           | Description                                             |\r\n| :---------------- | :------------------------------------------------------ |\r\n| `gct commit`      | Creates a new git commit using an interactive TUI form. |\r\n| `gct commit edit` | Edits the previous commit's message using the same TUI. |\r\n\r\n### AI Git Commands\r\n\r\n| Command                   | Description                                                                  |\r\n| :------------------------ | :--------------------------------------------------------------------------- |\r\n| `gct ai commit [context]` | Generates and conversationally refines a commit message from staged changes. |\r\n| `gct ai diff [args]`      | Asks AI to explain a set of code changes in a readable format.               |\r\n| `gct ai log [args]`       | Generates a user-facing changelog entry from code changes.                   |\r\n\r\n## 💾 Installation\r\n\r\nYou can install GCT via [Zoi](https://zillowe.qzz.io/zds/zoi):\r\n\r\n```sh\r\nzoi install @zillowe/gct\r\n```\r\n\r\nOr build GCT from source. To do so, you need to have [`go`](https://go.dev) installed.\r\n\r\n```sh\r\n# For Linux/macOS\r\n./build/build-release.sh\r\n\r\n# For Windows\r\n./build/build-release.ps1\r\n```\r\n\r\n## 📚 Documentation\r\n\r\nFor more detailed guides, please refer to the **[GCT Docs](https://zillowe.qzz.io/docs/zds/gct)**.\r\n\r\n\u003chr/\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cp\u003eGCT is developed by Zusty \u003c Zillowe Foundation\u003cbr/\u003ePart of the \u003ca href=\"https://zillowe.qzz.io/docs/zds\"\u003eZillowe Development Suite (ZDS)\u003c/a\u003e\u003c/p\u003e\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzillowe%2Fgct","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzillowe%2Fgct","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzillowe%2Fgct/lists"}