Gemini CLI

Google Gemini CLI под обычным Google-аккаунтом: контекст в миллион токенов, алиасы моделей вместо версий, одна рабочая слэш-команда и почему остальные роняют запуск.

Gemini CLI работает в VibeForge под обычным Google-аккаунтом, бесплатно и без API-ключа. В пикере стоят алиасы тиров — Auto, Pro, Flash, Flash Lite: CLI сам подставляет модель, доступную аккаунту, поэтому список не устаревает. Рядом Gemini 2.5 Pro и 2.5 Flash, контекст у всех 1 000 000 токенов. Неприятная особенность: почти любая слэш-команда в неинтерактивном режиме обрывает запуск с ошибкой.

Что VibeForge знает про этот движок

Свойство	Значение
Исполняемый файл	`gemini`, переопределяется `VIBEFORGE_GEMINI_BIN`
Вычищается из окружения	`GEMINI_API_KEY`, `GOOGLE_API_KEY`
Модели и контекст	Auto, Pro, Flash, Flash Lite, Gemini 2.5 Pro и 2.5 Flash — по 1 000 000 токенов
Уровень рассуждений	флага нет: глубину CLI выбирает сам
Обновление	`npm install -g @google/gemini-cli@latest`
Слэш-команды в headless	1: `/plan` — и только с аргументом

Почему в списке алиасы, а не номера версий

Потому что номер версии в списке живёт до следующего релиза Google, а алиас — сколько угодно. pro, flash и flash-lite — настоящие значения --model, которые CLI разворачивает сам: с доступом к preview pro даёт свежую Pro-превью, без доступа — обычную 2.5 Pro, и так же аккуратно откатывается flash. Прошлый список в VibeForge был из пинов и успел устареть ровно этим способом: серия Gemini уехала дальше, а в пикере всё ещё стояли позапрошлые идентификаторы. Конкретное поколение по-прежнему выбирается руками — парой 2.5, которая названа своим номером и никуда не поедет.

Почему ключи вычищаются, хотя они «просто лежат в окружении»

Потому что с выставленным GEMINI_API_KEY или GOOGLE_API_KEY CLI молча начинает биллить ключ вместо входа по аккаунту, а два ключа сразу — классический источник загадочных отказов. VibeForge подключается подписочным входом, поэтому обе переменные убираются из окружения агента.

Слэш-команды: не «не работают», а роняют запуск

Неинтерактивный режим команду разбирает, но принимает только один вид результата — «отправить это моделью как задание». На любой другой (сообщение, справка, сжатие контекста, статистика) он не отступает молча, а завершается фатальной ошибкой ввода. Из встроенных команд нужный результат возвращает ровно одна — /plan, и только если ей передан аргумент: без аргумента она просто переключает режим и отдаёт строку «/plan» модели текстом.

Что отправлено	Чем кончится
`/plan исправить логин`	работает: включается режим плана, задача уходит той же строкой
`/plan` без аргумента	строка уходит модели текстом, ход потрачен
`/init`, `/compress`, `/stats`, `/memory`, `/tools`, `/mcp`, `/chat`, `/docs`, `/copy`	запуск обрывается фатальной ошибкой

Отдельно работают команды пользователя из .gemini/commands/*.toml и промпты MCP-серверов — они возвращают ровно тот вид результата, который нужен. В общий каталог движка их не поместить: они лежат на диске конкретного проекта.

Установка и вход

1Поставьте CLI: npm i -g @google/gemini-cli.
2Запустите gemini и войдите Google-аккаунтом, когда программа спросит.
3В VibeForge откройте «Настройки → Окружение» и нажмите «Проверить снова».