⚡️ zgit — Git, Visualized.

A beautifully styled, Tokyo Night-themed CLI wrapper for Git that turns raw output into structured visual panels.

---

  ░██   ░██    
                              ░██    
  ░█████████  ░████████ ░██░████████ 
       ░███  ░██    ░██ ░██   ░██    
     ░███    ░██    ░██ ░██   ░██    
   ░███      ░██   ░███ ░██   ░██    
  ░█████████  ░█████░██ ░██    ░████ 
                    ░██              
              ░███████

Git, without the grey blur.

zgit wraps standard git commands and presents them in high-contrast Tokyo Night widgets. Zero configuration, zero context switching. Just your workflow, beautiful by default.

---

✨ Features

1. Unified Status Panels (zgit status)

Get a grouped summary of your staging and working tree state with color-coded headings and status indicators:

╭─ Status ─────────────────────────────────╮
│ ℹ Branch:   main                         │
│ ℹ Tracking: origin/main                  │
│                                          │
│ MODIFIED (1)                             │
│   📝 src/banner.js                       │
╰──────────────────────────────────────────╯

2. Streamlined Log Trees (zgit log & zgit log --graph)

Read history with custom bullet symbols, contributor flags, and formatted relative dates. Uses a right-borderless open-box style to prevent wrapping on thin terminals:

╭─ Logs ────────────────────────────────────────────────────────────────────────────────
│ ● f36a1ef feat: premium ui refresh for zgit log, help, and readme (by britz) 6/6/2026
│ ● 5acdc63 feat: premium zgit log output (by britz) 6/6/2026
│ ● ef48476 docs: redesign readme as premium landing page (by britz) 6/6/2026
╰───────────────────────────────────────────────────────────────────────────────────────

3. Open-Box Diff Layout (zgit diff)

No more copying vertical borders (│) when extracting code from diff outputs. Line additions are colored soft green, deletions soft red, and file indicators cyan.

4. Rich Branch Summaries (zgit branch)

Highlights your current branch in bold green and lists other branches alongside their latest short commit hashes and summaries:

╭─ Branches ────────────────────────────────────────────────────────────────────────────────╮
│ Current: main                                                                             │
│                                                                                           │
│ ● main [f36a1ef] (feat: premium ui refresh for zgit log, help, and readme)                │
│   remotes/origin/main [f36a1ef] (feat: premium ui refresh for zgit log, help, and readme) │
╰───────────────────────────────────────────────────────────────────────────────────────────╯

---

🚀 Install & Quick Start

Global Installation

npm install -g @12britz/zgit

Run without installing (On-Demand)

npx @12britz/zgit st

Typical Workflow Commands

zgit status                 # Beautiful working tree status
zgit branch                 # Rich branch list with commit logs
zgit diff [file]            # Colored code diffs
zgit log --count 5          # History log list
zgit add .                  # Stage files in a green status frame
zgit commit -m "Your msg"   # Record commit
zgit push origin            # Push commits to remote

---

🛠 Command Reference

Command	Shortcut	Description	Output Style
init [path]	-	Create new git repository	Full Box
clone <url> [path]	-	Clone a remote repo	Full Box
status	st	Check working tree state	Full Box
log	-	Read commit history list	Open Box
diff [file]	-	Review file changes	Open Box
add [path]	-	Stage files to indexes	Full Box
commit	-	Record changes	Full Box
branch	-	Manage local/remote branches	Full Box
switch <name>	sw	Change working branches	Full Box
stash	-	Save or pop changes	Open Box
reset [ref]	-	Reset changes (mixed/hard/soft)	Full Box
merge <branch>	-	Join work branches	Full Box
pull / push	-	Sync changes with origin	Full Box
remote	-	Manage git origins	Open Box
tag [name]	-	Mark version releases	Full Box

---

🎨 Theme Details

zgit uses custom TrueColor escape sequences mapped to the Tokyo Night theme:

• Background Accent Panels: #7aa2f7 (Tokyo Night Blue)
• Success/Staged Action Panels: #9ece6a (Soft Green)
• Danger/Delete Action Panels: #f7768e (Coral Red)
• Caution/Reset Action Panels: #e0af68 (Warm Yellow)
• Graph/Conflict Action Panels: #bb9af3 (Warm Purple)