Use this skill for spacetime command-line workflows.
Core patterns
- Local iteration usually starts with
spacetime dev; use--template,--client-lang,--module-path, and--module-bindings-pathwhen the project layout is not the default. - Module lifecycle commands are
spacetime init,spacetime build,spacetime publish, andspacetime generate. - Runtime/debug commands are
spacetime call [DATABASE] <FUNCTION> [ARGS...],spacetime sql [DATABASE] "<QUERY>",spacetime logs [DATABASE], andspacetime describe --json [DATABASE]. spacetime generatesupports--lang csharp|typescript|rust|unrealcpp,--out-dir,--module-path, and--include-private.spacetime publish [name|identity]builds by default. Use--serverfor non-default hosts and read migration guidance before--break-clientsor--delete-data.- Database names are lowercase ASCII words separated by hyphens.
Common command shapes
spacetime dev --template basic-ts
spacetime build --module-path spacetimedb
spacetime publish my-database
spacetime generate --lang typescript --out-dir client/src/module_bindings --module-path spacetimedb
spacetime call my-database add Alice
spacetime sql my-database "SELECT * FROM person"
spacetime logs my-database --follow --level info
Reference map
| Need | Open |
|---|---|
| Command syntax and flags | references/cli-reference.md |
| Standalone server config | references/cli-reference-standalone-config.md |
Guidance
- Prefer exact CLI flags from the reference when writing final commands for uncommon options.
- Keep
spacetime generatelanguage, output directory, and module/database name aligned with the client SDK being used. - Route publishing and migration behavior to spacetimedb-databases when schema changes matter.