flowchart TD
    subgraph Clients["AI Clients & CLI"]
        AGY["Antigravity / Gemini IDE"]
        CLD["Claude Desktop / Cursor"]
        CLI["ask-argon CLI Tool"]
    end

    subgraph MCP["Gemini Argon Bridge"]
        STDIO["mcp-server.js (Stdio JSON-RPC)"]
        ENGINE["ArgonEngine (engine.js)"]
        IPCLOCK["IPC File Lock & Mutex"]
        LRU["LRU Tab Manager & Session Registry"]
    end

    subgraph Browser["Google Chrome CDP"]
        CHROME["Isolated Chromium Profile"]
        CDP["Chrome DevTools Protocol (WebSocket)"]
        STUDIO["Google AI Studio Web UI\n(Gemini 4 Argon Session)"]
    end

    AGY <-->|Stdio MCP| STDIO
    CLD <-->|Stdio MCP| STDIO
    CLI <-->|Direct Engine| ENGINE
    STDIO <--> ENGINE
    ENGINE <--> IPCLOCK
    ENGINE <--> LRU
    ENGINE <-->|Puppeteer CDP| CDP
    CDP <--> CHROME
    CHROME <--> STUDIO

# Clone the repository
git clone https://github.com/Aldiyuar/gemini-argon-bridge.git
cd gemini-argon-bridge

# Install dependencies
npm install

# Windows (via batch script)
login.bat

# Or directly via Node.js (Windows / Linux / macOS)
node login.js

{
  "mcpServers": {
    "gemini-argon": {
      "command": "node",
      "args": [
        "C:\\path\\to\\gemini-argon-bridge\\mcp-server.js"
      ]
    }
  }
}

{
  "mcpServers": {
    "gemini-argon": {
      "command": "node",
      "args": [
        "/path/to/gemini-argon-bridge/mcp-server.js"
      ]
    }
  }
}

{
  "mcpServers": {
    "gemini-argon": {
      "command": "node",
      "args": [
        "/path/to/gemini-argon-bridge/mcp-server.js"
      ]
    }
  }
}

[ARGON_THOUGHTS]
1. Analyzing attached state_machine.ts...
2. Detected race condition between event queue flush and mutex release at line 142.
3. Solution requires double-checked locking with atomic CAS.

[ARGON_RESPONSE]
### Root Cause Analysis
The race condition stems from...

```typescript
// Verified minimal diff

### 2. `argon_status`
Returns real-time health and diagnostics of the bridge:
- Browser running status & CDP WebSocket URL
- IPC mutex state (`isLocked`)
- Active sessions and attached tab count
- Persistent Google Drive prompt registry

### 3. `reset_argon`
Closes browser tabs and frees memory:
- With `session_id`: Closes the specific tab and unregisters the session.
- Without arguments: Closes all tabs and cleans up temporary scratch files.

---

## 💻 CLI Usage

The package includes a standalone CLI (`ask-argon-cli.js`) that shares the browser instance with MCP without conflicts:

```bash
# Direct single prompt
node ask-argon-cli.js "Explain the difference between optimistic and pessimistic locking"

# Attach local files for deep review
node ask-argon-cli.js "Audit these files for security flaws" --file src/auth.ts --file src/jwt.ts

# Multi-turn session continuation
node ask-argon-cli.js "Fix the race condition you identified" --session bug-hunt-1

# Save output to markdown file
node ask-argon-cli.js "Design a high-throughput event bus" --output architecture.md

npm test

gemini-argon-bridge/
├── package.json               # Node.js manifest with bin shortcuts & dependencies
├── engine.js                  # Core ArgonEngine (CDP browser lifecycle, DOM injection, IPC)
├── mcp-server.js              # Model Context Protocol stdio transport server
├── ask-argon-cli.js           # Production CLI companion tool
├── login.js                   # Interactive profile setup & Google authentication
├── login.bat                  # One-click Windows setup launcher
├── mcp_config.example.json    # Example configuration templates for IDEs
├── skills/
│   └── argon-reasoning/
│       └── SKILL.md          # Antigravity skill for automated deep reasoning routing
├── tests/
│   └── integration.test.js    # Concurrency and end-to-end verification test suite
├── LICENSE                    # MIT License
└── README.md                  # Documentation and API reference