eligibility-antigravity-patcher

KO | EN

gitlite — search

#ai #typescript #golang #android #deep-learning #linux #java #windows #awesome #cli #awesome-list #vue #ios #openai

eligibility-antigravity-patcher

(★ 22)

Cross-platform environment manager for Antigravity CLI, Manager & IDE — eligibility patching on Windows, Linux and macOS (x64/ARM64), plus multi-account switching on Windows.

eligibility-antigravity-patcher Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">🚀 agy-manager</h1>

 Легковесный и мощный менеджер окружения Antigravity (обход региональных ограничений на Windows, Linux и macOS — x64 и arm64; управление несколькими аккаунтами на Windows)

Русский | <a href="README.en.md">English</a>

---

## 📌 Содержание

- [✨ Возможности](#features)
- [🚀 Быстрый старт](#quick-start)
- [🔓 Патчинг региональных ограничений](#bypass)
- [👥 Менеджер профилей авторизации](#accounts)
- [🔍 Детали реализации (под капотом)](#details)
- [⚠️ Важные примечания](#warnings)
- [📄 Лицензия](#license)

---

## <a id="features"></a>✨ Возможности

`agy-manager` объединяет в себе два ключевых инструмента для удобной разработки в экосистеме Antigravity:

- 🔓 **Обход региональных ограничений:** Отключение локальных заглушек доступности ("not available in your location") во всех трех ключевых приложениях (CLI, Manager, IDE).
- 👥 **Менеджер аккаунтов:** Безопасное сохранение и быстрое переключение между несколькими профилями авторизации без необходимости повторного входа через браузер.
- 🎨 **Интерактивный TUI:** Удобное консольное меню для управления патчами и аккаунтами на базе библиотек `rich` и `questionary`.
- ⚡ **Ядро без зависимостей:** Все основные консольные команды работают на стандартной библиотеке Python без необходимости установки сторонних пакетов.
- 🛡️ **Безопасность и откат:** Патчер ищет ровно одну исходную или уже изменённую сигнатуру только в исполняемых секциях PE/ELF/Mach-O, проверяет резервную копию и результат каждой записи и автоматически откатывается при ошибке. Оригинальные файлы сохраняются как `*.agybak`.
- ⚙️ **Умный автопоиск:** Автоматическое сканирование реестра Windows, системного PATH, переменных окружения и путей Scoop, стандартных путей установки в Linux (`/opt`, `~/.local/share` и др.), а также `.app`-бандлов в macOS (`/Applications`, `~/Applications`) для динамического обнаружения установленных приложений.
- 🧬 **Устойчивость к обновлениям и архитектурам:** Поиск уникальных сигнатур инструкций через регулярные выражения вместо привязки к статическим смещениям, плюс отдельные сигнатуры под каждую архитектуру (x86-64 и aarch64) — один и тот же патч работает и на Intel-, и на ARM-сборках.

---

## <a id="quick-start"></a>🚀 Быстрый старт

### 1. Склонируйте репозиторий и перейдите в каталог

```bash
git clone https://github.com/QNIX-Dev/eligibility-antigravity-patcher.git
cd eligibility-antigravity-patcher
```

### 2. Выберите режим работы

#### Вариант А: Интерактивный TUI (рекомендуется)

Запуск полноценного интерактивного интерфейса с таблицей статусов для управления как патчами, так и аккаунтами:

1. **Установите зависимости:**
   ```bash
   pip install -r requirements.txt
   ```
2. **Запустите agy-manager:**
   ```bash
   python manager.py
   ```

*(Интерфейс поддерживает навигацию стрелочками, выбор пробелом и подтверждение по Enter).*

---

#### Вариант Б: Консольный CLI (без зависимостей)

Работает полностью на стандартной библиотеке Python (установка сторонних пакетов не требуется). Позволяет автоматизировать действия и управлять окружением напрямую из терминала.

> [!TIP]
> Если ваше приложение установлено в нестандартную директорию, вы можете вручную указать путь к нему:
> ```bash
> python manager.py --path-cli "D:\CustomTools\agy.exe" patch cli
> ```

---

## <a id="bypass"></a>🔓 Патчинг региональных ограничений

Патчер модифицирует локальные проверки доступности, позволяя приложениям функционировать в регионах с ограничениями.

> [!NOTE]
> Эти экраны — чисто локальное ограничение на стороне клиента. После их обхода модели и функции работают в штатном режиме. Этот инструмент **не** обходит серверную авторизацию и не открывает доступ к платным функциям, он лишь отключает локальную заглушку региональных ограничений.

### Поддерживаемые приложения

> [!NOTE]
> **Поддержка платформ:** Все три патча (`cli`, `manager`, `ide`) кросс-платформенные (Windows, Linux, macOS) и покрывают обе архитектуры — **x86-64 и arm64**. Патч `manager` содержит две сигнатуры машинного кода и автоматически выбирает нужную: x64-сигнатура покрывает Windows (в том числе Windows-on-ARM, где бэкенд поставляется в x64-версии и работает через эмуляцию), Linux x64 и Intel-macOS; отдельная aarch64-сигнатура покрывает Linux arm64 и macOS на Apple Silicon. Патч `ide` — это JavaScript, поэтому от архитектуры не зависит в принципе.
>
> В Linux автопоиск сканирует стандартные префиксы установки (`/opt`, `/usr/share`, `/usr/lib`, `~/.local/share`, `~/.local/bin`, каталог лаунчера `antigravity` и `antigravity-ide` из `PATH`). В macOS сканируются `.app`-бандлы в `/Applications` и `~/Applications` (бинарники лежат внутри `Contents/Resources/`). Для нестандартных путей укажите их вручную с помощью флагов командной строки (например, `--path-cli`). Перед патчем закройте приложения, чтобы избежать блокировок файлов. Управление аккаунтами (`accounts`) на данный момент поддерживается только в Windows.

---

## <a id="accounts"></a>👥 Менеджер профилей авторизации

Позволяет сохранять текущую сессию авторизации Antigravity под уникальным именем (профилем) и переключаться между ними в офлайне без повторного входа в браузере.

### Области управления
Управление сессиями разделено на две независимые области:
1. **CLI + Manager** (используют общий токен доступа в Windows Credential Manager).
2. **IDE** (использует собственные ключи авторизации в SQLite базе данных `state.vscdb` внутри VS Code).

Это разделение позволяет независимо переключать профили для разных инструментов и избегает конфликтов блокировки файлов.

### Использование в интерактивном меню:
1. Выберите пункт **Manage accounts** в главном меню `python manager.py`.
2. Выберите целевую область: **CLI + Manager** или **IDE**.
3. Доступны операции сохранения текущей сессии, переключения на сохраненный профиль, удаления профиля или выхода.

### Использование в командной строке:
Формат команды: `python manager.py accounts <cli-manager|ide> <действие> [имя]`

---

## <a id="details"></a>🔍 Детали реализации (под капотом)

<details>
<summary>🛠️ Патч CLI (`agy.exe` Go-бинарник)</summary>

CLI выводит при запуске косметическую секцию «Eligibility Check». Решение о её показе принимается в функции `handleAuthResult`, которая читает поле `hasValidAuth` (байт по смещению `+8`) из AuthResult, пришедшего с сервера.

1. **Сборки x64:** Патчер ищет уникальную сигнатуру проверки гейта: `test rax,rax` → `je` (eligible) → `cmp byte ptr [rax+8],0` → `jne` (eligible) → `call failure_builder` → сохранение `rax`, `rbx` и `rcx` в `[rsp+0x80]`, `[rsp+0x50]` и `[rsp+0x70]`.
2. При нулевом `hasValidAuth` выполнение без патча проваливается дальше и печатает ошибку. Патч заменяет `cmp byte ptr [rax+8],0` на `test rax,rax` (+`NOP`): так как `rax` здесь гарантированно не равен нулю, переход `jne` всегда уводит выполнение в ветку «eligible».
3. Это нейтрализует предупреждение как при первом входе, так и при последующих запусках CLI, при этом все функции продолжают работать в штатном режиме.
4. **Сборки arm64** (Windows, Linux и macOS) содержат внешнюю проверку: `cbnz x1,error` → `cbz x0,eligible` → `ldrb w1,[x0,#8]` → `tbnz w1,#0,eligible` → `bl failure_builder` → сохранение `x0`, `x1` и `x2` в `[sp,#0x90]`, `[sp,#0x60]` и `[sp,#0x80]`. Патч заменяет загрузку флага на `mov w1,#1`, поэтому существующий `tbnz` всегда выбирает ветку «eligible». Класс `MultiGate` автоматически выбирает x64- или arm64-сигнатуру.
</details>

<details>
<summary>📦 Патч Manager (`language_server.exe` Go-бэкенд)</summary>

Менеджер общается с локальным Go-бэкендом `language_server.exe` по протоколу connect-rpc. Вердикт `hasValidAuth` (байт по смещению `+8` в AuthResult) определяется в единственном корневом месте — функции `authclient.(*PersonalAuthValidator).Validate`.

1. **Сборки x64:** Патчер ищет в валидаторе сигнатуру проверки: `cmp byte ptr [rax+8], 0` → `je` (уводит выполнение в обход привязки токена).
2. Проверка вместе с переходом перезаписывается на `mov byte ptr [rax+8], 1` + `NOP`: флаг принудительно выставляется в `true`, а нейтрализованный `je` гарантирует, что выполнение всегда идёт в ветку привязки и сохранения токена.
3. Именно результат этого валидатора возвращает `GetAuthStatus` и на него же опирается функция логина, поэтому одного патча достаточно для всех сценариев — и первого входа, и последующих перезапусков. Токен сохраняется на диске, а экран ошибки не отображается.
4. **Сборки arm64** (Linux arm64, macOS на Apple Silicon) содержат идентичную логику в коде AArch64: `ldrb w3,[x0,#8]` → `tbz w3,#0,skip` → одна или две инструкции подготовки → `stp x3,x4,[x0,#0x60]` (привязка токена по смещению `+0x60`). Патч переписывает `ldrb;tbz` в `mov w3,#1 ; strb w3,[x0,#8]` — принудительно выставляет флаг в `true` и убирает переход, так что токен привязывается всегда. Класс `MultiGate` автоматически выбирает x64- или arm64-сигнатуру.
</details>

1. Патчер находит файл `resources/app/out/main.js` и с помощью регулярного выражения ищет минифицированный шаблон авторизации: `resetIsTierGCPTos,this\.[A-Za-z_\$0-9]+\.isGoogleInternal`.
2. Заменяет его на `resetIsTierGCPTos(),true`, что принудительно включает флаг внутреннего сотрудника Google.
3. Очищает кэши байт-кода VS Code (`CachedData` и `Code Cache/js`) для моментального применения изменений.
</details>

<details>
<summary>👥 Менеджер аккаунтов (хранение и переключение сессий)</summary>

Механизм переключения аккаунтов работает полностью локально и офлайн, не обращаясь к серверам авторизации (штатный выход из приложения инвалидирует токен на стороне сервера).

1. **Разделение хранилищ:** Токены CLI/Manager берутся из Windows Credential Manager (`gemini:antigravity`). Токены IDE вычитываются из SQLite базы данных VS Code `state.vscdb` (ключи `antigravityUnifiedStateSync.*`).
2. **Безопасное хранение:** При сохранении профиля данные шифруются/кодируются и записываются обратно в Credential Manager под уникальным именем с префиксом `agy-manager:account:cli-manager:<name>` или `agy-manager:account:ide:<name>`.
3. **Обход лимитов размера:** generic-записи в Credential Manager ограничены размером в 2560 байт, в то время как JSON-сессия IDE может превышать 8 КБ. Профили IDE автоматически шардируются на части по 2000 байт и сохраняются в виде пронумерованных записей (`.../<index>`).
4. **Синхронизация и защита от перезаписи:** Перед применением нового профиля текущий активный профиль автоматически синхронизируется, чтобы сохранить любые ротированные ключи сессии.
</details>

---

## <a id="warnings"></a>⚠️ Важные примечания

- **Совместимость версий:** Работоспособность патчера гарантируется только на **актуальных** версиях приложений. Он завязан на бинарные сигнатуры конкретных сборок, поэтому на устаревших версиях может не находить нужные инструкции и просто ничего не делать — статус отобразится как `unknown`, а файл останется нетронутым (безопасный отказ). В этом случае обновите приложение до последней версии.
- **Сброс при обновлениях:** При обновлении приложений пропатченные файлы будут перезаписаны оригинальными. Достаточно повторно запустить `python manager.py patch`.
- **Блокировка файлов и процессов:** Перед патчингом или переключением аккаунтов обязательно закройте все целевые приложения соответствующей области (CLI, Manager или IDE). В противном случае операционная система заблокирует доступ к файлам, либо запущенное приложение перезапишет восстановленные токены из своего кэша в оперативной памяти.
- **Безопасность токенов:** Все ваши учетные данные (как текущие активные, так и сохраненные профили) остаются строго на вашей машине. Они хранятся в защищенном системном хранилище Windows Credential Manager и SQLite базе данных VS Code и никогда не передаются сторонним серверам.
- **Условия использования:** Изменение проприетарного кода приложений может нарушать условия использования (ToS). Данный проект создан исключительно в образовательных целях — используйте его под свою ответственность.

---

## <a id="license"></a>📄 Лицензия

Проект распространяется под лицензией MIT. Подробности см. в файле [LICENSE](LICENSE).

eligibility-antigravity-patcher

eligibility-antigravity-patcher Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

eligibility-antigravity-patcher

eligibility-antigravity-patcher Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README