Fuzit

AI-powered Git command helper for people who can't memorize git syntax. Describe what you want to do in plain English — Fuzit figures out the commands.

Demo

$ fuzit

> push my changes to a new branch called feature/login

🔍 Proposed commands:
  1. git checkout -b feature/login
  2. git push -u origin feature/login

💬 Creates and switches to a new branch, then pushes it to origin.

  ❯ Run commands
    Edit a command
    Cancel

Install

Stable (when available):

npm install -g @uziraze/fuzit

Beta (current release):

npm install -g @uziraze/fuzit@beta

Requires Node.js 18+.

Setup

On first run, Fuzit will ask for a Groq API key. Groq is free to use.

1. Get your key at console.groq.com
2. Run fuzit and paste it in when prompted — it's saved locally and never asked again

Usage

Interactive mode

fuzit

Type your request in plain English, review the proposed commands, then choose to run, edit, or cancel.

Quick mode

fuzit -n <your request>

Skips the review step and executes immediately. Useful for scripting or when you're confident.

fuzit -n stage all changes and commit with message "fix: button alignment"

Command history

fuzit --history

Browse previously executed commands. Select any entry to load its commands back into the review screen, where you can run or edit them again.

Model picker

fuzit --model

Switch the AI model used to generate commands. Fuzit supports the following Groq models:

| Model | Description | |---|---| | llama-3.3-70b-versatile | Balanced performance and speed (default) | | openai/gpt-oss-20b | OpenAI open-source 20B model | | openai/gpt-oss-120b | OpenAI open-source 120B model, most capable | | llama-3.1-8b-instant | Fastest responses, smallest model |

The selected model is saved and used for all future requests until changed. You can change these models via src/config/models.ts

Features

• Natural language to git commands via Groq AI
• Shows proposed commands with an explanation before running anything
• Edit any command before execution
• Reads your current git context (branch, status, recent commits, remotes) for accurate suggestions
• Command history — re-run past commands without retyping
• Switchable AI models — choose between speed and capability
• Cross-platform (Windows, macOS, Linux)

How It Works

1. You describe what you want in plain English
2. Fuzit sends your request + current git context to the AI
3. The AI returns the exact commands to run
4. You review, optionally edit, then confirm
5. Fuzit executes them and shows the output

Requirements

• Node.js 18+
• A git repository (must be run inside one)
• A free Groq API key

License

MIT