Skip to main content
Fox is the built-in AI operator that ships inside Vulpy Commerce. It runs as the Hermes agent container: one host-level container that boots your shop from a fresh install, runs it day to day, and knows what state your dev environment is in. Fox is the product’s core, not an add-on.
Just ask Fox. Every page in these docs is a reference; Fox is the working knowledge. Open the WebUI and let it show you around.Try prompts like:
  • “What can you do for me right now?”
  • “Take me on a tour of the WebUI.”
  • “What’s my shop’s current state?”

​
What Fox does

  • Boots the shop. From a fresh install, Fox brings up the storefront, Medusa, and Postgres, runs migrations, seeds the catalog, and verifies the shop is healthy through the welcome flow.
  • Runs the store. Product and catalog work, content, orders, and analytics: Fox works in the same checkout as you and does the operational work through the Vulpy WebUI.
  • Knows its environment. The side panel and env-context features show live shop state; env-actions perform safe, approved operations on your dev environment.
  • Grows with you. A guided missions system turns “set up my store” into a managed process, not a manual runbook, and continues into ongoing operational missions.

​
Where Fox runs

Fox is a single container defined in docker-compose.hermes.yml. Start it locally with pnpm db:hermes:up and open the Vulpy WebUI at http://localhost:8787. On a VPS, Fox joins its own Tailscale identity via a sidecar and serves HTTPS on its MagicDNS name.
Default install ships dev plus Fox only. Staging and live are added later by a human with pnpm vulpy env add live. Fox has no Docker socket and cannot create environments; environment commands refuse inside the Hermes container.

The Vulpy WebUI

Tour the six built-in experience features that make up the Fox control surface.

Missions

First-boot onboarding and ongoing guided operations.

Environment context

Live shop state and safe, approved dev-only actions.

Manage your catalog

Run product and category work with Fox and the admins.