🇬🇧 English version: README.en.md

Фикс периодических зависаний Агента в Antigravity

Иногда Агент может бесконечно зависать при выполнении команд. Это можно починить так:

1. Переключите язык клавиатуры на английский.

2. Откройте новое окно или перезапустите Antigravity.

   Важно: раскладка клавиатуры должна быть переключена до открытия окна или запуска Antigravity.
   Если сменить раскладку уже после запуска — баг может не воспроизвестись или не пофикситься.

3. Вставьте в чат команду:

Запусти Get-Date через run_command

Важно, чтобы Агент запустил любую команду именно через run_command.

4. Если всё прошло успешно, в чате появится кнопка: Ran background terminal command → Open in Terminal Нажмите на неё.

5. После этого:

• можно снова использовать любой язык,
• если какая-то команда снова зависнет — просто выполните её вручную в открывшемся терминале Antigravity Agent.

---

Проще говоря:
мы один раз «инициализируем» терминал через run_command, и дальше всегда можем вручную добивать зависшие команды через него.

---

Суть в двух словах

Баг не в командах.
Баг в том, что Antigravity подставляет cd,
а при русской раскладке превращает его в сcd, что ломает весь пайплайн.

---

Подробнее почему это происходит

Важно: баг зависит от раскладки клавиатуры в момент инициализации окна Antigravity.
То есть раскладку нужно менять до запуска программы или открытия нового окна,
а не после.

В Antigravity есть зашитое правило:
Агент должен работать только в текущей папке проекта, чтобы защитить от случайных инцидентов с другими папками.

Реализована эта защита достаточно просто: перед каждой командой интерпретатор автоматически подставляет:

cd <путь_к_проекту>

Но есть баг:
если у вас включена русская раскладка, то вместо cd он подставляет:

сcd <путь_к_проекту>

Где первая с — это кириллическая, а не латинская.

В итоге терминал получает несуществующую команду сcd, ломается и зависает.

Выглядит это ровно так, как будто человек:

• начал писать cd,
• понял, что раскладка русская,
• переключился на английскую,
• но забыл удалить первую русскую букву с.

---

Как отследить ошибку (опционально)

Есть два простых способа увидеть этот баг своими глазами.

1. Через терминал Antigravity Agent

Если у вас уже открыт терминал Antigravity Agent,
то при зависаниях вы часто можете прямо там видеть что-то вроде:

сcd C:\path\to\project

или сообщения об ошибке, связанные с сcd.

2. Через Developer Tools

Если кнопка Ran background terminal command → Open in Terminal не появляется:

1. Нажмите F1 (или Ctrl+Shift+P).
2. Введите: Developer: Toggle Developer Tools.
3. Выберите пункт:
   «Разработчик: Включить или отключить средства разработчика».
4. Откроется отдельное окно (как в Chrome).
5. Перейдите на вкладку Console и посмотрите, появляются ли ошибки
   (красный текст) в момент, когда команда зависает.

Именно там можно увидеть, что вместо cd выполняется сcd.

3. Скриншоты