better-antigravity 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kanezal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,168 @@
+<div align="center">
+
+# ⚡ Better Antigravity
+
+**Community-driven fixes and improvements for [Antigravity IDE](https://antigravity.dev)**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/AkaNPC/better-antigravity/pulls)
+[![Antigravity](https://img.shields.io/badge/Antigravity-v1.107.0+-blue.svg)](https://antigravity.dev)
+
+*Antigravity is great. We just make it a little better.*
+
+</div>
+
+---
+
+## 🤔 What is this?
+
+A collection of **hotfixes and patches** for bugs in Antigravity IDE that haven't been officially resolved yet. Each fix is a standalone script you can apply and revert safely.
+
+> **Note:** These are unofficial community patches. Use at your own risk. All fixes create automatic backups and can be reverted with a single command.
+
+---
+
+## 📦 Available Fixes
+
+| Fix | Description | Status |
+|-----|-------------|--------|
+| [**auto-run-fix**](#-auto-run-fix) | "Always Proceed" terminal policy doesn't auto-execute commands | 🟢 Working |
+
+---
+
+## 🔧 Auto-Run Fix
+
+### The Problem
+
+You set **Settings → Agent → Terminal Execution → "Always Proceed"**, but Antigravity **still asks you to click "Run"** on every single terminal command. Every. Single. Time.
+
+The setting saves correctly, Strict Mode is off — it just doesn't work.
+
+### Root Cause
+
+Found in the source code: the `run_command` step renderer component has an `onChange` handler that auto-confirms commands when you switch the dropdown to "Always run" **on a specific step**. But there's **no `useEffect` hook** that checks the saved policy at mount time and auto-confirms **new steps**.
+
+In other words: the UI reads your setting, displays the correct dropdown value, but never actually acts on it automatically.
+
+```javascript
+// What exists (only fires on dropdown CHANGE):
+y = Mt(_ => {
+    setTerminalAutoExecutionPolicy(_),
+    _ === EAGER && confirm(true) // ← only when you manually switch
+}, [])
+
+// What's MISSING (should fire on component mount):
+useEffect(() => {
+    if (policy === EAGER && !secureMode) confirm(true) // ← auto-confirm new steps
+}, [])
+```
+
+### The Fix
+
+Our patcher adds the missing `useEffect`. It uses **regex pattern matching** to find code by structure — not by minified variable names — so it works across Antigravity versions.
+
+### Usage
+
+```bash
+# Make sure Node.js 16+ is installed
+
+# Apply the fix
+node fixes/auto-run-fix/patch.js
+
+# Check if it's applied
+node fixes/auto-run-fix/patch.js --check
+
+# Revert to original
+node fixes/auto-run-fix/patch.js --revert
+```
+
+### Example Output
+
+```
+╔══════════════════════════════════════════════════╗
+║  Antigravity "Always Proceed" Auto-Run Fix      ║
+╚══════════════════════════════════════════════════╝
+
+📍 C:\Users\user\AppData\Local\Programs\Antigravity
+📦 Version: 1.107.0 (IDE 1.19.5)
+
+  📋 [workbench] Found onChange at offset 12362782
+     callback=Mt, enum=Dhe, confirm=b
+     policyVar=u
+     secureVar=d
+     useEffect=mn (confidence: 30 hits)
+  ✅ [workbench] Patched (+43 bytes)
+  📋 [jetskiAgent] Found onChange at offset 8388797
+     callback=ve, enum=rx, confirm=F
+     policyVar=d
+     secureVar=f
+     useEffect=At (confidence: 55 hits)
+  ✅ [jetskiAgent] Patched (+42 bytes)
+
+✨ Done! Restart Antigravity.
+```
+
+### Compatibility
+
+| Antigravity Version | Status |
+|---------------------|--------|
+| 1.107.0 | ✅ Tested |
+| Other versions | 🟡 Should work (dynamic pattern matching) |
+
+---
+
+## 🛡️ Safety
+
+- **Automatic backups** — original files are saved as `.bak` before patching
+- **One-command revert** — run with `--revert` to restore originals instantly
+- **Non-destructive** — patches only add code, never remove existing logic
+- **Version-resilient** — uses structural regex matching, not hardcoded variable names
+- **Syntax validation** — verifies code structure before writing
+
+---
+
+## 📂 Project Structure
+
+```
+better-antigravity/
+├── README.md
+├── LICENSE
+└── fixes/
+    └── auto-run-fix/
+        ├── patch.js        # The patcher script
+        └── README.md       # Detailed fix documentation
+```
+
+---
+
+## 🤝 Contributing
+
+Found another Antigravity bug? Have a fix? PRs are welcome!
+
+### Adding a new fix:
+
+1. Create a folder under `fixes/` with a descriptive name
+2. Include a `patch.js` that supports `--check` and `--revert` flags
+3. Add a `README.md` with root cause analysis
+4. Update the main README's fix table
+
+### Guidelines:
+
+- Always create backups before patching
+- Use structural pattern matching, not hardcoded variable names
+- Support `--check` and `--revert` flags
+- Test on a clean Antigravity installation
+
+---
+
+## ⚠️ Disclaimer
+
+This project is not affiliated with Google or the Antigravity team. These are community patches for known bugs. If Antigravity updates and the patches break, simply revert and re-apply (or wait for an updated patch).
+
+**Always report bugs officially** at [antigravity.google/support](https://antigravity.google/support) — community patches are temporary solutions, not replacements for official fixes.
+
+---
+
+## 📜 License
+
+[MIT](LICENSE) — do whatever you want with it.

package/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * better-antigravity CLI
+ * Usage:
+ *   npx better-antigravity                  — list available fixes
+ *   npx better-antigravity auto-run         — apply auto-run fix
+ *   npx better-antigravity auto-run --check — check status
+ *   npx better-antigravity auto-run --revert — revert fix
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const fixes = {
+    'auto-run': {
+        script: path.join(__dirname, 'fixes', 'auto-run-fix', 'patch.js'),
+        description: '"Always Proceed" terminal policy doesn\'t auto-execute commands'
+    }
+};
+
+const args = process.argv.slice(2);
+const fixName = args[0];
+const flags = args.slice(1);
+
+// Header
+console.log('');
+console.log('  better-antigravity — community fixes for Antigravity IDE');
+console.log('  https://github.com/Kanezal/better-antigravity');
+console.log('');
+
+if (!fixName || fixName === '--help' || fixName === '-h') {
+    console.log('  Available fixes:');
+    console.log('');
+    for (const [name, fix] of Object.entries(fixes)) {
+        console.log(`    ${name.padEnd(15)} ${fix.description}`);
+    }
+    console.log('');
+    console.log('  Usage:');
+    console.log('    npx better-antigravity <fix-name>           Apply fix');
+    console.log('    npx better-antigravity <fix-name> --check   Check status');
+    console.log('    npx better-antigravity <fix-name> --revert  Revert fix');
+    console.log('');
+    process.exit(0);
+}
+
+const fix = fixes[fixName];
+if (!fix) {
+    console.log(`  Unknown fix: "${fixName}"`);
+    console.log(`  Available: ${Object.keys(fixes).join(', ')}`);
+    process.exit(1);
+}
+
+if (!fs.existsSync(fix.script)) {
+    console.log(`  Fix script not found: ${fix.script}`);
+    process.exit(1);
+}
+
+// Forward to the fix script with flags
+process.argv = [process.argv[0], fix.script, ...flags];
+require(fix.script);

package/fixes/auto-run-fix/patch.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+
+/**
+ * Antigravity "Always Proceed" Auto-Run Fix
+ * ==========================================
+ * 
+ * Fixes a bug where the "Always Proceed" terminal execution policy doesn't
+ * actually auto-execute commands. Uses regex patterns to find code structures
+ * regardless of minified variable names — works across versions.
+ * 
+ * Usage:
+ *   node patch.js          - Apply patch
+ *   node patch.js --revert - Restore original files
+ *   node patch.js --check  - Check patch status
+ * 
+ * License: MIT
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ─── Installation Detection ─────────────────────────────────────────────────
+
+function findAntigravityPath() {
+    const candidates = [];
+    if (process.platform === 'win32') {
+        candidates.push(
+            path.join(process.env.LOCALAPPDATA || '', 'Programs', 'Antigravity'),
+            path.join(process.env.PROGRAMFILES || '', 'Antigravity'),
+        );
+    } else if (process.platform === 'darwin') {
+        candidates.push(
+            '/Applications/Antigravity.app/Contents/Resources',
+            path.join(os.homedir(), 'Applications', 'Antigravity.app', 'Contents', 'Resources')
+        );
+    } else {
+        candidates.push('/usr/share/antigravity', '/opt/antigravity',
+            path.join(os.homedir(), '.local', 'share', 'antigravity'));
+    }
+    for (const c of candidates) {
+        const f = path.join(c, 'resources', 'app', 'out', 'vs', 'workbench', 'workbench.desktop.main.js');
+        if (fs.existsSync(f)) return c;
+    }
+    return null;
+}
+
+// ─── Smart Pattern Matching ─────────────────────────────────────────────────
+
+/**
+ * Finds the onChange handler for terminalAutoExecutionPolicy and extracts
+ * variable names from context, regardless of minification.
+ * 
+ * Pattern we're looking for (structure, not exact names):
+ *   <VAR_CONFIRM>=<useCallback>((<ARG>)=>{
+ *       <stepHandler>?.setTerminalAutoExecutionPolicy?.(<ARG>),
+ *       <ARG>===<ENUM>.EAGER&&<CONFIRM_FN>(!0)
+ *   },[...])
+ * 
+ * From the surrounding context we also extract:
+ *   <POLICY_VAR> = <stepHandler>?.terminalAutoExecutionPolicy ?? <ENUM>.OFF
+ *   <SECURE_VAR> = <stepHandler>?.secureModeEnabled ?? !1
+ */
+function analyzeFile(content, label) {
+    // 1. Find the onChange handler: contains setTerminalAutoExecutionPolicy AND .EAGER
+    //    Pattern: VARNAME=CALLBACK(ARG=>{...setTerminalAutoExecutionPolicy...,ARG===ENUM.EAGER&&CONFIRM(!0)},[...])
+    const onChangeRe = /(\w+)=(\w+)\((\w+)=>\{\w+\?\.setTerminalAutoExecutionPolicy\?\.\(\3\),\3===(\w+)\.EAGER&&(\w+)\(!0\)\},\[[\w,]*\]\)/;
+    const onChangeMatch = content.match(onChangeRe);
+
+    if (!onChangeMatch) {
+        console.log(`  ❌ [${label}] Could not find onChange handler pattern`);
+        return null;
+    }
+
+    const [fullMatch, assignVar, callbackAlias, argName, enumAlias, confirmFn] = onChangeMatch;
+    const matchIndex = content.indexOf(fullMatch);
+
+    console.log(`  📋 [${label}] Found onChange at offset ${matchIndex}`);
+    console.log(`     callback=${callbackAlias}, enum=${enumAlias}, confirm=${confirmFn}`);
+
+    // 2. Find policy variable: VARNAME=HANDLER?.terminalAutoExecutionPolicy??ENUM.OFF
+    const policyRe = new RegExp(`(\\w+)=\\w+\\?\\.terminalAutoExecutionPolicy\\?\\?${enumAlias}\\.OFF`);
+    const policyMatch = content.substring(Math.max(0, matchIndex - 2000), matchIndex).match(policyRe);
+
+    if (!policyMatch) {
+        console.log(`  ❌ [${label}] Could not find policy variable`);
+        return null;
+    }
+    const policyVar = policyMatch[1];
+    console.log(`     policyVar=${policyVar}`);
+
+    // 3. Find secureMode variable: VARNAME=HANDLER?.secureModeEnabled??!1
+    const secureRe = /(\w+)=\w+\?\.secureModeEnabled\?\?!1/;
+    const secureMatch = content.substring(Math.max(0, matchIndex - 2000), matchIndex).match(secureRe);
+
+    if (!secureMatch) {
+        console.log(`  ❌ [${label}] Could not find secureMode variable`);
+        return null;
+    }
+    const secureVar = secureMatch[1];
+    console.log(`     secureVar=${secureVar}`);
+
+    // 4. Find useEffect alias: look for ALIAS(()=>{...},[...]) calls nearby (not useCallback/useMemo)
+    const nearbyCode = content.substring(Math.max(0, matchIndex - 5000), matchIndex + 5000);
+    const effectCandidates = {};
+    const effectRe = /\b(\w{2,3})\(\(\)=>\{[^}]{3,80}\},\[/g;
+    let m;
+    while ((m = effectRe.exec(nearbyCode)) !== null) {
+        const alias = m[1];
+        if (alias !== callbackAlias && alias !== 'var' && alias !== 'new') {
+            effectCandidates[alias] = (effectCandidates[alias] || 0) + 1;
+        }
+    }
+
+    // Also check broader file for common useEffect patterns (with cleanup return)
+    const cleanupRe = /\b(\w{2,3})\(\(\)=>\{[^}]*return\s*\(\)=>/g;
+    while ((m = cleanupRe.exec(content)) !== null) {
+        const alias = m[1];
+        if (alias !== callbackAlias) {
+            effectCandidates[alias] = (effectCandidates[alias] || 0) + 5; // higher weight
+        }
+    }
+
+    // Remove known non-useEffect aliases (useMemo patterns)
+    // useMemo: alias(()=>EXPRESSION,[deps]) — returns a value, often assigned
+    // useEffect: alias(()=>{STATEMENTS},[deps]) — no return value
+
+    // Pick the most common candidate
+    let useEffectAlias = null;
+    let maxCount = 0;
+    for (const [alias, count] of Object.entries(effectCandidates)) {
+        if (count > maxCount) {
+            maxCount = count;
+            useEffectAlias = alias;
+        }
+    }
+
+    if (!useEffectAlias) {
+        console.log(`  ❌ [${label}] Could not determine useEffect alias`);
+        return null;
+    }
+    console.log(`     useEffect=${useEffectAlias} (confidence: ${maxCount} hits)`);
+
+    // 5. Build patch
+    const patchCode = `_aep=${useEffectAlias}(()=>{${policyVar}===${enumAlias}.EAGER&&!${secureVar}&&${confirmFn}(!0)},[]),`;
+
+    return {
+        target: fullMatch,
+        replacement: patchCode + fullMatch,
+        patchMarker: `_aep=${useEffectAlias}(()=>{${policyVar}===${enumAlias}.EAGER`,
+        label
+    };
+}
+
+// ─── File Operations ────────────────────────────────────────────────────────
+
+function patchFile(filePath, label) {
+    if (!fs.existsSync(filePath)) {
+        console.log(`  ❌ [${label}] File not found: ${filePath}`);
+        return false;
+    }
+
+    const content = fs.readFileSync(filePath, 'utf8');
+
+    // Check if already patched
+    if (content.includes('_aep=')) {
+        const existingPatch = content.match(/_aep=\w+\(\(\)=>\{[^}]+EAGER[^}]+\},\[\]\)/);
+        if (existingPatch) {
+            console.log(`  ⏭️  [${label}] Already patched`);
+            return true;
+        }
+    }
+
+    const analysis = analyzeFile(content, label);
+    if (!analysis) return false;
+
+    // Verify target is unique
+    const count = content.split(analysis.target).length - 1;
+    if (count !== 1) {
+        console.log(`  ❌ [${label}] Target found ${count} times (expected 1)`);
+        return false;
+    }
+
+    // Backup
+    if (!fs.existsSync(filePath + '.bak')) {
+        fs.copyFileSync(filePath, filePath + '.bak');
+        console.log(`  📦 [${label}] Backup created`);
+    }
+
+    // Apply
+    const patched = content.replace(analysis.target, analysis.replacement);
+    fs.writeFileSync(filePath, patched, 'utf8');
+
+    const diff = fs.statSync(filePath).size - fs.statSync(filePath + '.bak').size;
+    console.log(`  ✅ [${label}] Patched (+${diff} bytes)`);
+    return true;
+}
+
+function revertFile(filePath, label) {
+    const bak = filePath + '.bak';
+    if (!fs.existsSync(bak)) {
+        console.log(`  ⏭️  [${label}] No backup, skipping`);
+        return;
+    }
+    fs.copyFileSync(bak, filePath);
+    console.log(`  ✅ [${label}] Restored`);
+}
+
+function checkFile(filePath, label) {
+    if (!fs.existsSync(filePath)) {
+        console.log(`  ❌ [${label}] Not found`);
+        return false;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const patched = content.includes('_aep=') && /_aep=\w+\(\(\)=>\{[^}]+EAGER/.test(content);
+    const hasBak = fs.existsSync(filePath + '.bak');
+
+    if (patched) {
+        console.log(`  ✅ [${label}] PATCHED` + (hasBak ? ' (backup exists)' : ''));
+    } else {
+        const analysis = analyzeFile(content, label);
+        if (analysis) {
+            console.log(`  ⬜ [${label}] NOT PATCHED (patchable)`);
+        } else {
+            console.log(`  ⚠️  [${label}] NOT PATCHED (may be incompatible)`);
+        }
+    }
+    return patched;
+}
+
+// ─── Version Info ───────────────────────────────────────────────────────────
+
+function getVersion(basePath) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(basePath, 'resources', 'app', 'package.json'), 'utf8'));
+        const product = JSON.parse(fs.readFileSync(path.join(basePath, 'resources', 'app', 'product.json'), 'utf8'));
+        return `${pkg.version} (IDE ${product.ideVersion})`;
+    } catch { return 'unknown'; }
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+
+function main() {
+    const args = process.argv.slice(2);
+    const action = args.includes('--revert') ? 'revert' : args.includes('--check') ? 'check' : 'apply';
+
+    console.log('');
+    console.log('╔══════════════════════════════════════════════════╗');
+    console.log('║  Antigravity "Always Proceed" Auto-Run Fix      ║');
+    console.log('╚══════════════════════════════════════════════════╝');
+
+    const basePath = findAntigravityPath();
+    if (!basePath) {
+        console.log('\n❌ Antigravity not found! Install it or run from its directory.');
+        process.exit(1);
+    }
+
+    console.log(`\n📍 ${basePath}`);
+    console.log(`📦 Version: ${getVersion(basePath)}`);
+    console.log('');
+
+    const files = [
+        { path: path.join(basePath, 'resources', 'app', 'out', 'vs', 'workbench', 'workbench.desktop.main.js'), label: 'workbench' },
+        { path: path.join(basePath, 'resources', 'app', 'out', 'jetskiAgent', 'main.js'), label: 'jetskiAgent' },
+    ];
+
+    switch (action) {
+        case 'check':
+            files.forEach(f => checkFile(f.path, f.label));
+            break;
+        case 'revert':
+            files.forEach(f => revertFile(f.path, f.label));
+            console.log('\n✨ Restored! Restart Antigravity.');
+            break;
+        case 'apply':
+            const ok = files.every(f => patchFile(f.path, f.label));
+            console.log(ok
+                ? '\n✨ Done! Restart Antigravity.\n💡 Run with --revert to undo.\n⚠️  Re-run after Antigravity updates.'
+                : '\n⚠️  Some patches failed.');
+            break;
+    }
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "better-antigravity",
+  "version": "0.1.0",
+  "description": "Community-driven fixes and improvements for Antigravity IDE",
+  "main": "fixes/auto-run-fix/patch.js",
+  "bin": {
+    "better-antigravity": "cli.js"
+  },
+  "scripts": {
+    "fix:auto-run": "node fixes/auto-run-fix/patch.js",
+    "fix:auto-run:check": "node fixes/auto-run-fix/patch.js --check",
+    "fix:auto-run:revert": "node fixes/auto-run-fix/patch.js --revert"
+  },
+  "keywords": [
+    "antigravity",
+    "antigravity-ide",
+    "google-antigravity",
+    "fix",
+    "patch",
+    "auto-run",
+    "terminal",
+    "always-proceed",
+    "community"
+  ],
+  "author": "Kanezal",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Kanezal/better-antigravity"
+  },
+  "homepage": "https://github.com/Kanezal/better-antigravity#readme",
+  "bugs": {
+    "url": "https://github.com/Kanezal/better-antigravity/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}