Async Parallel Antigravity — MCP-сервер для Codex и Claude Code
Обёртка над официальным CLI Antigravity с управлением через MCP: параллельные сессии agy, которые можно ставить на паузу, возобновлять и подключать к живому терминалу.
claude mcp add --env AGY_CMD=<AGY_CMD> --transport stdio async-parallel-antigravity-for-codex-claude-code -- uvx codex-agy-bridgeЧто делает Async Parallel Antigravity for Codex & Claude Code
Сервер запускает сессии agy как отдельные процессы под контролем tmux. Агент-харнесс вроде Codex или Claude Code стартует run через MCP-инструмент agy_run_start, а сам сервер остаётся отзывчивым — длинные процессы живут в detached-супервизорах. Состояние и события пишутся локально, поэтому run можно найти и дочитать по run_id даже после того, как MCP-вызов вернулся или харнесс перезапустился.
Инструментов восемь: agy_run_start, agy_run_wait, agy_run_observe, agy_run_input, agy_run_cancel, agy_run_result, agy_goal, agy_admin. Ввод в сессию идёт с guard-условиями — если курсор событий или транскрипта сдвинулся после того, как вызывающий прочитал run, запись отклонится. Это страховка от гонок, когда два агента пишут в одну сессию.
Перед установкой нужен рабочий agy, авторизованный локально: agy models должен вернуть список моделей без ошибки. Без этого сервер добавится, но run при старте вернёт status="auth_required". Ещё нужны uvx и tmux — на macOS ставится через brew install tmux, на Debian/Ubuntu через sudo apt install tmux gnome-terminal. Сам мост приходит из PyPI как codex-agy-bridge.
Какие задачи решает
- запустить несколько сессий agy параллельно и не смешать их состояние
- подключить терминал к идущему run, не убивая процесс агента
- вернуться к результату run после таймаута MCP-вызова или перезапуска харнесса
- защитить ввод в сессию от устаревших записей, когда транскрипт уже уехал вперёд
- собрать группу целей в один goal и смотреть статус всей партии
Примеры запросов агенту
- Запусти новый run Antigravity с промптом «Напиши тесты для этого модуля» и дождись первого события.
- Посмотри статус run по
run_idиз предыдущего вызова — мне нужен только статус, без полного транскрипта. - Открой терминал текущего run через
agy_run_observeс view=terminal, хочу вручную ответить на запрос аутентификации.
Как установить Async Parallel Antigravity for Codex & Claude Code
Командой платформы
claude mcp add --env AGY_CMD=<AGY_CMD> --transport stdio async-parallel-antigravity-for-codex-claude-code -- uvx codex-agy-bridgeВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from codex-agy-bridge <команда>
Командой платформы
codex mcp add async-parallel-antigravity-for-codex-claude-code --env AGY_CMD=<AGY_CMD> -- uvx codex-agy-bridgeВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from codex-agy-bridge <команда>
Файл настроек
{
"mcpServers": {
"async-parallel-antigravity-for-codex-claude-code": {
"command": "uvx",
"args": [
"codex-agy-bridge"
],
"env": {
"AGY_CMD": "<AGY_CMD>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from codex-agy-bridge <команда>
Файл настроек
{
"servers": {
"async-parallel-antigravity-for-codex-claude-code": {
"type": "stdio",
"command": "uvx",
"args": [
"codex-agy-bridge"
],
"env": {
"AGY_CMD": "<AGY_CMD>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from codex-agy-bridge <команда>
Командой платформы
gemini mcp add -e AGY_CMD=<AGY_CMD> async-parallel-antigravity-for-codex-claude-code uvx codex-agy-bridgeВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from codex-agy-bridge <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Async Parallel Antigravity for Codex & Claude Code
Как установить Async Parallel Antigravity в Claude Code?
Сначала проверьте, что agy models проходит без ошибки авторизации. Затем выполните claude mcp add codex-agy-bridge -- uvx codex-agy-bridge. Если нужно явно указать путь к agy, используйте claude mcp add --env AGY_CMD=<AGY_CMD> --transport stdio async-parallel-antigravity-for-codex-claude-code -- uvx codex-agy-bridge. После установки перезапустите харнесс.
Что делает этот MCP-сервер?
Оборачивает официальный CLI Antigravity в управляющую плоскость MCP. Харнесс запускает, ждёт, отменяет и продолжает сессии agy, а сами процессы живут в tmux-сессиях под detached-супервизором, поэтому терминал можно подключить без остановки агента.
Что нужно для работы?
Официальный CLI agy с пройденной локальной авторизацией — agy models должен работать без ошибок. Плюс uvx для запуска сервера и tmux для терминальных сессий. Если авторизация слетит, run вернёт status="auth_required" и откроет видимую сессию для входа.
