BashBuddy

Inspiration

On the opening day of the hackathon, our team saw stickers being handed out that were cheat sheets for common git commands. We realized that many new developers get turned away from using the terminal, and the biggest roadblock is not knowing what commands to use. Our goal is to make the terminal accessible to everyone by teaching people how to use commands.

What it does

BashBuddy is an intelligent terminal helper that transforms plain English into shell commands. Users can type bb or bashbuddy followed by a natural question like: “How do I create a new folder?” and BashBuddy instantly returns: mkdir new_folder

It can also explain what each command does, so you can actually learn, not just copy and paste. All interactions are securely stored in Supabase, and our web dashboard visualizes them as flashcards that recap everything the user has asked. Users can filter, sort, and quiz themselves on these flashcards to reinforce learning, transforming terminal use into an interactive study experience.

How we built it

Frontend: React + TypeScript + Tailwind for a clean, responsive UI that displays flashcards and quizzes. Backend: Flask requests from both the terminal CLI and web dashboard. Database: Supabase stores user queries, responses, and quiz data in real-time. Generative AI: Used Gemini to generate the quizzes. AI Assists: Took help from Copilot to build this project.

Accomplishments we are proud of

Building a seamless ecosystem: a CLI + website that communicate in real time through Supabase.
Creating a tool that’s educational, not just functional, something that teaches you the “why” behind every command.
Designing a beautiful flashcard and quiz interface that turns learning into a habit.
Making command-line learning accessible for beginners who usually find it intimidating.