Spree Commerce
Rails commerce platform whose official CLI calls the Admin API directly, built for scripts and agents.
Open-source headless e-commerce platform in Ruby on Rails with an admin dashboard, REST Admin and Store APIs with OpenAPI spec, a TypeScript SDK, and a Next.js storefront. The Builder ships @spree/cli, whose spree api get/post/patch/delete commands drive the Admin API with zero-config local credentials, plus 25 agent skills and a docs MCP. BSD-3-Clause; Enterprise is paid.
- I want a Rails store for cross-border or B2B selling that my coding agent can extend using the Builder's own skills
- my agent should query and update the store from the terminal with one API key
- The MCP the Builder publishes is docs-only (search and read); store operations go through the CLI or REST
- Auto-minted local keys are read_all only; write scopes need an explicit key
- Needs Node 22+ and Docker for the quickstart
Last activity Sep 2, 2026. Fit: adaptable 3, operable 3.
Editions
Open source · Free open source
- Clone
git clone https://github.com/spree/spree - HostedOpen the hosted app
Enterprise · Free closed source
- HostedOpen the hosted app
Adaptable: what is yours to change
Make it yours
Light edit6 things to edit
create-spree-app scaffolds a Rails project you own (backend, admin, Next.js storefront). Store settings, markets, channels, and themes are managed in the admin. The CLI reads SPREE_API_KEY and SPREE_BASE_URL, keeps profiles in ~/.config/spree/config.json and project keys in .spree/credentials.json. Custom resources and storefront changes are small edits in generated files, guided by the Builder's agent skills.
- Env vars
SPREE_API_KEYSPREE_BASE_URL- Config files
config/initializers/spree.rb.spree/credentials.json~/.config/spree/config.json- Prompt files
agent skills from spree/agent-skills (npx skills add spree/agent-skills)- Accounts you need
- Spree Cloud sandbox (optional)Stripe (storefront payments)
Source
- github.com/spree/spree
- BSD-3-Clause license
- Last commit Sep 2, 2026
- 15,661 stars
Also: spree/agent-skills
Operable: what an agent can drive
Interface
OfficialCLIpublished by the builderremote or local
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
Reach
Partial coverage. 8 of 9 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Manage products, variants, prices | Reachable | README: spree api post /products example; Admin API |
| Manage orders | Reachable | README: spree api get /orders -q status_eq=complete |
| Customers, companies, customer groups | Reachable | Admin API resources; spree api endpoints lists routes and scopes |
| Promotions and gift cards | Reachable | Admin API; feature list names promotions engine |
| Markets, price lists, sales channels | Reachable | Admin API resources per feature list |
| Storefront shopping and checkout | Reachable | Store API with publishable keys; TypeScript SDK |
| Generate new API resources and run migrations | Reachable | spree generate api_resource, spree dev |
| Read the docs | Reachable | docs MCP at spreecommerce.org/docs/mcp (search and read only) |
| Enterprise-only features | Not reachable | paid Enterprise edition |
Code stack
- Languages
- RubyTypeScript
- Frameworks
- Ruby on RailsNext.js 16
- Package manager
- bundler
- Database
- PostgreSQL
- Hosting target
- DockerSpree Cloud sandbox
- Built
- Human-written (recorded, never ranked)
Skills
Spree publishes an agent-skills plugin covering the admin, API, checkout, catalog and customization surface; the core repo separately carries contributor-only design skills.
- Kind
- bundled
- Paths
skills/*/SKILL.md- Install
/plugin marketplace add spree/agent-skills
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | README: Rails backend with admin dashboard and Next.js storefront | 95% |
| executionModel | no model at runtime | 95% |
| operability | packages/cli in the spree repo; docs at spreecommerce.org describe spree api commands 'built for scripts and AI agents' | 90% |
| effort | CLI docs name SPREE_API_KEY and SPREE_BASE_URL and config paths; generators documented | 75% |
| editions | README: everything in the repo is BSD-3; Enterprise exists per triage | 60% |
| active | pushedAt 2026-09-02 | – |
| reach | 85% |
Open questions
- Enterprise pricing and feature split
- Rails-side env var names (DATABASE_URL, SECRET_KEY_BASE) in the generated project
Sources
- github.com/spree/spree sourcing:ecommerce:github
- spreecommerce.org/docs/developer/agentic/mcp analysis
- spreecommerce.org/docs/developer/cli/admin-api analysis