This is a submission for the Amazon Q Developer "Quack The Code" Challenge: Crushing the Command Line

What I Built

gitpush is an AI-powered command-line tool that translates natural language into Git commands and executes them in your terminal. It's built to simplify version control for developers of all levels.

🚀 Features

  • 🤖 Convert natural language like "push my changes" to real Git commands.
  • 🔄 Cross-platform support (Windows, macOS, Linux).
  • ⚙️ Executes Git commands safely using Python's subprocess.
  • 📦 Easy to install via PyPI: pip install gitpush-cli.

🧠 Powered By

  • Groq API for fast and accurate command generation.
  • Amazon Q Developer CLI was used to scaffold and debug the project.
  • Python 3.8+

Additionally, I’ve created a Python package for gitpush, which is now available on PyPI. You can easily install it with the command pip install git-push-cli to start using the tool and enhance your workflow right away.

git-push-cli · PyPI

A natural-language Git CLI.

favicon pypi.org

Demo


Here’s how a typical session would look:

  1. Install GitPush: pip install git-push-cli

  2. Run GitPush CLI: gitpush

  3. Enter your Groq API key: gsk_**********************************

  4. Generate and let the agent execute Git command by entering a prompt: initialize git

  5. Exit the tool: exit

Code Repository

GitHub logo abdullah-k18 / git-push-cli

GitPush CLI Tool

GitPush is a command-line tool that allows you to execute Git commands by providing natural language prompts. Using the Groq API, it generates and runs Git commands for you.

Features

  • Convert natural language commands into Git commands
  • Supports Git operations like git init, git commit, git push, etc.
  • Easy to use: simply enter a prompt and the tool executes the corresponding Git command

Installation

  1. Install GitPush using pip:

    To install GitPush, simply run the following command:

    pip install git-push-cli
    Enter fullscreen mode Exit fullscreen mode

  2. Verify the installation:

After installing, verify that GitPush is installed correctly by running:

gitpush
Enter fullscreen mode Exit fullscreen mode

This should open the GitPush CLI interface.

Setting up the Groq API Key

  1. Enter your Groq API key

The first time you run GitPush, it will ask you to enter your Groq API key. This key is required to generate Git commands from natural language prompts.

When prompted, enter your Groq…

View on GitHub

How I Used Amazon Q Developer

I used Amazon Q Developer to bring my tool to life in a way that made the entire development process much smoother. While the tool I created is responsible for executing Git commands, Amazon Q Developer played a key role in helping me get there. I used the Amazon Q Developer CLI extension within my IDE, which helped me automate various parts of the workflow, generate code, and even resolve some complex tasks with ease.

The best part was how Amazon Q Developer made it easy to convert natural language instructions into actual code. This saved me a ton of time and allowed me to focus on refining the tool's features. Thanks to its capabilities, I was able to streamline the process and achieve the end result more efficiently than I originally imagined.