# futureppo/antigravity_bypass architecture

> Architecture diagram of the GitHub repository futureppo/antigravity_bypass, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/futureppo/antigravity_bypass
- Repository: https://github.com/futureppo/antigravity_bypass

## Overview

Antigravity Bypass is a Go command-line utility for checking, patching, and restoring local MCP tool-count limits in the Antigravity IDE, desktop app, and CLI. The principal workflow resolves a selected installation, inspects its version-specific frontend and/or backend structure, plans safe edits, then applies them with backups; restore reverses those edits. The graph separates client discovery, compatibility inspection, patch analysis, and file mutation. Some discovery and matching internals are only partly shown, so unverified links are omitted.

Main entry points: [`main.go`](https://github.com/futureppo/antigravity_bypass/blob/main/main.go) (CLI workflow), [`patch_files.go`](https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go) (IDE inspection), [`desktop.go`](https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go) (Desktop inspection), [`cli.go`](https://github.com/futureppo/antigravity_bypass/blob/main/cli.go) (CLI inspection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command and discovery"]
  node_command["CLI workflow<br/>[main.go]"]
  node_client_detect["Client detection<br/>[desktop.go]"]
  node_ide_discovery["IDE discovery<br/>[main.go]"]
  node_platform_paths["Platform paths<br/>[platform_other.go]"]
  node_cli_discovery["CLI discovery<br/>[cli.go]"]
end

subgraph group_inspect["Client inspection"]
  node_ide_inspection["IDE inspection<br/>[patch_files.go]"]
  node_desktop_inspection["Desktop inspection<br/>[desktop.go]"]
  node_cli_inspection["CLI inspection<br/>[cli.go]"]
  node_asar_reader["ASAR validation<br/>[desktop.go]"]
end

subgraph group_analysis["Patch analysis"]
  node_frontend_analysis["Frontend matching<br/>[patch_frontend.go]"]
  node_binary_analysis["Backend matching<br/>[patch_binary.go]"]
end

subgraph group_mutation["File mutation"]
  node_patch_plan["Patch planning<br/>[patch_files.go]"]
  node_apply["Apply with backups<br/>[patch_files.go]"]
  node_restore["Restore backups<br/>[patch_files.go]"]
end

node_user(("Operator"))
node_local_install["Local installation files"]

node_user -->|"selects action"| node_command
node_command -->|"resolves client"| node_client_detect
node_client_detect -->|"checks IDE"| node_ide_discovery
node_client_detect -->|"checks CLI"| node_cli_discovery
node_ide_discovery -->|"gets candidates"| node_platform_paths
node_command -->|"inspects IDE"| node_ide_inspection
node_command -->|"inspects desktop"| node_desktop_inspection
node_command -->|"inspects CLI"| node_cli_inspection
node_desktop_inspection -->|"validates archive"| node_asar_reader
node_ide_inspection -->|"plans frontend"| node_frontend_analysis
node_ide_inspection -->|"plans backend"| node_binary_analysis
node_desktop_inspection -->|"plans backend"| node_binary_analysis
node_cli_inspection -->|"plans backend"| node_binary_analysis
node_ide_inspection -->|"assembles edits"| node_patch_plan
node_desktop_inspection -->|"assembles edits"| node_patch_plan
node_cli_inspection -->|"assembles edits"| node_patch_plan
node_command -->|"applies patch"| node_apply
node_apply -->|"backs up and writes"| node_local_install
node_command -->|"restores files"| node_restore
node_restore -->|"reads backups"| node_local_install

click node_command "https://github.com/futureppo/antigravity_bypass/blob/main/main.go"
click node_client_detect "https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go"
click node_ide_discovery "https://github.com/futureppo/antigravity_bypass/blob/main/main.go"
click node_platform_paths "https://github.com/futureppo/antigravity_bypass/blob/main/platform_other.go"
click node_cli_discovery "https://github.com/futureppo/antigravity_bypass/blob/main/cli.go"
click node_ide_inspection "https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go"
click node_desktop_inspection "https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go"
click node_cli_inspection "https://github.com/futureppo/antigravity_bypass/blob/main/cli.go"
click node_asar_reader "https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go"
click node_frontend_analysis "https://github.com/futureppo/antigravity_bypass/blob/main/patch_frontend.go"
click node_binary_analysis "https://github.com/futureppo/antigravity_bypass/blob/main/patch_binary.go"
click node_patch_plan "https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go"
click node_apply "https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go"
click node_restore "https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_command,node_client_detect,node_ide_discovery,node_platform_paths,node_cli_discovery toneBlue
class node_ide_inspection,node_desktop_inspection,node_cli_inspection,node_asar_reader toneAmber
class node_frontend_analysis,node_binary_analysis toneMint
class node_patch_plan,node_apply,node_restore toneRose
class node_user,node_local_install toneIndigo
```

## Components

### Command and discovery

- [CLI workflow](https://github.com/futureppo/antigravity_bypass/blob/main/main.go): `main.go`
- [Client detection](https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go): `desktop.go`
- [IDE discovery](https://github.com/futureppo/antigravity_bypass/blob/main/main.go): `main.go`
- [Platform paths](https://github.com/futureppo/antigravity_bypass/blob/main/platform_other.go): `platform_other.go`
- [CLI discovery](https://github.com/futureppo/antigravity_bypass/blob/main/cli.go): `cli.go`

### Client inspection

- [IDE inspection](https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go): `patch_files.go`
- [Desktop inspection](https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go): `desktop.go`
- [CLI inspection](https://github.com/futureppo/antigravity_bypass/blob/main/cli.go): `cli.go`
- [ASAR validation](https://github.com/futureppo/antigravity_bypass/blob/main/desktop.go): `desktop.go`

### Patch analysis

- [Frontend matching](https://github.com/futureppo/antigravity_bypass/blob/main/patch_frontend.go): `patch_frontend.go`
- [Backend matching](https://github.com/futureppo/antigravity_bypass/blob/main/patch_binary.go): `patch_binary.go`

### File mutation

- [Patch planning](https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go): `patch_files.go`
- [Apply with backups](https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go): `patch_files.go`
- [Restore backups](https://github.com/futureppo/antigravity_bypass/blob/main/patch_files.go): `patch_files.go`

### Other components

- **Operator**
- **Local installation files**

## Connections

- Operator → CLI workflow: selects action (evidence: `README.md`)
- CLI workflow → Client detection: resolves client (evidence: `main.go`)
- Client detection → IDE discovery: checks IDE (evidence: `desktop.go`)
- Client detection → CLI discovery: checks CLI (evidence: `desktop.go`)
- IDE discovery → Platform paths: gets candidates (evidence: `main.go`)
- CLI workflow → IDE inspection: inspects IDE (evidence: `main.go`)
- CLI workflow → Desktop inspection: inspects desktop (evidence: `main.go`)
- CLI workflow → CLI inspection: inspects CLI (evidence: `main.go`)
- Desktop inspection → ASAR validation: validates archive (evidence: `desktop.go`)
- IDE inspection → Frontend matching: plans frontend (evidence: `patch_files.go`)
- IDE inspection → Backend matching: plans backend (evidence: `patch_files.go`)
- Desktop inspection → Backend matching: plans backend (evidence: `desktop.go`)
- CLI inspection → Backend matching: plans backend (evidence: `cli.go`)
- IDE inspection → Patch planning: assembles edits (evidence: `patch_files.go`)
- Desktop inspection → Patch planning: assembles edits (evidence: `desktop.go`)
- CLI inspection → Patch planning: assembles edits (evidence: `cli.go`)
- CLI workflow → Apply with backups: applies patch (evidence: `main.go`)
- Apply with backups → Local installation files: backs up and writes (evidence: `patch_files.go`)
- CLI workflow → Restore backups: restores files (evidence: `main.go`)
- Restore backups → Local installation files: reads backups (evidence: `patch_files.go`)
