This tool uses FastMCP and the Google Gemini API to provide an AI-powered git assistant. It can function as an agent to execute a series of git commands based on natural language, or it can be used to simply generate a commit message for your staged changes.
-
Set Your API Key: This tool requires a Gemini API key. The first time you run it, it will prompt you to enter your key and offer to save it to
~/.config/git-flash/.env. Alternatively, you can set it as an environment variable:export GEMINI_API_KEY="your-gemini-api-key"
-
Install the Package: Navigate to the
git-flashdirectory and install it usingpip. Using the-eflag (editable mode) is recommended for development.pip install git-flash
This command installs the
git-flashcommand into your system's PATH.
You can run the assistant from within any git repository directory.
Provide an instruction in plain English, and the agent will determine the necessary git commands and execute them one by one.
Examples:
# Create a new branch and switch to it
git flash "create a new feature branch called 'login-flow' and check it out"
# Stash changes, switch branches, and pop the stash
git flash "stash my current work, switch to the 'main' branch, and then apply my stash"
# List all branches, local and remote
git flash "show me all the branches"
# File and directory creation/deletion
git flash "create a file named 'docs/plan.md' and write a to-do list for the new feature"
# File and directory manipulation
git flash "reorganize files as production"If you know what you want to commit, use the -m or --message option. This will stage all current changes and commit with your message.
git flash -m "feat: add user authentication endpoint"For any of the modes, you can add the --dry-run flag to see what commands the agent would run without actually executing them. This is great for safety and testing.
git flash "create a hotfix branch and merge it into main" --dry-run