OpenParable
Skip to content
← Back to skills

Commerce Engine Setup

Apps & Automation
commerce-engine-setup

Commerce 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`.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  1. Install or link the CLI and choose a SQLite database path.
  2. Initialize sync and keys if you need sequencer replication.
  3. Seed demo data and verify the environment.
  4. 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 --apply for writes and stateset-doctor for 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 link or install @stateset/cli globally.
  • 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