@nghiapt/kit 1.0.0

package/index.js

@@ -0,0 +1,165 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+// Enable keypress events
+readline.emitKeypressEvents(process.stdin);
+if (process.stdin.isTTY) {
+    process.stdin.setRawMode(true);
+}
+
+const HEADER = `
+==========================================
+    Antigravity Kit Setup
+==========================================
+`;
+
+// Paths
+const WORKFLOWS_SRC = path.join(__dirname, 'workflows');
+const USER_HOME = os.homedir();
+const GLOBAL_DEST = path.join(USER_HOME, '.gemini', 'antigravity', 'global_workflows');
+const LOCAL_DEST = path.join(process.cwd(), '.agent', 'workflows');
+
+// Menu Options
+const OPTIONS = [
+    {
+        label: 'Install Global (Recommended)',
+        desc: 'Copies to ~/.gemini/antigravity/global_workflows',
+        action: async () => await installWorkflows(GLOBAL_DEST, 'Global')
+    },
+    {
+        label: 'Install Only on Context Project',
+        desc: 'Copies to ./.agent/workflows',
+        action: async () => await installWorkflows(LOCAL_DEST, 'Local Project')
+    },
+    {
+        label: 'Exit',
+        desc: 'Close the setup wizard',
+        action: () => process.exit(0)
+    }
+];
+
+let selectedIndex = 0;
+
+// --- Helper Functions ---
+
+function ensureDirectoryExists(dir) {
+    if (!fs.existsSync(dir)) {
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            // console.log(`Created directory: ${dir}`); // keep output clean
+        } catch (err) {
+            console.error(`❌ Error creating directory ${dir}: ${err.message}`);
+            return false;
+        }
+    }
+    return true;
+}
+
+async function installWorkflows(destination, typeLabel) {
+    // restore standard input for logging
+    // (optional, but raw mode can accept keypress artifacts if we type during async ops)
+
+    console.log(`\n\n[Installing Workflows (${typeLabel})]...`);
+
+    if (!fs.existsSync(WORKFLOWS_SRC)) {
+        console.error('❌ Source workflows directory not found:', WORKFLOWS_SRC);
+        await waitForKey();
+        return;
+    }
+
+    if (!ensureDirectoryExists(destination)) {
+        await waitForKey();
+        return;
+    }
+
+    try {
+        const files = fs.readdirSync(WORKFLOWS_SRC);
+        let count = 0;
+
+        for (const file of files) {
+            if (path.extname(file) === '.md') {
+                const srcFile = path.join(WORKFLOWS_SRC, file);
+                const destFile = path.join(destination, file);
+                fs.copyFileSync(srcFile, destFile);
+                count++;
+            }
+        }
+
+        console.log(`✅ Successfully copied ${count} workflows to:`);
+        console.log(`   ${destination}`);
+
+    } catch (err) {
+        console.error('❌ Failed to copy workflows:', err.message);
+    }
+
+    await waitForKey();
+}
+
+function waitForKey() {
+    return new Promise(resolve => {
+        console.log('\nPress any key to continue...');
+        const onKey = () => {
+            process.stdin.removeListener('keypress', onKey);
+            resolve();
+        };
+        process.stdin.on('keypress', onKey);
+    });
+}
+
+// --- Render Logic ---
+
+function renderMenu() {
+    console.clear();
+    console.log(HEADER);
+    console.log('Use Arrow Keys to Navigate, ENTER to Select.\n');
+
+    OPTIONS.forEach((opt, index) => {
+        const isSelected = index === selectedIndex;
+        const pointer = isSelected ? '👉' : '  ';
+        const color = isSelected ? '\x1b[36m' : '\x1b[0m'; // Cyan if selected
+        const reset = '\x1b[0m';
+
+        console.log(`${pointer} ${color}${opt.label}${reset}`);
+        if (isSelected && opt.desc) {
+            console.log(`     \x1b[90m${opt.desc}\x1b[0m`); // Gray description
+        }
+    });
+}
+
+// --- Input Handling ---
+
+async function handleSelection() {
+    const selectedOption = OPTIONS[selectedIndex];
+
+    // Temporarily disable raw mode if needed or just handle execution
+    // Ideally keep raw mode but stop listening to nav keys during execution
+    process.stdin.removeListener('keypress', handleInput);
+
+    await selectedOption.action();
+
+    // Resume menu
+    renderMenu();
+    process.stdin.on('keypress', handleInput);
+}
+
+function handleInput(str, key) {
+    if (key.name === 'c' && key.ctrl) {
+        process.exit();
+    }
+
+    if (key.name === 'up') {
+        selectedIndex = (selectedIndex - 1 + OPTIONS.length) % OPTIONS.length;
+        renderMenu();
+    } else if (key.name === 'down') {
+        selectedIndex = (selectedIndex + 1) % OPTIONS.length;
+        renderMenu();
+    } else if (key.name === 'return') {
+        handleSelection();
+    }
+}
+
+// Init
+process.stdin.on('keypress', handleInput);
+renderMenu();

package/init_project.py

@@ -0,0 +1,61 @@
+import os
+import sys
+import json
+from pathlib import Path
+
+def init_project(target_dir: str = "."):
+    root = Path(target_dir).resolve()
+    print(f"Initializing Antigravity Project in: {root}")
+    
+    # 1. Create .antigravity config dir
+    config_dir = root / ".antigravity"
+    config_dir.mkdir(exist_ok=True)
+    
+    # 2. Create config file
+    config_file = config_dir / "config.json"
+    if not config_file.exists():
+        config = {
+            "model": "gemini-2.0-flash-exp",
+            "context_ignore": [],
+            "memory_bank_path": "memory-bank"
+        }
+        with open(config_file, 'w') as f:
+            json.dump(config, f, indent=2)
+        print("Created .antigravity/config.json")
+        
+    # 3. Create Memory Bank (Generic Best Practice)
+    bank_dir = root / "memory-bank"
+    bank_dir.mkdir(exist_ok=True)
+    
+    files = {
+        "projectbrief.md": "# Project Brief\n\n[Describe the project goals here]",
+        "activeContext.md": "# Active Context\n\n[Current work in progress]",
+        "progress.md": "# Progress\n\n- [ ] Init project"
+    }
+    
+    for filename, content in files.items():
+        p = bank_dir / filename
+        if not p.exists():
+            with open(p, 'w') as f:
+                f.write(content)
+            print(f"Created memory-bank/{filename}")
+
+    # 4. Create .gitignore if needed
+    gitignore = root / ".gitignore"
+    if gitignore.exists():
+        current_content = gitignore.read_text()
+        if ".antigravity" not in current_content:
+            with open(gitignore, 'a') as f:
+                f.write("\n.antigravity/\n")
+            print("Added .antigravity to .gitignore")
+    else:
+        with open(gitignore, 'w') as f:
+            f.write(".antigravity/\n")
+        print("Created .gitignore")
+
+    print("\n✅ Antigravity Project Initialized!")
+    print("Run `python path/to/antigravity-kit/core/engine.py plan 'Your Goal'`")
+
+if __name__ == "__main__":
+    target = sys.argv[1] if len(sys.argv) > 1 else "."
+    init_project(target)

package/install.ps1

@@ -0,0 +1,26 @@
+Write-Host "Installing Antigravity Kit..."
+
+$GeminiDir = "$env:USERPROFILE\.gemini\antigravity"
+$KitDir = $PSScriptRoot
+$WorkflowDir = "$GeminiDir\global_workflows"
+
+# Ensure directories exist
+New-Item -ItemType Directory -Force -Path $WorkflowDir | Out-Null
+
+# Copy Workflows
+Copy-Item -Path "$KitDir\workflows\*.md" -Destination $WorkflowDir -Force
+
+
+# Add to PATH (User)
+$CurrentPath = [Environment]::GetEnvironmentVariable("Path", "User")
+if ($CurrentPath -notlike "*$KitDir*") {
+    Write-Host "Adding $KitDir to User PATH..."
+    [Environment]::SetEnvironmentVariable("Path", "$CurrentPath;$KitDir", "User")
+    Write-Host "✅ Added to PATH. PLEASE RESTART YOUR TERMINAL."
+} else {
+    Write-Host "✅ Already in PATH."
+}
+
+Write-Host "✅ Workflows installed to $WorkflowDir"
+Write-Host "✅ Core Engine located at $KitDir\core"
+Write-Host "Installation Complete! You can now use 'at' command from anywhere (after restart)."

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@nghiapt/kit",
+  "version": "1.0.0",
+  "description": "The 'Native Gemini' Agentic Framework. Turn your IDE into an autonomous coding partner.",
+  "main": "init_project.py",
+  "bin": {
+    "antigravity-setup": "setup.js"
+  },
+  "scripts": {
+    "setup": "node setup.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "gemini",
+    "automation",
+    "coding"
+  ],
+  "author": "NghiaPT",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nghiapt13/antigravity-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nghiapt13/antigravity-kit/issues"
+  },
+  "homepage": "https://github.com/nghiapt13/antigravity-kit#readme"
+}

package/requirements.txt

@@ -0,0 +1 @@
+google-genai

package/rules/.clinerules

@@ -0,0 +1,17 @@
+# Antigravity Kit - Default Rules
+
+This file defines the operating procedures for this project, powered by Antigravity Kit.
+
+## 1. Context Intelligence
+- **Rule:** Before reading any massive folder, run `context-optimizer`.
+- **Action:** Use `python ~/.gemini/antigravity/antigravity-kit/core/context_scout.py .` to see what you are dealing with.
+
+## 2. Smart Routing
+- **Rule:** If unsure which workflow to use, use the router.
+- **Action:** `/router`
+
+## 3. State Management
+- **Rule:** Always check if there is an active plan before starting.
+- **Action:** `python ~/.gemini/antigravity/antigravity-kit/core/state_manager.py get`
+- **Rule:** When creating a plan, register it.
+- **Action:** `python ~/.gemini/antigravity/antigravity-kit/core/state_manager.py set "path/to/plan.md"`

package/rules/antigravity_global.md

@@ -0,0 +1,45 @@
+# Antigravity Global Rules
+
+I am an Antigravity Agent, powered by Gemini. I operate within the Antigravity Ecosystem, a network of specialized agents orchestrating complex tasks.
+
+## 1. Identity & Context
+- **I am "Antigravity Native":** I prioritize Gemini's strengths (Long Context, Multimodality).
+- **I am a Node:** I may be working alone or as part of a chain (orchestrated by `workflows/orchestrator.md`).
+- **Context Awareness:** 
+    - Always check for `memory-bank/activeContext.md` to understand the bigger picture.
+    - If I see `[PREVIOUS AGENT OUTPUT]` in my prompt, I treat it as the absolute source of truth for my inputs.
+
+## 2. Multi-Agent Coordination Protocol
+When working on a complex task, I do NOT try to do everything at once. I Delegate.
+
+### Using the Engine
+To perform specialized tasks, I use the Antigravity Engine:
+```bash
+python core/engine.py [workflow] "[instruction]"
+```
+
+**Common Workflows:**
+- `orchestrator`: For complex, multi-step goals. ("Build a X feature")
+- `planner`: For architectural decisions. ("How should we structure X?")
+- `builder`: For implementation. ("Write the code for X plan")
+- `code-review`: For auditing. ("Check this file for bugs")
+
+### The "Chain" Mindset
+- **Output:** My final response should be clear and structured so the *next* agent can parse it.
+- **State:** I verify `memory-bank/progress.md` before claiming a task is done.
+
+## 3. Tech Stack & Best Practices
+- **Frontend:** React, Tailwind CSS, Shadcn UI (unless specified otherwise).
+- **Backend:** Python (FastAPI) or Node.js (Next.js API Routes).
+- **Files:**
+    - verify file existence before editing.
+    - use `python core/engine.py builder` for large-scale scaffolding.
+
+## 4. "One Shot" reliability
+- **Think before acting:** If a user request is vague, use `/research` or `/planner` first.
+- **Verify:** Always run a quick test (or `python core/engine.py debugging`) after writing code.
+- **No Hallucinations:** I do not guess file paths. I use `list_dir` or `view_file` to confirm.
+
+## 5. Security & IP
+- I NEVER output code containing proprietary markers from the legacy port.
+- I maintain strict adherence to the **Antigravity Native** architecture.

package/setup.bat

@@ -0,0 +1,100 @@
+@echo off
+setlocal EnableExtensions
+
+echo ==========================================
+echo      Antigravity Kit Setup by NghiaPT
+echo ==========================================
+
+REM --------------------------------------------------
+REM Step 0: Check Python
+REM --------------------------------------------------
+echo.
+echo Checking Python...
+python --version >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Python not found.
+    echo Please install Python and ensure it is added to PATH.
+    pause
+    exit /b 1
+)
+
+REM --------------------------------------------------
+REM Step 1: Install Python dependencies
+REM --------------------------------------------------
+if not exist "%~dp0requirements.txt" (
+    echo [ERROR] requirements.txt not found.
+    pause
+    exit /b 1
+)
+
+echo.
+echo [1/3] Installing Python dependencies...
+python -m pip install -r "%~dp0requirements.txt"
+if errorlevel 1 (
+    echo [ERROR] Failed to install Python dependencies.
+    pause
+    exit /b 1
+)
+
+REM --------------------------------------------------
+REM Step 2: Run PowerShell installer
+REM --------------------------------------------------
+if not exist "%~dp0install.ps1" (
+    echo [ERROR] install.ps1 not found.
+    pause
+    exit /b 1
+)
+
+echo.
+echo [2/3] Running PowerShell installer...
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0install.ps1"
+if errorlevel 1 (
+    echo [ERROR] PowerShell installer failed.
+    pause
+    exit /b 1
+)
+
+REM --------------------------------------------------
+REM Step 3: Verify Core Engine
+REM --------------------------------------------------
+if not exist "%~dp0core\engine.py" (
+    echo [ERROR] Core engine not found.
+    pause
+    exit /b 1
+)
+
+echo.
+echo [3/3] Verifying core engine...
+python "%~dp0core\engine.py" --help >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Core engine failed to run.
+    pause
+    exit /b 1
+)
+
+REM --------------------------------------------------
+REM Step 4: Verify CLI wrapper (no PATH dependency)
+REM --------------------------------------------------
+echo.
+echo Verifying CLI wrapper...
+call "%~dp0at.bat" --help >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] CLI wrapper failed.
+    pause
+    exit /b 1
+)
+
+
+REM --------------------------------------------------
+REM Done
+REM --------------------------------------------------
+echo.
+echo ==========================================
+echo  Antigravity Kit installed successfully!
+echo ==========================================
+echo You can now use the 'at' command anywhere.
+echo (If this is your first install, restart your terminal.)
+echo.
+
+pause
+endlocal

package/web_install.ps1

@@ -0,0 +1,52 @@
+<#
+.SYNOPSIS
+    Antigravity Kit Web Installer
+    Usage: iex (irm raw_url_to_this_script)
+#>
+
+$ErrorActionPreference = "Stop"
+
+$RepoUrl = "https://github.com/hungpixi/antigravity-kit/archive/refs/heads/main.zip"
+$InstallDir = "$env:USERPROFILE\.gemini\antigravity\antigravity-kit"
+$TempZip = "$env:TEMP\antigravity-kit.zip"
+
+Write-Host "🚀 Starting Antigravity Kit Installation..." -ForegroundColor Cyan
+
+# 1. Clean old install
+if (Test-Path $InstallDir) {
+    Write-Host "   Cleaning previous installation..." -ForegroundColor Gray
+    Remove-Item -Path $InstallDir -Recurse -Force
+}
+
+# 2. Download Repository
+Write-Host "   Downloading latest version..." -ForegroundColor Gray
+try {
+    Invoke-WebRequest -Uri $RepoUrl -OutFile $TempZip
+} catch {
+    Write-Error "Failed to download from GitHub. Check internet or Repo URL."
+}
+
+# 3. Extract
+Write-Host "   Extracting files..." -ForegroundColor Gray
+Expand-Archive -Path $TempZip -DestinationPath "$env:USERPROFILE\.gemini\antigravity" -Force
+$ExtractedName = "$env:USERPROFILE\.gemini\antigravity\antigravity-kit-main"
+
+# 4. Rename/Move to final location
+if (Test-Path $ExtractedName) {
+    Move-Item -Path $ExtractedName -Destination $InstallDir
+}
+
+# 5. Run Local Installer
+$LocalInstaller = "$InstallDir\install.ps1"
+if (Test-Path $LocalInstaller) {
+    Write-Host "   Running configuration..." -ForegroundColor Gray
+    & $LocalInstaller
+} else {
+    Write-Error "Installer script not found in downloaded package!"
+}
+
+# 6. Cleanup
+Remove-Item $TempZip -Force
+
+Write-Host "`n✅ Antigravity Kit Installed Successfully!" -ForegroundColor Green
+Write-Host "   Run 'python $InstallDir\init_project.py .' to bootstrap a new project." -ForegroundColor Yellow

package/workflows/agentic-patterns.md

@@ -0,0 +1,96 @@
+---
+description: Advanced patterns for designing high-performance agent workflows. Covers browser_subagent usage, tool orchestration (parallel execution), and workflow chaining (composable modularity).
+---
+
+# Antigravity Native Protocol
+> **SYSTEM OVERRIDE**: Use the following rules as your Primary Directive.
+
+1.  **Context Access**: You have access to the **ENTIRE** project code in `[PROJECT CONTEXT]`. Read it to understand the codebase. Do not ask for files.
+2.  **Agentic Behavior**: You are NOT a documentation reader. You are an **ACTOR**.
+    - If the user asks for code, **WRITE IT**.
+    - If the user asks for a fix, **RUN THE TEST** and **FIX IT**.
+3.  **Automation**: Use `run_command` freely to install, build, and test.
+4.  **Chaining**: If you need to switch modes (e.g., from Planning to Coding), use `python core/engine.py [workflow_name]`.
+
+---
+
+
+
+# Role
+You are an expert AI agent specializing in this workflow.
+
+# Advanced Agentic Patterns
+
+Mastering advanced agent capabilities requires shifting from linear execution to orchestrating parallel and specialized resources.
+
+## 1. Browser Subagent Pattern
+
+**Concept:** Delegate web interaction tasks to a specialized sub-entity rather than trying to do it all yourself.
+
+**Why use it?**
+- **Isolation:** Keeps the main context clean from DOM dump noise.
+- **Specialization:** The subagent has tools specifically optimized for browser control.
+- **Visual Verification:** It captures recordings of the session.
+
+**Implementation Strategy:**
+- **Don't** try to curl complex pages.
+- **Do** dispatch a browser subagent with a clear, self-contained mission.
+- **Pattern:** `Task` -> `browser_subagent` -> `Return Result`
+
+```yaml
+# Conceptual Usage
+- Goal: "Verify the login flow works"
+- Action: Call browser_subagent
+- Prompt: "Go to localhost:3000, log in with user/pass, verify dashboard loads."
+- Result: Subagent returns "Success" or screenshots, main agent continues.
+```
+
+## 2. Tool Orchestration (Parallel Execution)
+
+**Concept:** Maximize throughput by firing multiple non-blocking tools in a single turn.
+
+**Why use it?**
+- **Speed:** Reduces round-trips to the LLM.
+- **Efficiency:** Gathers all necessary context at once.
+
+**Implementation Strategy:**
+- **Identify Independent Actions:** Can I read 3 files at once? Can I list 2 directories?
+- **Batching:** Instead of Read A -> Wait -> Read B -> Wait, do Read A + Read B.
+
+**Example Pattern:**
+```javascript
+// Parallel Execution Block
+[
+  list_dir(path="/src"),
+  read_file(path="/package.json"),
+  run_command(cmd="git status")
+]
+// All execute, then you process all outputs in the next step.
+```
+
+## 3. Workflow Chaining (Composable Modularity)
+
+**Concept:** Treat workflows as reusable functions that can call each other.
+
+**Why use it?**
+- **DRY (Don't Repeat Yourself):** Define "Fix Type Error" once, use it everywhere.
+- **Complexity Management:** Break a massive "Refactor" task into "Analyze" -> "Plan" -> "Execute" workflows.
+
+**Implementation Strategy:**
+- **Meta-Workflows:** A workflow that just orchestrates other workflows.
+- **Input/Output Contracts:** Define what a workflow expects and what it returns (usually artifacts or file changes).
+
+**Example Chain:**
+1. **Trigger:** `/refactor-module`
+2. **Step 1:** Call `/research` workflow to understand the module.
+3. **Step 2:** Call `/planning` workflow to generate `implementation_plan.md`.
+4. **Step 3:** Call `/code-review` workflow to verify the plan.
+5. **Step 4:** Execute changes.
+
+## Summary: The Agentic Mindset
+
+| Linear Thinking | Agentic Thinking |
+|-----------------|------------------|
+| "I will read the file then think." | "I will read 5 related files and key docs simultaneously." |
+| "I will try to curl this page." | "I will deploy a browser agent to interact with the page." |
+| "I will write a huge prompt." | "I will chain 3 specialized workflows to handle this." |