Use the StoreFront CLI with Gemini CLI (Enterprise and API key)
:::note Gemini CLI moved to Antigravity Since June 18, 2026, Gemini CLI no longer serves personal Google accounts (free, Google AI Pro and Google AI Ultra). Google moved those users to the Antigravity CLI. If you sign in with a personal Google account, follow Use the StoreFront CLI with Google Antigravity instead. This page is for Gemini CLI with an Enterprise (Gemini Code Assist) license or an API key, which Google still supports. :::
Gemini CLI reads project skills from the workspace's .agents/skills/ folder, the same copy Codex and Antigravity use. Status: Documented, Enterprise and API-key accounts only. init installs the skill for Gemini CLI, but a Gemini CLI session discovering it has not been through the same acceptance run as Claude Code and Codex.
Prerequisites
- Node.js 24 or newer, with npm (
node -v). - Gemini CLI installed, with an Enterprise (Gemini Code Assist) license or an API key. A personal Google account no longer works with Gemini CLI.
- An UltraCart account whose user has StoreFront access.
Install the CLI and the skill
npm install -g @ultracart/storefront-cli@beta
uc-storefront --version
uc-storefront init my-storefront --target gemini
cd my-storefront
uc-storefront skills status
When Gemini CLI runs init for you, have it add --no-input, because its shell cannot answer prompts.
Confirm Gemini CLI sees the skill
The skill lands in my-storefront/.agents/skills/build-ultracart-storefronts/.
- Trust the workspace folder. Gemini CLI skips project skills in an untrusted folder. Mark the workspace folder as trusted in Gemini CLI before you look for the skill.
- Start Gemini CLI from inside the workspace folder (the one with
ultracart.json). - Ask it to list its skills and look for
build-ultracart-storefronts.
If uc-storefront skills status warns about a duplicate copy at .gemini/skills/build-ultracart-storefronts, the .agents/skills copy may take precedence. Check which copy Gemini CLI actually loads before you rely on it.
Sign in
On a desktop, the sign-in goes into the operating system's keychain. Run uc-storefront auth login --profile my-store yourself, or let Gemini CLI sign in with the two-step flow:
uc-storefront profile create my-store
uc-storefront auth login --profile my-store --no-wait
uc-storefront auth login --profile my-store --continue --wait
uc-storefront profile bind my-store
The first command prints a URL and a code and exits at once; you approve in your own browser. The second waits up to 45 seconds and exits 0 once signed in or 3 while still waiting, so the agent runs it again until it exits 0.
Caveats
- The trust setting is the usual reason the skill does not appear.
skills statusconfirms the files are present; it cannot tell whether Gemini CLI loaded them. - Gemini CLI, Antigravity and Codex share one copy. Removing one target keeps the copy the other needs.
Next steps
- Connect your store: profiles, binding and how long a sign-in lasts
- Safety and human approval: read before the first live change
- What it can do: the areas Gemini CLI can work on with the skill