Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 gitdash

A beautiful, interactive terminal dashboard for Git — packed with repo stats, commit streaks, achievements, and quick actions.

Shell: Bash Platform License: MIT


✨ Features

  • 📦 Repo overview — name, branch, remote, commit count, contributors
  • 🔥 Commit streak tracker with 7-day activity graph
  • 🏅 Achievements — unlock badges as your repo grows
  • 📝 Latest commit info at a glance
  • 📊 Working directory status with visual bars
  • 🏆 Top contributors leaderboard
  • Quick actions — stage, commit, push, pull, branch, tag, PR and more
  • 🤖 Smart commit message suggestions based on changed file types
  • 🔀 GitHub / GitLab PR/MR creation (with CLI or browser fallback)

📦 Installation

macOS / Linux

git clone https://github.com/eatsleepcode-repeat/gitdash.git
cd gitdash
chmod +x install.sh
./install.sh

Windows (Git Bash or WSL)

git clone https://github.com/eatsleepcode-repeat/gitdash.git
cd gitdash
bash install.sh

Note: On Windows, use Git Bash or WSL (Windows Subsystem for Linux). Native CMD is not supported directly.


🚀 Usage

Navigate to any Git repository and run:

gitdash

Use the number menu to select actions. Press Enter to return to the dashboard after any action. Press 0 to exit.


⚙️ Requirements

Requirement Notes
git Any recent version
bash 3.2+ macOS ships with 3.2 (works). Bash 4+ recommended for full feature support
gh (optional) GitHub CLI — for PR creation
glab (optional) GitLab CLI — for MR creation

macOS users: If you want Bash 4+, install via Homebrew:

brew install bash

🗑️ Uninstall

./install.sh --uninstall

Or manually remove gitdash from ~/.local/bin/, ~/bin/, or /usr/local/bin/.


🎮 Quick Actions Reference

# Action
1 Show detailed status
2 Stage all changes
3 Commit changes
4 Add → Commit → Push (one command)
5 Show diff
6 Show commit history (graph)
7 List all branches
8 Push to remote
9 Pull from remote
10 Refresh dashboard
11 Search commits by message
12 Create a new tag
13 Create a new branch
14 Create pull/merge request
15 Smart commit message suggestions
16 Create git aliases
0 Exit

🏅 Achievements

Badge Requirement
🥉 10+ Commits 10 or more commits
🥈 50+ Commits 50 or more commits
🥇 100+ Commits 100 or more commits
💎 500+ Commits 500 or more commits
👑 1000+ Commits 1000 or more commits
🔥 3-Day Streak Commits 3 days in a row
⚡ Week Warrior Commits 7 days in a row
🌟 Monthly Master Commits 30 days in a row
👥 Team Player 5+ contributors
🎪 Big Team 10+ contributors

🛠️ Troubleshooting

gitdash: command not found after install

Restart your terminal, or run source ~/.bashrc (or ~/.zshrc / ~/.bash_profile depending on your shell).

Streak always shows 0

Your system's date command may behave differently. macOS and Linux use different flags — gitdash handles both, but some Docker/minimal environments may lack full date support.

Emojis not displaying correctly

Make sure your terminal supports UTF-8. Most modern terminals do (iTerm2, Windows Terminal, GNOME Terminal, etc.).

On macOS: array operations require Bash 4+

Install bash 4+ via brew install bash. The dashboard still works with bash 3.2 for all core features.


📄 License

MIT — use it, fork it, improve it.

About

A beautiful, interactive terminal dashboard for Git — packed with repo stats, commit streaks, achievements, and quick actions.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages