Git commits are easy.
Good commits are not.
Most of us have pushed code that worked locally but later caused bugs, confusion, or regret. Sometimes the change was risky. Sometimes the commit message was unclear. Sometimes we just moved too fast.
That’s why I built Copilot Commit Crystalball 🔮.
What is Copilot Commit Crystalball?
Copilot Commit Crystalball is a CLI tool that reviews your staged Git changes and predicts what might go wrong before you commit.
It acts like a pause button for your Git workflow.
Before you run git commit, Crystalball:
- Reviews the files you staged
- Uses GitHub Copilot CLI for analysis
- Warns you about risks, bugs, and unclear code
Why this exists
Many developers commit without fully understanding:
- What exactly changed
- Whether the change is risky
- If the code is incomplete or broken
- If documentation or context is missing
Crystalball helps you reflect before committing, not after something breaks.
What it checks
Crystalball analyzes only staged files and can detect:
- Broken or incomplete code
- Risky or unclear changes
- Poor commit practices
- Missing structure or documentation
- Debug or test code committed by mistake
If Copilot is unavailable, it safely falls back to local analysis.
Example test
I tested Crystalball with a deliberately broken HTML file containing:
- Missing closing tags
- Broken JavaScript
- Invalid structure
After staging the file and running Crystalball, it correctly reported:
- Missing closing tags
- Broken JavaScript logic
- Invalid HTML structure
- High overall risk level
Why this workflow works
- No GitHub Actions required
- No online demo needed
- Runs locally in the terminal
- Fits real developer workflows
- Works on Windows CMD
Crystalball doesn’t block commits — it helps you think before making them.
Built for the GitHub Copilot CLI Challenge
This project explores how GitHub Copilot CLI can improve real-world developer workflows directly from the terminal.
Source code:
https://github.com/ejfxgit2025/copilot-commit-crystalball
Top comments (0)