douglance/spacetimedb/spacetimedb-cli

# Initialize new project
spacetime init my-project --lang rust|csharp|typescript
spacetime init my-project --template <template-id>
 
# Build module
spacetime build                    # release build
spacetime build --debug            # faster iteration, slower runtime
 
# Dev mode (auto-rebuild, auto-publish, generates bindings)
spacetime dev
spacetime dev --client-lang typescript --module-bindings-path ./client/src/module_bindings
 
# Generate client bindings
spacetime generate --lang typescript|csharp|rust|unrealcpp --out-dir ./bindings

# Publish to Maincloud (default)
spacetime publish my-database --yes
 
# Publish to local server
spacetime publish my-database --server local --yes
 
# Publish with data handling
spacetime publish my-database --delete-data always      # always clear data
spacetime publish my-database --delete-data on-conflict # clear only if schema conflicts
spacetime publish my-database --delete-data never       # never clear (default)
 
# Allow breaking client changes
spacetime publish my-database --break-clients

# SQL queries
spacetime sql my-database "SELECT * FROM users"
spacetime sql my-database --interactive   # REPL mode
 
# Call reducers
spacetime call my-database my_reducer '{"arg1": "value", "arg2": 123}'
 
# Subscribe to changes
spacetime subscribe my-database "SELECT * FROM users" --num-updates 10
 
# View logs
spacetime logs my-database -f              # follow logs
spacetime logs my-database -n 100          # last 100 lines
 
# Describe schema
spacetime describe my-database --json
spacetime describe my-database table users --json
spacetime describe my-database reducer my_reducer --json

# List databases
spacetime list
 
# Delete database
spacetime delete my-database
 
# Rename database
spacetime rename <database-identity> --to new-name

# List configured servers
spacetime server list
 
# Add server
spacetime server add local http://localhost:3000 --default
spacetime server add myserver https://my-spacetime.example.com
 
# Set default server
spacetime server set-default local
 
# Test connectivity
spacetime server ping local
 
# Start local instance
spacetime start
 
# Clear local data
spacetime server clear

# Login (opens browser)
spacetime login
 
# Login with token
spacetime login --token <token>
 
# Show login status
spacetime login show
 
# Logout
spacetime logout

spacetime energy balance
spacetime energy balance --identity <identity>

# 1. Login
spacetime login
 
# 2. Create project
spacetime init my-game --lang rust
cd my-game
 
# 3. Start dev mode (auto-rebuilds and publishes)
spacetime dev

# Start local server (in separate terminal)
spacetime start
 
# Publish to local
spacetime publish my-db --server local --delete-data always --yes
 
# Query local database
spacetime sql my-db --server local "SELECT * FROM players"

# After building module
spacetime build
spacetime generate --lang typescript --out-dir ./client/src/bindings
 
# Or use dev mode which auto-generates
spacetime dev --client-lang typescript --module-bindings-path ./client/src/bindings

spacetime login
# Or use --anonymous for public operations

spacetime server ping <server>
# For local: ensure spacetime start is running

# Clear data and republish
spacetime publish my-db --delete-data always --yes

# Check Rust/C# toolchain
rustup show
# For Rust modules, ensure wasm32-unknown-unknown target
rustup target add wasm32-unknown-unknown