Hand your StoreFront to your agent.
The uc-storefront CLI lets Claude Code, Codex, Hermes Agent or any agent that runs shell commands build and edit your StoreFront. You describe the change. The agent makes it with UltraCart's own commands, shows you a preview, and stops for your approval before anything risky.
Read https://www.ultracart.com/theme/assets/storefront-agent-toolchain.txt. The UltraCart StoreFront CLI is in public beta. Follow the brief to install it and set it up for me, and ask before you install anything or sign in.Paste this into your agent and it installs and sets up the toolchain for you.
Three steps to your first change
1. Install the CLI
Needs Node.js 24 or newer. The package is @ultracart/storefront-cli and the command is uc-storefront.
npm install -g @ultracart/storefront-cli@beta
uc-storefront --version
2. Create a workspace with the agent skill
Name your agent with --target: claude, codex, gemini or hermes.
uc-storefront init my-storefront --target claude
cd my-storefront
uc-storefront skills status
3. Connect your store
You approve the sign-in in your own browser. The CLI never sees your password or an API key.
uc-storefront profile create my-store
uc-storefront auth login --profile my-store
uc-storefront profile bind my-store
uc-storefront sf storefronts
Start somewhere safe
- Try it first on a test storefront or an inactive theme. Item content, menus and site settings are shared by every theme, so those changes go live at once. What is shared
- Setup for your agent: Agents and environments
- Stuck? Troubleshooting
Pick where your agent runs
Claude Code
On your computer. init --target claude.
Codex
On your computer. init --target codex.
Hermes Agent
On your computer or hosted, with the skill in the Hermes home.
Grok Bot
Hosted, with the sign-in key in a Grok secret.
OpenClaw
Reads the workspace skill. Uses the keychain on a desktop.
Google Antigravity
The CLI, IDE or app. init --target gemini installs the skill it reads.
Cursor, Copilot, OpenCode
Any agent with a shell can run the CLI.
Docker, Fly.io and CI
Containers with no keychain, using an encrypted sign-in file and a credential key.
Describe the change in plain language
“Rework the site header: logo left, a mega menu with the top categories, cart and account on the right. Show me a preview.”
“Restructure the single-page checkout into two columns with a sticky order summary. Work on the inactive theme.”
“Update the SEO title and description for the waxed field jacket.”
“Create a draft flow for abandoned carts with a one-hour wait, then a reminder email. Leave it off.”
“How is the hero experiment doing? Is it time to act?”
“Which ten pages had the most sessions last week, and what was their conversion rate?”
One page per area of your store
Pages and themes
Pages, headers, footers, templates, theme settings and upgrades.
Menus, search and site settings
Menus, site attributes, SEO settings, sitemaps and search facets.
Library and reusable content
Install, save and share reusable sections from the element library.
Checkout and My Account
Restyle and restructure checkout and the customer account area.
Items
Item content, attributes, SEO fields, prices and pre-orders.
Upsells
Post-checkout offers and paths, built switched off.
Communications
Campaigns, flows, segments, emails and postcards, previewed without sending.
Experiments
A/B tests on pages and URLs, and reading their results.
Analytics and tracking
BigQuery reporting, screen recordings, render logs and conversion tracking.
Languages
Turn on languages and manage translated text.
Redirects and 404s
Redirect rules and the pages shoppers hit when a link is wrong.
Blog posts
Write, edit and publish posts.
Surveys
Build surveys and read their answers.
Files and assets
Images, responsive image sizes, scripts and stylesheets in the file manager.
Snapshots and reports
Record the layout at handoff, compare it later, and share a PDF.
Built so an agent cannot quietly break your store
How changes are guarded
- The agent works in a local folder, validates every change, and keeps the original so it can be undone.
- Previews are private to you. A write is refused if someone changed the page since the agent read it.
- A change to your live store needs an explicit acknowledgement from the agent.
- Deletions, price changes, enabling upsells and other risky actions wait for you to approve them in the UltraCart admin with your authenticator app. The agent cannot approve its own requests.
Good to know
- Every active UltraCart merchant account can use the beta. The toolchain is free; you bring your own agent. Some features the agent can turn on, such as translation or postcards, are billed as usual.
- Your sign-in is kept in your operating system's keychain, whichever agent you run. Only containers and cloud agents need a credential key. See Connect your store.
- A sign-in works only from IP addresses you approve, so run your agent from a stable address. A cloud agent can route through your home or office, for example with a Tailscale exit node. See Approved addresses and a stable IP.
- It is a CLI, not an MCP server. If you want your AI app to read these docs instead, see the docs MCP server.