Commerce Engine Setup
Apps & Automationcommerce-engine-setupCommerce Engine Setup is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Set up and run the StateSet iCommerce engine locally (CLI install, DB init, demo data, sync). Use when bootstrapping an environment, running `stateset-doctor`, or starting `stateset-autonomous`.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/commerce-engine-setup/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/commerce-engine-setup, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Commerce Engine Setup
Set up local iCommerce runtime, CLI tooling, and optional sync.
How It Works
- Install or link the CLI and choose a SQLite database path.
- Initialize sync and keys if you need sequencer replication.
- Seed demo data and verify the environment.
- Start CLI commands or the autonomous engine.
Usage
- Install CLI locally:
cd /home/dom/stateset-icommerce/cli && npm install && npm link - Use
stateset --db ./store.db "list customers"for read-only actions. - Add
--applyfor writes andstateset-doctorfor checks. - Seed demo data:
bash /mnt/skills/user/commerce-engine-setup/scripts/seed-demo.sh - Verify setup:
bash /mnt/skills/user/commerce-engine-setup/scripts/verify-setup.sh - Start autonomous mode:
stateset-autonomous start --db ./.stateset/commerce.db
Output
{"status":"ok","db":"./store.db","sync":"disabled","autonomous":"stopped"}
Present Results to User
- Steps completed and any scripts run.
- Database path and whether sync is initialized.
- Autonomous engine status if started.
Troubleshooting
- CLI not found: re-run
npm linkor install@stateset/cliglobally. - Database locked: close other processes using the DB file.
- Sequencer unreachable: verify Docker services and URLs.
References
- references/setup-runbook.md
- /home/dom/stateset-icommerce/examples/README.md
- /home/dom/stateset-icommerce/examples/getting-started-sync.md
- /home/dom/stateset-icommerce/cli/README.md
- /home/dom/stateset-icommerce/cli/bin/stateset-autonomous.js