Gemini CLI: как да управлявате онлайн магазина с Gemini от терминала

Накратко: Gemini CLI е AI агентът на Google с отворен код, който работи в терминала. Инсталира се с npm install -g @google/gemini-cli (нужен е Node.js 20+), а с разширението на CloudCart и PAT токен управлява магазина ви на български. От 18 юни 2026 г. Gemini CLI работи с платен ключ за Gemini API или лиценз Gemini Code Assist Standard/Enterprise.

Какво е Gemini CLI и с какво се различава от чата Gemini

Gemini CLI (в търсенията и Google Gemini CLI) е AI агент на Google, който работи в терминала на компютъра ви и изпълнява задачи с моделите Gemini. Програмата е с отворен код под лиценза Apache 2.0, а командата, с която я пускате, е gemini. По данни на Google от май 2026 г. проектът има над 100 000 звезди в GitHub и нови версии всяка седмица (Google Developers Blog). Към 4 ноември 2026 г. последната версия е v0.67.0 (GitHub Releases).

Чатът Gemini (gemini.google.com и приложението за телефон) отговаря с текст. Може да ви напише описание на продукт, но не може да го запише в магазина. Gemini CLI има инструменти: чете и пише файлове, пуска команди, търси в интернет и се свързва с външни системи през MCP сървъри. Когато го свържете с CloudCart, изречението „намали с 15% всичко в категория Зима“ стига до реална промяна в магазина, без да копирате нищо.

	Gemini (чат)	Gemini CLI	Antigravity CLI
Къде работи	Браузър и приложение	Терминал, команда gemini	Терминал, команда agy
Изпълнява задачи на компютъра	Не	Да: файлове, команди, MCP	Да, с няколко агента наведнъж
С какъв акаунт	Всеки акаунт в Google	Платен ключ за Gemini API, Vertex AI или лиценз Code Assist Standard/Enterprise	Личен акаунт в Google, Google AI Pro и Ultra, Google Cloud
Връзка с CloudCart	Няма	Официално разширение с умения и MCP	Не е описана отделно в инструкциите на CloudCart (към 04.11.2026)
Подходящ за	Идеи и текстове за копиране	Ежедневно управление на магазина	Програмисти, които работят с Gemini 4

Какво се промени през 2026: Gemini CLI или Antigravity CLI

От 18 юни 2026 г. Gemini CLI не обслужва личния достъп без плащане (Gemini Code Assist for individuals) и абонаментите Google AI Pro и Ultra. Google ги премести в новия Antigravity CLI. Gemini CLI остава за фирми с лиценз Gemini Code Assist Standard или Enterprise и за всеки с платен ключ за Gemini API или Vertex AI (github.com/google-gemini/gemini-cli). В описанието на проекта Google нарича входа с ключ за API и Vertex AI стар (legacy) начин, затова следете обявите в хранилището.

Вашият акаунт	Работи ли Gemini CLI след 18.06.2026	Какво да направите
Личен акаунт в Google без абонамент	Не	Създайте платен ключ за Gemini API в Google AI Studio или изберете друг агент
Google AI Pro или Ultra (Google One)	Не	Абонаментът важи за Antigravity CLI. За Gemini CLI ви трябва отделен платен ключ за API
Платен ключ за Gemini API (Google AI Studio)	Да	Задавате ключа в GEMINI_API_KEY и плащате по използване
Фирмен лиценз Gemini Code Assist Standard/Enterprise	Да, без промяна	Влизате с Google и задавате проекта в GOOGLE_CLOUD_PROJECT
Vertex AI в Google Cloud	Да	Задавате ключа и GOOGLE_GENAI_USE_VERTEXAI=true

Google пише още, че Gemini CLI не е настроен за моделите от серията Gemini 4, например Gemini 4 Argon. За магазина това значи, че работите с моделите от серията Gemini 3, а модела сменяте с командата /model.

Важно: официалните инструкции на CloudCart в github.com/cloudcart/ai-toolkit описват Gemini CLI, Claude Code, ChatGPT/Codex, Cursor и VS Code. Antigravity CLI към 4 ноември 2026 г. не е описан отделно. Ако имате само Google AI Pro и не искате да плащате API отделно, свържете магазина с Claude Code или Codex, за които има готови ръководства по-долу.

Колко струва Gemini CLI

Самата програма Gemini CLI се инсталира без такса, защото е с отворен код. Плащате използването на модела: по токени с ключ за Gemini API или чрез фирмения лиценз на Code Assist. Свързването с CloudCart също е без такса.

При платения ключ цената зависи от модела. Пример от ценовата листа на Gemini API (проверено на 4 ноември 2026 г., в долари): Gemini 3.8 Flash струва $0,75 за 1 милион входящи токена и $3,75 за 1 милион изходящи до 31.12.2026. От 1 януари 2027 г. двете цени се удвояват. Разговор с 1 милион входящи и 200 000 изходящи токена струва $0,75 + $0,75 = $1,50. Колко токена е похарчил вашият разговор, показва командата /stats model. По ценовата листа данните при платения план не се ползват за подобряване на продуктите на Google.

Вторият разход е планът на магазина в CloudCart. Цените са на месец, без ДДС, при годишно плащане и с 0% комисионна от продажбите на всеки план:

План на CloudCart	При годишно плащане	Шестмесечен оборот до
Baby Pack	€14 на месец (€168 на година)	€9 999
Starter Pack	€33 на месец (€390 на година)	€24 999
CC Pro	€83 на месец (€990 на година)	€249 999
CC Master	€249 на месец (€2 990 на година)	€499 999

Функциите по планове са на страницата с цените на CloudCart (цените са от ноември 2026 г.).

Какво ви трябва, преди да инсталирате Gemini CLI

• Компютър. Google препоръчва macOS 15+, Windows 11 24H2+ или Ubuntu 20.04+, поне 4 GB RAM за кратки задачи и 16 GB за дълги разговори с голям каталог (изискванията на Gemini CLI).
• Node.js 20 или по-нов и git. На тях работят и Gemini CLI, и инструментите на CloudCart. Ако липсват, при свързването асистентът ги инсталира сам, където може.
• Ключ за Gemini API с включено плащане или фирмен лиценз Code Assist. Ключа създавате в Google AI Studio.
• Магазин в CloudCart и достъп на собственик. Само собственикът на магазина създава PAT токени.
• Данните за продуктите. Таблица от доставчика, стар експорт или описание с думи.

Как се инсталира Gemini CLI

Gemini CLI се инсталира с една команда в терминала. Командите са от официалното хранилище на Google в GitHub.

1. Отворете терминала. На macOS е приложението Terminal, на Windows е PowerShell, на Linux е терминалът на дистрибуцията.
2. Инсталирайте програмата. С npm на всяка система: npm install -g @google/gemini-cli. На macOS и Linux може и с Homebrew: brew install gemini-cli. Ако искате само да я пробвате без инсталация: npx @google/gemini-cli.
3. Задайте ключа за API. На macOS и Linux: export GEMINI_API_KEY="вашият-ключ". На Windows в PowerShell: $env:GEMINI_API_KEY="вашият-ключ". Така ключът важи до затваряне на прозореца. За да остане, добавете реда във файла ~/.zshrc или ~/.bashrc.
4. Пуснете Gemini CLI от папката на магазина. Създайте папка, например ~/moyat-magazin, влезте в нея и напишете gemini. Папката пази постоянните инструкции и файловете, които ще давате на асистента.
5. Проверете версията. Командата /about показва версията и начина на вход. За нова версия пуснете npm install -g @google/gemini-cli@latest.

Ако работите с фирмен лиценз Code Assist, вместо ключа задайте проекта: export GOOGLE_CLOUD_PROJECT="id-на-проекта", после пуснете gemini и влезте с фирмения акаунт в Google.

Как да обновите Gemini CLI до последната версия

Gemini CLI се обновява със същата команда, с която се инсталира, като добавите @latest. Новите стабилни версии излизат всяка седмица, а списъкът с промените е в GitHub Releases на Gemini CLI.

Как сте инсталирали	Команда за обновяване	Как проверявате
npm (всяка система)	npm install -g @google/gemini-cli@latest	gemini --version или /about
Homebrew (macOS, Linux)	brew upgrade gemini-cli	gemini --version
npx (без инсталация)	Не е нужно: npx @google/gemini-cli@latest пуска последната версия	/about

За магазина ползвайте стабилната версия (latest). Версиите preview и nightly са за тестване на нови функции и може да имат грешки. След обновяване на Gemini CLI обновете и разширението на CloudCart с /extensions update --all.

Как да свържете Gemini CLI с онлайн магазина в CloudCart

Свързването с магазин в CloudCart, българската платформа за онлайн магазини, е едно изречение и един ключ от админа. Отнема няколко минути, а асистентът върши инсталацията сам.

1. Поставете изречението за свързване в Gemini CLI и натиснете Enter. То е на английски, защото е команда към асистента:
   Fetch and follow the instructions at https://raw.githubusercontent.com/cloudcart/ai-toolkit/main/prompt.md to set up my AI agent for CloudCart
2. Отговорете на двата въпроса. Gemini CLI пита на какъв език да говорите и за какво ще ползвате връзката: управление на магазина (по подразбиране) или разработка, например собствена витрина. Изберете български и управление.
3. Одобрете командите. Асистентът проверява за Node.js 20+ и git и пуска gemini extensions install https://github.com/cloudcart/ai-toolkit. Разширението слага уменията на CloudCart и MCP сървърите наведнъж. После инсталира CloudCart CLI. Преди всяка команда прочетете какво ще бъде пуснато и потвърдете.
4. Създайте ключ за достъп в админа. Отворете админа на магазина, менюто с профила долу вляво → „PAT токени“ (или Настройки → „PAT токени“). Натиснете бутона за нов токен, дайте му име, например „Gemini CLI“, и изберете нивото на достъп.
5. Копирайте ключа веднага. Ключът започва с cc_pat_ и се показва само веднъж. Платформата пази само хеша му, затова изгубен ключ не се възстановява: изтривате го и създавате нов.
6. Дайте ключа и адреса на магазина. Адресът може да е служебният на CloudCart или вашият домейн. Асистентът влиза с cloudcart auth login и проверява връзката с cloudcart auth status.
7. Започнете с въпрос. „Кои са 10-те ми най-продавани продукта за последния месец?“ Така виждате как работи, преди да му дадете първата промяна.

Изречението и командата за ръчна инсталация са и на страницата Gemini CLI интеграция с CloudCart. Разширението се обновява с /extensions update --all в Gemini CLI.

Gemini MCP: какво слага разширението на CloudCart

MCP (Model Context Protocol) е отворен стандарт, по който AI асистентите се свързват с външни системи. MCP сървърът е програмата, която казва на асистента какви инструменти има и как да ги извика. Gemini CLI поддържа MCP сървъри и разширения (extensions), които ги носят готови. Разширението на CloudCart е такова: една команда слага всичко нужно.

Част	За какво служи	Пипа ли данните на магазина
CloudCart CLI	Команден ред, през който минават реалните четения и промени. Пази входа с вашия PAT токен.	Да, само той
Dev MCP	Търси в схемата на Admin GraphQL API и проверява всяка заявка, преди да бъде пусната	Не
Справочник на платформата	Над 2 500 страници за това как работи CloudCart: менюта, настройки, правила, планове. Сваля се при първото ползване.	Не
Умения на CloudCart	Правила за работа с каталога: преглед преди масова промяна, потвърждение, резервно копие	Не
Storefront MCP	Схемата на Storefront API за собствена витрина с Nitrogen, при профила за разработка	Не

Admin GraphQL API на CloudCart има над 1 100 операции: продукти, варианти, наличности, поръчки, клиенти, намаления, блог, настройки, импорт и експорт. Лимитът е 300 заявки в минута за един адрес на магазин. Дали всичко е заредено, проверявате с три команди: /extensions list показва разширението, /mcp list показва MCP сървърите и инструментите им, а /skills list показва уменията.

Командите на Gemini CLI, които ще ползвате в магазина

Разговорът върви на български, а командите с наклонена черта пестят време и токени. Пишете ги в същия прозорец:

Команда	Какво прави	Кога в магазина
/plan	Режим само за четене: асистентът прави план, без да променя	Преди голяма задача, например нови цени за целия каталог
/init	Създава файл GEMINI.md с постоянни инструкции за папката	Записвате правилата на магазина веднъж
/memory show	Показва инструкциите, които асистентът е заредил	Когато искате да видите кои правила важат
/stats model	Показва изразходваните токени и квотата	За да следите разхода по ключа за API
/compress	Заменя дългия разговор с кратко резюме	След дълга задача, за да харчите по-малко токени
/clear	Започва нов разговор с празна памет	Между две различни задачи
/resume	Отваря запазените разговори	На следващия ден, за да довършите задачата
@файл	Дава на асистента съдържанието на файл	„@cenorazpis.csv обнови цените по кодовете“

Файлът GEMINI.md е най-полезният. Gemini CLI го чете в началото на всеки разговор в папката. Пример за магазин: „Пиши на български с обръщение „вие“. Нови продукти записвай само като чернови. Цените са с ДДС. Не пипай категория „Разпродажба“ без мое потвърждение. Описанията са по 3 изречения, само с факти от продукта.“

Важно: командата /rewind (два пъти Esc) връща разговора и файловете на компютъра ви. Промените, които асистентът вече е записал в магазина, тя не връща. Пътят назад за магазина е CSV файлът с текущите стойности, който уменията на CloudCart правят преди голяма промяна.

11 задачи за Gemini CLI, които носят продажби

Най-много печелите от задачите, които отлагате, защото отнемат часове в админа: метрики от няколко екрана, SEO заглавия на стотици продукти, текстове за писма и реклами. Gemini CLI чете данните от магазина, показва какво ще направи и чака потвърждение.

Цел	Какво пишете на Gemini CLI	Защо помага
1. Седмичен отчет	„Покажи продажбите, поръчките и средната поръчка за последните 7 дни спрямо предните 7, и трите най-продавани продукта.“	Три екрана в админа стават един отговор.
2. Мобилна версия	„Колко от посещенията са от телефон и как се промени делът за 3 месеца?“	Ако повечето посещения са от телефон, проверявате първо мобилната количка.
3. Изоставени колички	„Кои продукти остават най-често в изоставени колички? Напиши текст за писмото за тях.“	Писмото говори за продуктите, които клиентът е оставил.
4. Имейл кампания	„Направи сегмент от клиентите с поне 2 поръчки, които не са поръчвали от 90 дни, и чернова на кампания за тях.“	Кампанията остава чернова в Marketing Suite, докато не я пуснете вие.
5. Реклама в Meta	„Напиши 3 варианта реклама за Instagram за трите най-продавани продукта, с цена и полза.“	Текстът се опира на реалните продажби.
6. Google Ads	„@google-ads.csv Сравни разхода по кампания с продажбите от Google Ads в магазина.“	Виждате коя кампания връща парите си. Магазинът разпознава клика от Google Ads по gclid, а UTM проследяването е в CC Pro и CC Master.
7. TikTok	„@tiktok-ads.csv Сравни разхода в TikTok с поръчките от TikTok Ads в магазина и напиши 3 идеи за кратко видео за най-продавания продукт.“	Магазинът разпознава клика от TikTok Ads по ttclid, а видеото показва продукта, който вече се купува.
8. Search Console	„@search-console.csv Кои продуктови страници имат много показвания и малко кликове? Предложи нови SEO заглавия.“	По-ясното заглавие вдига кликовете без нова реклама.
9. Бавните продукти	„Кои продукти нямат продажба от 60 дни, а са в наличност? Предложи 15% намаление до неделя.“	Освобождава стока и пари, без да намалявате всичко.
10. Фийд за Google и Pazaruvaj	„Провери кои продукти нямат марка, код или снимка.“	С пълни данни по-малко продукти се отхвърлят във фийдовете.
11. Наличности	„Кои продукти са под 5 бройки и се продават всяка седмица? Направи таблица за поръчка към доставчика.“	Най-продаваното не свършва в най-силната седмица.

Данните на CloudCart Gemini CLI чете сам. Данните от Meta Ads Manager, Google Ads, TikTok Ads Manager и Search Console не са в магазина, затова му ги давате като експорт в CSV с @. Отчетите искат само четене, затова за тях е най-сигурен отделен ключ „Само четене“. Повече по всяка тема: 10-те KPI метрики, които AI агентът смята вместо вас, какво да проверите в мобилната версия, имейл кампания в CloudCart стъпка по стъпка, реклама във Фейсбук и Инстаграм, реклама в Гугъл за онлайн магазин, TikTok Shop и реклама в TikTok и Google Search Console за онлайн магазин. Още 30 готови изречения има в статията промпт за AI агента.

Кои метрики да питате Gemini CLI всяка седмица

Седем метрики показват дали онлайн магазинът расте: сесии, конверсия, средна поръчка, изоставени колички, връщащи се клиенти, продажби по източник и целевите страници, които продават. Всички са в таблото с анализи в админа на CloudCart, а конверсията има и разбивка телефон и компютър. Gemini CLI ги чете през ключа (Admin GraphQL API има отделна заявка за отчетите от анализите) и ги сравнява с предния период в един отговор, без да отваряте екрана.

Метрика	Какво показва	Изречението към Gemini CLI
Сесии	Колко посещения е имал магазинът (не уникални хора)	„Колко сесии имахме тази седмица спрямо миналата?“
Конверсия	Какъв дял от сесиите завършва с поръчка, с разбивка телефон и компютър	„Каква е конверсията на телефон и на компютър за 30 дни?“
Средна поръчка	Средната стойност на една поръчка	„Как се промени средната поръчка след промоцията?“
Изоставени колички	Колко колички не стигат до поръчка	„Какъв е делът на изоставените колички и кои продукти остават в тях?“
Връщащи се клиенти	Колко от купувачите поръчват пак	„Колко клиенти поръчаха втори път през последните 90 дни?“
Продажби по източник	Откъде идват поръчките: Google, Facebook, TikTok, директно; кликът от реклама се разпознава по gclid, fbclid и ttclid	„Кой източник донесе най-много продажби този месец?“
Целеви страници по продажби	През кои страници влизат клиентите, които после купуват	„Кои 5 страници за вход носят най-много продажби?“

Ползата от агента е в съчетанието: „конверсията на телефон падна, а изоставените колички растат“ е извод от два екрана, който Gemini CLI прави сам. Как се смята всяка метрика и какви стойности са нормални, е описано в статията конверсия на онлайн магазин.

Какво печелите, като управлявате магазина през Gemini CLI

AI агентът спестява време там, където админът иска много кликове или сметки на ръка. Ползата се вижда в пет неща:

• Едно изречение вместо много екрани. В магазина dabov.coffee едно изречение намира 3 кафета „Хаус бленд“, показва новите цени с −20% и ги записва. В админа това са десетки кликове (примерът е на страницата AI интеграция с CloudCart).
• Числа, съчетани в един отговор. Агентът взима средната поръчка, най-продаваното и ниските наличности наведнъж и казва „трите най-продавани продукта свършват до 10 дни“.
• Масови промени с проверка. SEO заглавия на 500 продукта при лимит от 300 заявки в минута отнемат минути. Описано е подробно в масова промяна на цени, наличности и SEO текстове.
• Ритъм без забравяне. Едно изречение всяка сутрин дава отчета за продажби, склад и колички (вижте отчет за продажбите в 8:00).
• Контрол у вас. Ключът определя какво може агентът, а при 10 или повече продукта той показва промяната и чака вашето „да“.

Колко часа месечно спестява агентът в един магазин, е сметнато в статията AI агент за онлайн магазин: колко часа и пари спестява.

Безопасно ли е да дадете PAT токен на Gemini CLI

Да, ако ключът има точно толкова права, колкото задачата иска. Gemini CLI няма собствен акаунт в магазина: работи с ключа, който сте създали, и само в неговите граници.

Ниво на достъп	Какво позволява	Кога да го изберете
Само четене (препоръчано)	Вижда всичко, не променя нищо	Отчети, въпроси, първите дни с асистента
Пълен достъп	Чете и променя всичко	Когато Gemini CLI създава и управлява магазина
Избрани права	Само избрани раздели: продукти, поръчки, клиенти, наличности, намаления, блог, настройки, webhooks	Когато асистентът работи само в част от магазина

• Срок и IP адреси. Задавате дата, след която ключът спира, и до 20 адреса или мрежи, от които работи. Без IP списък ключът работи отвсякъде, затова го пазете като парола.
• Спиране. Изключвате ключа с превключвателя или го изтривате завинаги. Достъпът спира веднага. На компютъра cloudcart auth logout изчиства входа.
• Отделен ключ за всяка задача. До 100 ключа на магазин. В списъка виждате кога всеки е ползван успешно за последно.
• Масовите промени. Уменията на CloudCart в Gemini CLI показват броя и първите 5 продукта при 10 или повече и чакат потвърждение. Преди изтриване питат винаги. При 100 или повече реда първо записват текущите стойности в CSV файл и минават „на сухо“.

Данните, които Gemini CLI чете от магазина, се обработват от Google по условията на вашия ключ или лиценз. Ако не искате личните данни на клиентите да минават през асистента, дайте му ключ с избрани права без „Клиенти“ и „Поръчки“.

Gemini CLI, Claude Code или Codex: кой AI агент да изберете

Изречението за свързване с CloudCart е едно и също за всички агенти. Разликата е в абонамента и в това какво слага CloudCart.

	Gemini CLI	Claude Code	ChatGPT Codex
Ръчно свързване	gemini extensions install с адреса на ai-toolkit	Плъгин cloudcart-plugin	codex mcp add за Dev MCP
Умения на CloudCart	Да	Да	Не, постоянни инструкции във файла с инструкции
Справочник	Сваля се при първото ползване	Обновява се сам	Копие на справочника
Чий абонамент	Ключ за Gemini API или Code Assist (Google)	Абонамент Claude или ключ за API (Anthropic)	ChatGPT (OpenAI)
Подходящ, ако	Плащате Google Cloud или API по използване	Искате най-пълната връзка с CloudCart	Вече плащате ChatGPT

Ръководствата за другите агенти: Claude Code за онлайн магазин и онлайн магазин с ChatGPT и Codex.

Какво Gemini CLI не прави вместо вас

• Договорите. Асистентът настройва куриера и плащането в админа, но договорите с Еконт, Спиди или BOX NOW сключвате вие.
• Файловете на компютъра ви. Таблицата от доставчика, снимките и експортите от рекламите трябва да му ги дадете.
• Фактите за продуктите. Моделът може да измисли размер или състав. Давайте му данните и проверявайте описанията, особено при храни, козметика и детски стоки.
• Пускането на кампании. Имейл кампанията остава чернова, докато не я пуснете сами от Marketing Suite.
• Решенията. Какво продавате, на каква цена и на кого решавате вие.

Чеклист за първата седмица с Gemini CLI

• Платен ключ за Gemini API или фирмен лиценз Code Assist, проверен с /about.
• Отделна папка за магазина и файл GEMINI.md с правилата.
• Ключ „Само четене“ за отчетите, отделен ключ с пълен достъп за промените.
• Срок на ключа и IP адресът на компютъра ви, ако работите от едно място.
• Нови продукти само като чернови, преглед в админа, после активиране.
• Седмичен отчет и дял на посещенията от телефон.
• SEO заглавия на 20-те най-продавани продукта.
• Проверка на /stats model в края на седмицата, за да знаете разхода.

Създайте магазин за €1 и свържете Gemini CLI към него. Въпросите си пишете на support@cloudcart.com.

Често задавани въпроси