Gemini CLI в агентной панели

Ваш вход в Google работает в агенте termide через Gemini CLI, а вокруг него карточки разрешений, ревьюер и редактор termide

Gemini CLI работает на вашем аккаунте Google или на ключе Gemini API. Можно запустить gemini в одной из терминальных панелей termide, но жить он будет рядом с termide, а не внутри: его правки попадают на диск в обход открытого редактора, подтверждения у него свои, и сессии тоже не termide.

Агентная панель termide умеет работать на Gemini CLI. Модель, квота и собственный способ работы Gemini CLI остаются за Google, а карточки разрешений, список сессий и редактор, который следит за каждой правкой, — за termide. Этот гайд показывает, как это настроить и что меняется по сравнению с Gemini CLI в терминале.

Что понадобится

  • Node.js и npx в PATH. Gemini CLI сам говорит на Agent Client Protocol, без адаптера: termide запускает последний выпуск @google/gemini-cli с флагом --acp через npx. Копия из кэша npm стартует, не обращаясь к реестру; новый выпуск termide ищет в фоне раз за запуск, и он начинает работать со следующей панели.
  • Вход в Gemini CLI. Сам termide вход не выполняет. Если вы уже пользуетесь Gemini CLI, всё готово; иначе один раз запустите его отдельно, npx @google/gemini-cli, и выберите способ входа: аккаунт Google, ключ Gemini API (GEMINI_API_KEY) или Vertex AI.

Добавьте подключение

Откройте настройки клавишами Alt+P и перейдите на вкладку AI. Первым идёт раздел Подключения. Выберите + Добавить подключение и на странице нового подключения поставьте Провайдер: Gemini CLI. Страница уберёт поля, которые Gemini CLI не нужны, — базовый URL, API-ключ, запасное контекстное окно, — а подключение будет называться gemini-cli, пока вы не дадите ему имя.

termide
Настройки, AI › gemini-cli: Провайдер — Gemini CLI, открыт список моделей: Авто — на выбор провайдера, Auto (Gemini 4), gemini-4-pro-preview, gemini-4-flash-preview, gemini-3.5-pro, gemini-3.5-flash, gemini-3.5-flash-lite и ввод id вручную
В списке моделей — модели, которые Gemini CLI предлагает вашему входу, в том числе его собственный Auto.

Остальное на странице:

  • Модель: termide ненадолго запускает Gemini CLI и показывает модели, которые он предлагает; пока список грузится, в поле крутится индикатор. Собственный Auto у Gemini выбирает модель под каждый запрос; Авто — на выбор провайдера оставляет выбор настройкам Gemini CLI. Выбранная здесь модель — только та, что выбрана заранее: в панели её можно сменить в любой момент.
  • Использовать по умолчанию: отметьте, и новые агентные панели будут открываться на Gemini CLI.

Ограничения контекстного окна здесь нет: у Gemini CLI нет такой настройки, и разговор он сжимает по своим правилам.

То же самое в config.toml:

[ai]
connection = "gemini"        # подключение для новых сессий

[ai.connections.gemini]
provider = "gemini_cli"      # больше ничего не требуется
# model = ""                 # пусто: модель по умолчанию у Gemini CLI

Первый запрос

Откройте агентную панель клавишами Alt+A. Баннер показывает подключение и модель; чип Модель в строке статуса крутится, пока Gemini CLI стартует в фоне, а запрос, отправленный в это время, ждёт его. Дальше панель работает как с любым другим подключением: ответы, размышления и шаги Gemini появляются блоками — чтение, правка с её файлом, команда с её строкой, — редактор с открытым файлом следит за каждой правкой, а часы прогона идут, пока Gemini CLI не закончит.

termide
Запрос на Gemini CLI: редактор отмечает изменённые строки, а запуск тестов ждёт вашего ответа.

Чип Модель показывает и переключает модели Gemini CLI в любой момент, и во время прогона тоже. Собственные /-команды Gemini CLI попадают в список / панели и уходят к нему как набраны. Сообщение, набранное во время работы, ждёт в строке состояния и уходит следующим запросом: посреди хода Gemini CLI сообщений не принимает.

Инструменты Gemini, решения termide

Как и у Codex, у Gemini CLI остаются свой системный промпт и свои инструменты: он читает, правит и запускает команды так же, как в терминале, и его собственная конфигурация — ~/.gemini/settings.json, его MCP-серверы и расширения, файлы контекста GEMINI.md — продолжает действовать. Что добавляет termide:

  • Режим разрешений. termide ставит Gemini CLI в режим подтверждения, соответствующий режиму панели, и сам решает, что Gemini запрашивает на подтверждение.
  • MCP-серверы termide. Их инструменты termide отдаёт Gemini CLI рядом с его собственными и проверяет так же, как собственные вызовы Gemini. Gemini CLI читает список один раз, при старте сессии, так что сервер, подключившийся позже, станет ему доступен в следующей сессии.
  • Инструменты, которых у Gemini CLI нет: recall для поиска по прошлым сессиям и истории git, skill со списком ваших навыков в описании, question и suggest_command.

Gemini CLI читает GEMINI.md, а не AGENTS.md. Если инструкции вашего проекта лежат в AGENTS.md, как ждут остальные подключения termide, попросите Gemini CLI читать и его — в ~/.gemini/settings.json:

{ "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } }

Цикл разговора остаётся за Gemini CLI: контекст он сжимает сам, и поставить прогон на паузу между шагами нельзя.

Разрешения и режим auto

Чип Разрешения (или Shift+Tab) задаёт режим, и termide переводит его в режимы подтверждения Gemini CLI:

termide Gemini CLI
ask, configured, auto default: спрашивает перед правками и командами
plan plan, если режим плана включён в настройках Gemini; иначе default, а правки termide отклоняет
edit autoEdit: правки проходят, команды спрашивают
all yolo: ничего не спрашивает

Всё, что Gemini CLI запрашивает на подтверждение, проходит проверки termide: ваши правила, ответы, данные в этой сессии, и режим. То, что они не решают, появляется карточкой над полем ввода: разрешить один раз, на сессию, всегда в этом проекте или везде, запретить, запретить и объяснить агенту почему, или остановить прогон.

termide
Карточка над полем ввода: агент хочет запустить python3 -m unittest -q; варианты: разрешить один раз, на сессию, запретить, запретить на сессию, запретить и объяснить, остановить прогон
Gemini CLI спрашивает через карточку termide, как и собственный агент termide.

auto — для прогона, направлению которого вы доверяете, но отвечать на карточку за карточкой не хотите. То, что вызвало бы карточку, уходит ревьюеру — отдельному обращению к модели, которое решает, служит ли шаг тому, о чём вы просили. На подключении Gemini CLI ревьюер работает через ваш вход, на модели, на которой идёт сессия, без API-ключа: termide держит Gemini CLI запущенным и задаёт каждый вопрос в короткой отдельной сессии, без инструментов и без разговора агента, так что агент никогда не судит сам себя. Свой системный промпт Gemini CLI оставляет и там, поэтому проверка идёт медленнее, чем на подключении к модели, и расходует вашу квоту. Обычно для этого берут маленькую модель; укажите её в поле Ревьюер режима auto на странице подключения или в [ai.auto_reviewer]:

[ai.auto_reviewer]
connection = "gemini"   # пусто: подключение сессии
model = "flash-lite"    # его модель: по id, имени или части любого из них

Когда кончилась квота

Ошибку квоты Gemini CLI сначала повторяет сам. Когда он сдаётся, его режим ACP сообщает только «Rate limit exceeded. Try again later.» — без времени сброса, которое назвал API, — так что отсчитать до него карточка не может:

  • Повторить сейчас,
  • Повторять, пока не получится, с растущими паузами между попытками,
  • Остановиться (Esc).
termide
Ошибка Rate limit exceeded. Try again later. (code 429) и карточка Rate limit reached, варианты: повторить сейчас, повторять, пока не получится, остановиться
Квота исчерпана: когда она сбросится, Gemini CLI не говорит, поэтому карточка предлагает повторять.

Для /goal или /loop без присмотра поставьте При лимите или сбое сети (on_limit в [ai]) в wait: прогон будет повторять сам; ask_else_wait показывает карточку и повторяет, если никто не ответил. Если закрыть termide в это время, ничего не потеряется: открытая заново сессия вернёт карточку.

Если ждать не хочется, держите второе подключение. Чип Подключение в строке статуса остаётся доступен, пока висит карточка: переведите сессию на другое подключение и ответьте Повторить сейчас. Разговор переносится, так что другая модель продолжит с того места, где остановился Gemini. Подойдёт и сам Gemini API с оплатой по ключу:

[ai.connections.gemini]
provider = "gemini_cli"

[ai.connections.gemini-api]
provider = "openai_compatible"
base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
model = "gemini-3.5-flash"
api_key_env = "GEMINI_API_KEY"

Поручённые задачи

Поручений termide Gemini CLI не выполняет: у него свой способ делить работу, и поле Подагенты на его странице показывает (нет). Выполнять поручения на Gemini CLI тоже нельзя: для этого нужно подключение к модели или Claude Code.

Сессии и расходы

Журнал сессии хранит собственную сессию Gemini CLI, поэтому открытая заново панель продолжает её, и Gemini знает весь разговор. Сессия, перешедшая на Gemini CLI с другого подключения, начинается с записи разговора до этого момента. Ответвлять сессию Gemini CLI не умеет, поэтому запрос судьи /goal и сводки /handoff уходит к нему ходом, который панель и её журнал опускают, хотя собственная сессия Gemini его сохраняет.

Сведения о сессии (F3 или /usage) раскладывают токены по тому, кто их потратил, — разговор, ревьюер auto и остальное, — и по моделям. Gemini считает размышления отдельно, поэтому строка Рассуждения показывает, какая часть вывода ушла на них.

Полезно знать

  • termide песочницы не даёт. Разрешения termide — это контроль, а не изоляция: разрешённое выполняется с вашими правами в тех пределах, которые оставляет собственная песочница Gemini CLI, если вы её включили.
  • Claude Code и Codex подключаются так же: provider = "claude_code" или "codex". Им посвящены гайды Claude Code в агентной панели и Codex в агентной панели.
  • Вторым подключением, на которое можно перевести сессию, когда кончился лимит, может быть любой OpenAI- или Anthropic-совместимый API: hosted, как у OpenAI, OpenRouter или Anthropic, или ваш собственный сервер, — с собственным агентом termide. llama.cpp и omlx — два примера последнего.
  • Подробности — в руководстве по агенту.