gitxelectron 1.3.5 → 1.3.7

package/README.md

@@ -1,96 +1,97 @@
-# GitElectron (formerly GitQuickPush)
-
-GitElectron is a clean, modern, and intelligent desktop application and CLI tool designed to completely automate your Git workflow. Built with the philosophy **"I just write code. GitElectron takes care of Git,"** the tool removes the manual burden of `add`, `commit`, and `push`, silently synchronizing your work with GitHub while you focus on coding.
-
-## Features
-
-- **Universal Installation:** Works seamlessly as a standalone desktop executable (.exe) or as a globally installed NPM package.
-- **Context-Aware CLI Integration:** Run `gitxelectron open` from any integrated terminal (VS Code, Cursor, Antigravity) to instantly launch the desktop app automatically hooked into that specific project directory.
-- **Universal Push Wizard:** Drag-and-drop any folder from your computer to push it directly to any GitHub repository or branch, even if the folder isn't a Git repository! (Utilizes a hyper-optimized `--sparse` checkout engine in the background).
-- **Collaboration & Invitations:** Manage GitHub repository collaborators directly from the UI. Accept or decline incoming repository invitations, and see a beautiful overlapping avatar stack of active collaborators in the top bar.
-- **AI Auto-Healer (Manual Control):** If a severe push or pull error occurs, the app halts, displays the raw error, and provides a ✨ **Fix with AI** button. You have full manual control over when the backend AI engine kicks in to resolve merge conflicts or deep Git state issues.
-- **Bulletproof Auto-Sync Engine:** 
-  - Automatically monitors your code folders using an intelligent debounced file watcher.
-  - Automatically stages modified files, generates clean commit messages, and pushes to GitHub in the background.
-  - **Auto-Rebase Immunity:** If your local branch is behind the remote, the engine silently performs a `git pull --rebase` and retries the push, completely automating non-fast-forward conflict resolution without interrupting you.
-  - **Credential Freeze Protection:** Bypasses OS Credential Managers entirely, directly injecting your secure OAuth tokens into an isolated Git instance. Branches, commits, and pushes will never freeze on an authentication prompt.
-- **First-Run Authentication & PIN Lock:** Instantly hooks into your GitHub account using secure OAuth Device Flow. Secure your app with a custom Lockscreen PIN and Daily Auth.
-- **Built-in Auto-Updater:** Never run a terminal command to update again. GitElectron checks the NPM registry on the lockscreen and provides a 1-click silent update button.
-- **Beautiful & Dynamic Interface:**
-  - **iOS Glassmorphism Toasts:** All system notifications slide in beautifully using iOS-style translucent blur UI.
-  - **Theming & Audio:** Multiple themes equipped with authentic sound effects and globally adaptive custom scrollbars.
-- **Terminal Pushing:** Need to manually push a file fast? Use the built-in `gitxelectron push -f <file>` CLI command.
-- **Visual Git Management:** If you prefer manual control, the beautiful React UI allows you to visually inspect diffs, stage files, resolve conflicts, and switch branches.
-
-## Installation
-
-### Method 1: Zero-Install (npx)
-
-The absolute fastest way to use GitElectron is directly through `npx` without installing anything globally!
-
-```bash
-npx gitxelectron open
-```
-This will instantly download and launch the desktop app for your current folder on the fly.
-
-### Method 2: NPM (Recommended for Developers)
-
-If you have Node.js installed, GitElectron is built to be a seamless global utility.
-
-```bash
-npm install -g gitxelectron
-```
-
-Upon installation, GitElectron will automatically launch the desktop application, prompt you for GitHub authorization, and initialize your environment.
-
-### Method 3: Standalone Executable
-
-Download the latest `.exe` installer from the Releases page and run it. The application will guide you through connecting your GitHub account.
-
-## Usage
-
-### Auto-Sync (The Magic)
-
-Once logged in, simply open any Git repository in GitElectron. The **Auto-Sync** feature is enabled by default. Minimize the app.
-As you edit and save files in VS Code or your editor of choice, GitElectron will detect the changes, wait 3 seconds for you to finish, and push them directly to GitHub.
-
-### CLI Commands
-
-- **Open Contextually:** Open your terminal inside your project folder and run:
-
-  ```bash
-  npx gitxelectron open
-  # OR if installed globally:
-  gitxelectron open
-  ```
-
-  The desktop app will instantly pop up and initialize that exact folder.
-
-- **Manual Push:** Push a single file quickly:
-  ```bash
-  npx gitxelectron push -f src/index.js -m "Updated logic"
-  ```
-
-## Development Setup
-
-To build and run GitElectron locally:
-
-1. Clone the repository and install dependencies:
-   ```bash
-   npm install
-   ```
-2. Start the development server (Hot Module Replacement enabled):
-   ```bash
-   npm run dev
-   ```
-3. To build the production binary:
-   ```bash
-   npm run build:win
-   ```
-
-## Architecture
-
-- **Renderer (`src/renderer`):** A modern React + TailwindCSS interface running inside an Electron Window.
-- **Main (`src/main`):** Node.js backend handling system files (`chokidar` for watching), secure credentials, single-instance locking, and Git automation via `simple-git`.
-- **Preload (`src/preload`):** A secure ContextBridge tying the UI strictly to safe IPC handlers.
-- **CLI (`bin/cli.js`):** A Commander-based Node script that transparently spawns the packaged Electron executable, merging NPM utility with Desktop power.
+# GitElectron (formerly GitQuickPush)
+
+GitElectron is a clean, modern, and intelligent desktop application and CLI tool designed to completely automate your Git workflow. Built with the philosophy **"I just write code. GitElectron takes care of Git,"** the tool removes the manual burden of `add`, `commit`, and `push`, silently synchronizing your work with GitHub while you focus on coding.
+
+## Features
+
+- **Universal Installation:** Works seamlessly as a standalone desktop executable (.exe) or as a globally installed NPM package.
+- **Context-Aware CLI Integration:** Run `gitxelectron open` from any integrated terminal (VS Code, Cursor, Antigravity) to instantly launch the desktop app automatically hooked into that specific project directory.
+- **Universal Push Wizard:** Drag-and-drop any folder from your computer to push it directly to any GitHub repository or branch, even if the folder isn't a Git repository! (Utilizes a hyper-optimized `--sparse` checkout engine in the background).
+- **Collaboration & Invitations:** Manage GitHub repository collaborators directly from the UI. Accept or decline incoming repository invitations, and see a beautiful overlapping avatar stack of active collaborators in the top bar.
+- **AI Auto-Healer (Manual Control):** If a severe push or pull error occurs, the app halts, displays the raw error, and provides a ✨ **Fix with AI** button. You have full manual control over when the backend AI engine kicks in to resolve merge conflicts or deep Git state issues.
+- **Bulletproof Auto-Sync Engine:**
+  - Automatically monitors your code folders using an intelligent debounced file watcher.
+  - Automatically stages modified files, generates clean commit messages, and pushes to GitHub in the background.
+  - **Auto-Rebase Immunity:** If your local branch is behind the remote, the engine silently performs a `git pull --rebase` and retries the push, completely automating non-fast-forward conflict resolution without interrupting you.
+  - **Credential Freeze Protection:** Bypasses OS Credential Managers entirely, directly injecting your secure OAuth tokens into an isolated Git instance. Branches, commits, and pushes will never freeze on an authentication prompt.
+- **First-Run Authentication & PIN Lock:** Instantly hooks into your GitHub account using secure OAuth Device Flow. Secure your app with a custom Lockscreen PIN and Daily Auth.
+- **Built-in Auto-Updater:** Never run a terminal command to update again. GitElectron checks the NPM registry on the lockscreen and provides a 1-click silent update button.
+- **Beautiful & Dynamic Interface:**
+  - **iOS Glassmorphism Toasts:** All system notifications slide in beautifully using iOS-style translucent blur UI.
+  - **Theming & Audio:** Multiple themes equipped with authentic sound effects and globally adaptive custom scrollbars.
+- **Terminal Pushing:** Need to manually push a file fast? Use the built-in `gitxelectron push -f <file>` CLI command.
+- **Visual Git Management:** If you prefer manual control, the beautiful React UI allows you to visually inspect diffs, stage files, resolve conflicts, and switch branches.
+
+## Installation
+
+### Method 1: Zero-Install (npx)
+
+The absolute fastest way to use GitElectron is directly through `npx` without installing anything globally!
+
+```bash
+npx gitxelectron open
+```
+
+This will instantly download and launch the desktop app for your current folder on the fly.
+
+### Method 2: NPM (Recommended for Developers)
+
+If you have Node.js installed, GitElectron is built to be a seamless global utility.
+
+```bash
+npm install -g gitxelectron
+```
+
+Upon installation, GitElectron will automatically launch the desktop application, prompt you for GitHub authorization, and initialize your environment.
+
+### Method 3: Standalone Executable
+
+Download the latest `.exe` installer from the Releases page and run it. The application will guide you through connecting your GitHub account.
+
+## Usage
+
+### Auto-Sync (The Magic)
+
+Once logged in, simply open any Git repository in GitElectron. The **Auto-Sync** feature is enabled by default. Minimize the app.
+As you edit and save files in VS Code or your editor of choice, GitElectron will detect the changes, wait 3 seconds for you to finish, and push them directly to GitHub.
+
+### CLI Commands
+
+- **Open Contextually:** Open your terminal inside your project folder and run:
+
+  ```bash
+  npx gitxelectron open
+  # OR if installed globally:
+  gitxelectron open
+  ```
+
+  The desktop app will instantly pop up and initialize that exact folder.
+
+- **Manual Push:** Push a single file quickly:
+  ```bash
+  npx gitxelectron push -f src/index.js -m "Updated logic"
+  ```
+
+## Development Setup
+
+To build and run GitElectron locally:
+
+1. Clone the repository and install dependencies:
+   ```bash
+   npm install
+   ```
+2. Start the development server (Hot Module Replacement enabled):
+   ```bash
+   npm run dev
+   ```
+3. To build the production binary:
+   ```bash
+   npm run build:win
+   ```
+
+## Architecture
+
+- **Renderer (`src/renderer`):** A modern React + TailwindCSS interface running inside an Electron Window.
+- **Main (`src/main`):** Node.js backend handling system files (`chokidar` for watching), secure credentials, single-instance locking, and Git automation via `simple-git`.
+- **Preload (`src/preload`):** A secure ContextBridge tying the UI strictly to safe IPC handlers.
+- **CLI (`bin/cli.js`):** A Commander-based Node script that transparently spawns the packaged Electron executable, merging NPM utility with Desktop power.

package/bin/postinstall.js

@@ -35,19 +35,19 @@ try {
       try {
         const os = require('os')
         const desktopPath = path.join(os.homedir(), 'Desktop', 'GitElectron.lnk')
-        
+
         const psCommand = `
           $WshShell = New-Object -comObject WScript.Shell;
           $Shortcut = $WshShell.CreateShortcut("${desktopPath}");
           $Shortcut.TargetPath = "${electronPath}";
           $Shortcut.Arguments = "\\"${appPath}\\"";
           $Shortcut.Save();
-        `;
-        const { execSync } = require('child_process');
-        execSync(`powershell -NoProfile -Command "${psCommand}"`, { stdio: 'ignore' });
-        console.log('✅ Desktop shortcut created successfully!');
+        `
+        const { execSync } = require('child_process')
+        execSync(`powershell -NoProfile -Command "${psCommand}"`, { stdio: 'ignore' })
+        console.log('✅ Desktop shortcut created successfully!')
       } catch (err) {
-        console.log('Failed to create Desktop shortcut.');
+        console.log('Failed to create Desktop shortcut.')
       }
     }
   }

package/bin/preuninstall.js

@@ -1,22 +1,22 @@
-const { execSync } = require('child_process');
-const os = require('os');
+const { execSync } = require('child_process')
+const os = require('os')
 
-console.log('Preparing GitElectron for update... Safely closing any active instances.');
+console.log('Preparing GitElectron for update... Safely closing any active instances.')
 
 try {
-    if (os.platform() === 'win32') {
-        execSync('taskkill /IM GitElectron.exe /F', { stdio: 'ignore' });
-    } else {
-        execSync('pkill -f GitElectron', { stdio: 'ignore' });
-    }
+  if (os.platform() === 'win32') {
+    execSync('taskkill /IM GitElectron.exe /F', { stdio: 'ignore' })
+  } else {
+    execSync('pkill -f GitElectron', { stdio: 'ignore' })
+  }
 } catch (e) {
-    // Process might not be running, which is completely fine.
+  // Process might not be running, which is completely fine.
 }
 
 // Block for 1.5 seconds to ensure the OS fully releases all file locks
-const start = Date.now();
+const start = Date.now()
 while (Date.now() - start < 1500) {
-    // Wait
+  // Wait
 }
 
-process.exit(0);
+process.exit(0)