The Problem: The "Maintenance Tax"
We’ve all been there: you finish a great piece of code, but then comes the "boring" part. You need to write a descriptive README, tag the repository with the right topics so people can actually find it, draft issues for future features, and write semantic commit messages.
Initially, I handled this with a scattered collection of PowerShell scripts (AI-Gen-Profile, Ai-Pro-Arch, etc.). It worked, but it was messy.
The Solution: Git-Alchemist ⚗️
I decided to transmute those "lead" scripts into "gold." Git-Alchemist is a unified AI stack powered by Gemma 3 and Gemini 3 that handles the entire lifecycle of a GitHub repository from a single CLI.
Key "Transmutations"
The Forge: It doesn't just commit; it analyzes your local diffs, creates a new branch, writes a technical PR description, and opens the Pull Request on GitHub for you.
The Architect (Scaffold): Need a FastAPI backend with a Docker setup? The scaffold command generates the structure in a safe, temporary workspace first so you can inspect it before it touches your disk.
The Sage & Smart Chunking: I implemented a Parallel Map-Reduce engine. If your codebase is huge, the tool automatically splits it into chunks, processes them in parallel, and synthesizes an answer. No more "Context Window exceeded" errors.
Gold Score Audit: It gives your repo a "Transmutation Score" (0-100%) based on community standards like Licenses, CI/CD workflows, and metadata.
The Tech Stack
Language: Python 3.10+
AI Models: Gemma 3 (for fast, local-style reasoning) and Gemini 3 Flash (for deep architectural analysis).
UI: Built with rich for beautiful terminal output and progress bars.
Integration: Deeply integrated with the gh (GitHub CLI) for seamless authentication.
Check it out!
I’ve open-sourced the project and would love to hear what the community thinks—especially regarding the Architect and Sage modules.
GitHub: abduznik/Git-Alchemist
Project Site: Official Documentation
What parts of your Git workflow do you find the most tedious? Let's automate them!
Top comments (0)