Исправление: проблемы обновления Antigravity v1.21.6

Обновление Antigravity v1.21.6 вышло в конце марта 2026 года и принесло масштабные изменения в работе песочницы, аутентификации MCP и выполнении инструментов. Хотя в списке изменений заявлялись улучшения безопасности, релиз вызвал волну регрессий, нарушивших основные рабочие процессы у значительного числа пользователей. В этом руководстве задокументированы все подтвержденные проблемы, их первопричины и способы исправления, отсортированные по степени критичности.

Что изменилось в v1.21.6

Прежде чем переходить к исправлениям, полезно понять, что именно вошло в v1.21.6. Релиз был в первую очередь обновлением безопасности и соответствия стандартам, но некоторые изменения привели к непредвиденным побочным эффектам:

• Песочница Linux (новое): Новый обязательный режим песочницы для сред Linux и WSL2. Это основной источник проблем — песочница по умолчанию ограничивает доступ к файловой системе и выполнение подпроцессов, при этом в начальном релизе нет возможности её отключить.
• Переработка аутентификации MCP: Процесс аутентификации MCP-сервера был переписан с использованием нового механизма обмена токенами. Существующие токены из v1.20.x теперь недействительны, а на новой странице авторизации есть свои баги.
• Рефакторинг движка выполнения инструментов: Внутренний движок, отвечающий за write_to_file, execute_command, и другие встроенные инструменты, был переработан для новой песочницы. Это нарушило вызовы инструментов на нескольких платформах.
• Устаревшие функции: Режим Follow-along и среда playground были полностью удалены (не просто скрыты, а вырезаны из кодовой базы).
• Изменения автообновления: Автообновление на macOS теперь работает более агрессивно, из-за чего сложнее оставаться на старой версии.

Сочетание обязательной песочницы, изменений в авторизации и рефакторинга движка инструментов привело к тому, что пользователи Linux, WSL2 и Windows столкнулись с несколькими проблемами одновременно. В разделах ниже каждая из них рассматривается отдельно.

Исправление: блокировка режима песочницы (WSL2 / Linux)

Это самая частая жалоба в v1.21.6. После обновления пользователи WSL2 и нативных систем Linux оказываются заблокированы в ограниченной песочнице, где агент не может записывать файлы, выполнять команды терминала или получать доступ к директориям проектов вне узкого разрешенного пути. Ошибка обычно выглядит так:

Первопричина: Песочница v1.21.6 по умолчанию использует минимальный список разрешений, который включает только директорию ~/.antigravity . Ваши фактические директории проектов не добавляются автоматически в Linux/WSL2, в отличие от macOS, где регистрация путей выполняется через app bundle.

Решение

Вам необходимо явно настроить список разрешений песочницы. Откройте (или создайте) файл ~/.antigravity/sandbox.json:

Замените YOUR_USERNAME вашим фактическим именем пользователя Linux. После сохранения полностью перезапустите Antigravity:

Если после настройки allowlist вы все еще видите ошибки доступа, проблема может быть связана с более широкой блокировкой "version no longer supported" — см. наше руководство по исправлению ошибки "version no longer supported" for that scenario.

Fix: write_to_file Tool Broken

After updating to v1.21.6, the write_to_file tool silently fails — the agent reports success, but the file is never actually written or modified. This affects both the built-in file writing tool and any MCP server that relies on file system access.

Root cause: The tool execution engine refactor introduced a race condition where the sandbox permission check completes after the write operation is attempted. The write is blocked, but the success callback fires anyway because it was registered before the permission check.

Workaround

Until a patch is released, the most reliable workaround is to use the execute_command tool with a shell redirect instead of write_to_file. You can instruct the agent to do this by adding a rule to your project's .antigravity/rules file:

This is not ideal for large files, but it works consistently for most development workflows. The agent will use cat or echo with output redirection, which goes through the command execution path rather than the broken file-write path.

Fix: Stuck on "Running Command" Indefinitely (Windows)

Windows users report that after v1.21.6, the agent gets stuck displaying "Running command..." with no output and no way to cancel. The spinner runs forever, and even starting a new conversation does not clear the state.

Root cause: The new sandbox layer intercepts subprocess calls on Windows but does not properly handle the case where the default shell (cmd.exe) is invoked without an explicit path. The sandbox waits for a permission grant that never arrives because the request is malformed internally.

The Fix

Set the default shell explicitly in your Antigravity settings. Open Settings > Terminal > Default Shell and set it to the full path:

Или, если вы предпочитаете PowerShell:

Ключевым моментом является использование абсолютного пути вместо простого cmd или powershell. После настройки полностью закройте Antigravity (проверьте в Диспетчере задач, что фоновые процессы не остались) и запустите снова. Если агент завис посреди диалога, возможно, придется начать новый — старый может остаться в поврежденном состоянии.

Для решения более общих проблем с зависанием или отсут Antigravity not responding fix guide.

Fix: PowerShell Execution Errors

A related but distinct issue: even when commands do execute on Windows, PowerShell-specific syntax fails with errors like The term 'X' is not recognized as the name of a cmdlet or execution policy blocks. This happens because v1.21.6 changed how the agent spawns shell subprocesses, and PowerShell's execution policy is not inherited correctly in the new sandbox.

The Fix

Add the following to your Antigravity terminal configuration (Settings > Terminal > Shell Args):

This tells PowerShell to skip the execution policy check and profile loading, both of which cause problems in the sandboxed environment. If you are a cmd.exe user rather than PowerShell, switching to cmd as your default shell (see previous section) avoids this entirely.

Fix: Tool Call Approval UI Disappearing

In v1.21.6, when the agent requests permission to run a tool (file write, terminal command, etc.), the approval dialog briefly flashes on screen and then vanishes. The agent then sits idle, waiting for approval that the user cannot grant because the UI element is gone. There is no way to approve or deny the request.

Root cause: The approval UI component's z-index conflicts with a new overlay layer added in v1.21.6 for sandbox status notifications. The approval dialog renders behind the overlay and is immediately obscured.

Community Workaround (via Global Rules)

Until the UI bug is patched, you can bypass the approval dialog entirely by configuring the agent to auto-approve tool calls. Add this to your global rules file:

An alternative is to run Antigravity with the --auto-approve flag from the command line, which scopes auto-approval to a single session rather than making it a permanent global rule:

Fix: MCP Auth Page Broken

The v1.21.6 MCP authentication rewrite broke the OAuth flow for third-party MCP servers. When you click "Authenticate" on an MCP server that requires login (like GitHub, Supabase, or Vercel), the auth page either loads a blank white screen or throws a redirect_uri_mismatch error.

Основная причина: Новый эндпоинт обмена токенами ожидает другой формат callback URL, но определения MCP-сервера всё ещё ссылаются на старый формат. Это несоответствие конфигурации на стороне сервера, которое должна исправить команда Antigravity.

Временное решение

Вы можете вручную аутентифицировать MCP-серверы, сгенерировав токены вне Antigravity и добавив их в свою конфигурацию:

1. Сгенерируйте персональный токен доступа (PAT) в панели управления провайдера MCP (например, GitHub Settings > Developer settings > Personal access tokens).
2. Добавьте токен напрямую в ваш mcp_config.json используя подстановку переменных окружения:

3. Установите переменную окружения в профиле вашей оболочки (~/.zshrc, ~/.bashrc, или в переменных окружения Windows).
4. Перезапустите Antigravity, чтобы применить новую конфигурацию.

Для ознакомления с полным руководством по настройке MCP-сервера и типичными ошибками см. наше руководство по исправлению ошибки MCP initialize EOF.

Исправление: Терминальные команды не работают в Linux Mint

Пользователи Linux Mint сообщают, что в версии v1.21.6 все терминальные команды завершаются общей ошибкой "command execution failed", даже базовые, такие как ls или pwd. Это не затрагивает Ubuntu, Fedora или Arch — только Linux Mint и производные дистрибутивы.

Основная причина: Linux Mint поставляет /bin/sh как симлинк на dash, и механизм определения оболочки в песочнице v1.21.6 ошибочно идентифицирует dash как неподдерживаемую оболочку. В результате песочница блокирует запуск любых подпроцессов.

Решение

Переопределите оболочку в настройках Antigravity. Откройте Settings > Terminal > Default Shell и установите:

Если вы предпочитаете zsh, используйте /usr/bin/zsh вместо этого. Главное — явно указать путь к бинарному файлу поддерживаемой оболочки, а не полагаться на /bin/sh.

В качестве альтернативы можно создать переопределение симлинка в системе (это исправит проблему глобально для всех приложений с аналогичной логикой):

Как откатиться до v1.19.6 / v1.20.5

Если указанные выше исправления не помогли или если вам нужны удаленные функции (см. следующий раздел), откат — самый надежный способ решения проблемы. Рекомендуются две стабильные версии: v1.20.5 (последняя перед переработкой песочницы) и v1.19.6 (последняя версия с режимом follow-along и playground).

Шаг 1: Удалите v1.21.6

macOS

Windows

Linux

Step 2: Install Your Target Version

Download the specific version installer from your Google account's Antigravity release archive. Log into your account dashboard, navigate to the Downloads section, and select the version you want.

Step 3: Bypass the Auto-Updater (Critical)

This is the step most people miss. After installing an older version, Antigravity's auto-updater will immediately detect that a newer version exists and force-update you back to v1.21.6 — sometimes within minutes of launching.

macOS (block the updater):

Windows:

Linux:

If you encounter a "version no longer supported" message after downgrading, that is a separate server-side enforcement — see our version no longer supported fix guide для поиска обходных путей.

Удаленные функции: Follow-Along Mode & Playground

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

• Режим Follow-along: Previously let you watch the agent's cursor movement and file edits in real time. This was removed for "performance optimization" according to the internal changelog. The agent still works in the background, but you no longer see a live view of its actions.
• Playground: Среда Playground (песочница), где вы могли тестировать действия агента, не затрагивая основной проект. По иронии судьбы она была удалена в том же обновлении, которое ввело обязательный sandboxing. Обоснованием послужило то, что новый режим sandbox делает Playground избыточным, хотя многие пользователи с этим не согласны.

На данный v1.19.6 (the last version that has both) is the only option. Note that v1.20.x had already begun deprecating follow-along mode behind a feature flag, so v1.19.6 is specifically the version you want.

If your Antigravity instance is crashing rather than just missing features, the underlying cause may be different — check our server crashed fix guide for crash-specific troubleshooting.