GitGhost 👻

Zero-token, offline-first natural language Git controller and multi-commit orchestrator for VS Code.

Created by Swayam Kiran Prabhu (@swayamprabhu2005)

GitGhost transforms simple, natural English instructions into executed Git operations without using cloud AI models, external API keys, or consuming Copilot quota.

🌟 Why GitGhost?

🚀 Key Capabilities

1. Dedicated Sidebar Chat Assistant

Click the GitGhost icon on the left Activity Bar to open an interactive chat interface:

• Conversational message thread with instant execution
• Interactive Commit Cards with file diff breakdowns
• Quick-action shortcut chips (⚡ Smart Split, 🚀 Init & Remote, ↩️ Undo Commit, 🌿 New Branch, 📦 Stash, ⬆️ Push)
• Live branch status badge and commit style switcher

2. Human vs. Conventional Commit Style Preference

Choose how your commit messages look in Settings or switch styles directly in the chat:

• Human Style (Default): Produces clean, imperative English sentences like a human engineer would write:

  "Add responsive Navbar and Header drawer components" "Update project dependencies and TypeScript build settings"

• Conventional Style: Standard semantic prefixes for changelog tooling:

  "feat(frontend): add responsive Navbar and Header drawer components"

3. Repository Initialization & Remote Linking

Start new projects effortlessly:

init repo and set remote https://github.com/swayamprabhu2005/GitGhost.git

GitGhost runs git init, aligns the branch to modern main, links your remote origin URL, and prepares your first commit.

4. Intelligent Multi-Commit Partitioning ($K$-Way Splitting)

Have a messy working directory with 20 changed files?

split into 3 commits with frontend first

GitGhost analyzes your files, scans relative import statements so dependent files stay together, balances lines of code changed, and sequences the commits logically.

5. Co-Authors & Team Attribution

Give full credit to teammates directly in commits:

commit with co-author Alex <alex@example.com> and Jane <jane@example.com>

Appends standard Co-authored-by: metadata trailers that GitHub automatically recognizes in contribution graphs.

6. Extended Git Toolkit

GitGhost automates everyday Git tasks that developers often have to search for:

7. Slang & Confirmation Safeguards

When developer slang is detected (e.g., "yeet this stuff into two dumps" or "nuke my changes"), GitGhost triggers an interactive confirmation modal:

🤖 GitGhost: "I understood you want to: Divide uncommitted changes into 2 separate commits. Is this correct?"

[ Proceed ]      [ Cancel ]

8. Offline Reachability & Push Queue

Commits and branches are always created locally. Before pushing, GitGhost probes socket connectivity to your remote host (github.com:443). If offline:

• Your local commits remain safe.
• The push is enqueued in the status bar ($(cloud-upload) GitGhost (1 offline push queued)).
• You can sync with a single click when back online.

💻 How to Use

1. Activity Bar Sidebar Chat

Click the GitGhost Ghost Icon in the VS Code Activity Bar on the left rail.

2. VS Code Chat Participant (@gitghost)

Open the VS Code Chat panel and type:

@gitghost split into 4 commits with backend first

3. Command Palette (Ctrl+Shift+P / Cmd+Shift+P)

• GitGhost: Run Natural Language Command
• GitGhost: Smart Split Changes into N Commits
• GitGhost: Generate Commit Message
• GitGhost: Create Clean Orphan Branch
• GitGhost: Initialize Repository & Remote
• GitGhost: Show Git Status & Safety Queue

⚙️ Settings

Configure GitGhost via Settings (Ctrl+,) $\rightarrow$ Extensions $\rightarrow$ GitGhost:

🧪 Testing & Verification

# Compile TypeScript production bundle
npm run compile

# Run full test suite
npm run test:all

📄 License

MIT © GitGhost Contributors