KitsuneGIT 🦊

A lightweight, fast, universal Git GUI client — built with Electron. Inspired by SourceTree, designed to be faster and cross-platform.

Features

Complete Git Operations

• Repository: Open, Clone, Init
• Staging: Stage/Unstage files individually or all at once, discard changes
• Commit: Commit with message, amend support, conventional commits
• Push / Pull / Fetch: Full remote sync with rebase option
• Branches: Create, delete, checkout, rename (local & remote)
• Merge & Rebase: Merge with --no-ff, rebase, abort/continue rebase
• Tags: Create (lightweight & annotated), delete
• Stash: Stash, list, pop, drop
• Remotes: Add, remove, view
• Cherry-pick: Apply specific commits
• Revert: Revert commits
• Reset: Soft, mixed, hard reset to any commit
• Blame: Line-by-line annotation
• File History: View commit history for any file
• Diff Viewer: Inline and side-by-side diff with syntax highlighting

Visual Interface

• Dark/Light Catppuccin-inspired theme (toggle with one click)
• SourceTree-like layout with sidebar (branches, tags, stashes, remotes)
• Dual file status panel (staged/unstaged) with inline diff viewer
• Commit history table with graph, refs, and commit detail pane
• Multi-tab repository support
• Context menus on files, branches, tags, stashes, commits
• Drag & drop staging
• Modal dialogs for complex operations
• Toast notifications
• Resizable sidebar
• Keyboard shortcuts
• File watcher with auto-refresh
• Recent repositories list
• Auto-updater for production builds

Cross-Platform

• Windows: NSIS installer + portable executable
• Linux: AppImage + .deb + .rpm + .tar.gz
• Cross-platform file watching (chokidar)

Prerequisites

• Node.js 18+
• Git installed and in PATH

Quick Start

Windows

# Option 1: Use the batch scripts
start-dev.bat          # Development mode (with DevTools)
start.bat              # Production mode

# Option 2: Manual
npm install
npm run dev            # Development
npm start              # Production

Linux

# Option 1: Use the shell scripts
chmod +x start-dev.sh build-release.sh
./start-dev.sh         # Development mode
./start.sh             # Production mode

# Option 2: Manual
npm install
npm run dev            # Development
npm start              # Production

Building Release Packages

Windows (from Windows)

# Using the build script:
build-release.bat

# Or manually:
npm install
npm run build:win

Output (CODE_0 folder):

• CODE_0 — NSIS installer (with desktop shortcut, start menu, uninstaller)
• CODE_0 — Portable executable (no install needed)

Linux (from Linux)

# Using the build script:
chmod +x build-release.sh
./build-release.sh

# Or manually:
npm install
npm run build:linux

Output (CODE_0 folder):

• CODE_0 — Universal Linux package (run anywhere)
• CODE_0 — Debian/Ubuntu package
• CODE_0 — Fedora/RHEL package
• CODE_0 — Generic archive

Both Platforms at Once

npm run build:all

This will build for Windows + Linux.

App Icons

Icons are auto-generated on first build via CODE0. To use a custom icon, replace CODE1 with your own 512x512 PNG. CODE2 auto-generates CODE3 and CODE_4 from it.

Project Structure

KitsuneGIT/
├── build/
│   └── icon.png               # App icon (auto-generated or custom)
├── scripts/
│   └── generate-icons.js      # Icon generation script
├── src/
│   ├── main/
│   │   ├── main.js            # Electron main process
│   │   └── preload.js         # Context bridge (IPC)
│   ├── git/
│   │   └── git-service.js     # Git operations (simple-git wrapper)
│   └── renderer/
│       ├── index.html         # UI shell
│       ├── styles.css         # Dark/Light theme styles
│       └── app.js             # Frontend logic
├── start.bat / start.sh       # Production launchers
├── start-dev.bat / start-dev.sh  # Development launchers
├── build-release.bat / build-release.sh  # Build scripts
├── package.json
├── LICENSE
└── README.md

Available Scripts

Keyboard Shortcuts

Tech Stack

• Electron — Cross-platform desktop app
• simple-git — Node.js Git interface
• chokidar — Cross-platform file watching
• electron-builder — Packaging & distribution
• electron-updater — Auto-update support

License

MIT