Skip to main content

Canonical Commands

Use run.sh from the repo root whenever possible:

What To Use For Common Jobs

Repo Interrogation Order

When you need to confirm whether something is current or canonical:
  1. Check the repo README.md.
  2. Check run.sh for command behavior.
  3. Check the relevant package package.json.
  4. Check the nearest package README or docs page.
  5. Search the repo with rg.

Verification Rules Of Thumb

  • Scaffolder changes: ./run.sh test create-elata-demo
  • Consumer onboarding or packaging changes: pnpm smoke:consumers
  • run.sh changes: run the narrowest affected command, then broaden if release paths changed
  • Release tooling changes: ./run.sh verify-all if feasible
  • Docs that mention onboarding: verify the create-elata-demo path and the parent-workspace caveat

Backward Compatibility Notes

  • scripts/dev-link.sh remains a thin wrapper around run.sh sync-to.
  • sync-to remains useful for local packages/eeg-web development.
  • Consumer onboarding should still point to create-elata-demo, not sync-to.
If you are debugging beyond package boundaries, also use the public protocol repo:
  • ../elata-protocol for contracts, local Anvil deployments, config generation, XP tooling, and simulations
See Related Repos for the developer-focused map.