A beautiful, keyboard-driven git TUI dashboard with a dark retro aesthetic. Fast, minimal, no bloat. Perfect for managing git operations right from your terminal.
With odgit you can:
- See git status instantly - All modified files at a glance
- Navigate with just keyboard - Arrow keys, Enter, that's it
- Stage and commit smartly - Auto-stages before commit
- Generate commit messages with AI - Free conventional commits using apifreellm
- Manage branches, stash, logs - All git operations in one place
- No mouse required - Pure keyboard-driven workflow
npm install -g @hamzaod/odgitodgitDone! 🚀
Keyboard only. That's it.
| Key | What It Does |
|---|---|
↑ ↓ |
Move up/down in menu |
Enter |
Do the selected action |
? |
Show help |
q |
Quit |
r |
Refresh |
1. Type: odgit
2. Edit some files in your project
3. Press ↓ to select "commit"
4. Press Enter
5. Type your commit message
6. Press Enter
7. Done! Files auto-staged and committed
| Action | What It Does |
|---|---|
| status | See all modified files |
| stage | Mark files to commit |
| commit | Stage everything + write message |
| gen msg | AI generates commit message for you |
| push | Send commits to GitHub |
| pull | Get latest from GitHub |
| log | See recent commits |
| branch | Switch to another branch |
| stash | Save work temporarily |
| pop stash | Get saved work back |
| discard | Throw away changes (whoops!) |
odgit can auto-generate commit messages using AI:
1. Select "gen msg"
2. Press Enter
3. Wait 2 seconds
4. See: "feat(auth): add login function"
5. Edit or confirm
How to enable:
- On first launch, paste your free API key from https://apifreellm.com
- Or type
genkeylater to add it
A: Yes! After npm install -g @hamzaod/odgit, the odgit command works in any terminal, any directory. Just type:
odgitIt works because npm puts it in your PATH. No extra setup needed.
A: Yes. odgit only works inside git repositories. If you're not in one, run git init first.
A: In .env file in your home directory. It's never uploaded to GitHub or sent anywhere except to apifreellm.com for generating messages.
A: Absolutely. Just skip the API key setup on first launch (press Esc). You can use all other features normally.
A: Be careful! "discard" deletes all changes. Use it only when you're sure. Odgit asks for confirmation before doing it.
A: Same command:
npm install -g @hamzaod/odgitnpm automatically updates to the latest version.
A: Yes! Works on all three. You just need Node.js 18+.
A: You're probably in a non-interactive terminal (GitHub Actions, Docker, etc.). odgit needs a real terminal to work. Try running locally instead.
A: GitHub Issues: https://github.com/hamzaODprogramer/odgit/issues
- No mouse - Pure keyboard, super fast
- No clutter - Just what you need
- Retro look - Cyan/magenta, dark background
- Smart features - Auto-stages before commit
- AI integration - Free conventional commits
- Single render - Ultra-fast, no lag
"odgit: command not found"
npm install -g @hamzaod/odgit"No git repository"
git init"API key invalid"
- Get a free key: https://apifreellm.com
- Run: Select "genkey" from menu
"Terminal looks weird"
- Try a different terminal app
- Make sure terminal supports 256+ colors
- Quick Start: See QUICKSTART.md
- Installation: See package.json
- Contributing: Pull requests welcome!
MIT - Use however you want
Questions? Open an issue on GitHub or check QUICKSTART.md for more help.
npm: https://www.npmjs.com/package/@hamzaod/odgit GitHub: https://github.com/hamzaODprogramer/odgit
Install with:
npm install -g @hamzaod/odgitHappy committing! 🚀