SpinDB

$ spindb create myapp$ spindb start myapp$ spindb connect myapp$ spindb run myapp -c "SELECT version()"$ spindb run myapp ./schema.sql$ spindb backup myapp --format sql$ spindb url myapp --copy

$ spindb create logs -e mongodb --start$ spindb run logs -c "db.users.insertOne({name: 'Alice'})"$ spindb run logs -c "db.users.find().pretty()"$ spindb connect logs$ spindb backup logs --format archive

$ spindb create cache -e redis --start$ spindb run cache -c "SET mykey myvalue"$ spindb run cache -c "GET mykey"$ spindb connect cache$ spindb connect cache --iredis

$ spindb create mydb -e [engine] --start$ spindb connect mydb$ spindb backup mydb$ spindb restore mydb backup.dump$ spindb clone mydb mydb-copy$ spindb delete mydb -f

$ spindb create mydb -e postgres$ spindb create mydb -e mysql --db-version 8$ spindb create mydb --start$ spindb create mydb --from backup.sql$ spindb start mydb$ spindb stop mydb$ spindb stop --all$ spindb delete mydb -f

$ spindb list$ spindb list --json$ spindb info mydb$ spindb ports$ spindb ports --running$ spindb logs mydb$ spindb logs mydb -f$ spindb logs mydb --editor

# Native shells$ spindb connect mydb$ spindb connect mydb -d analytics
# Enhanced shells$ spindb connect mydb --pgcli$ spindb connect mydb --mycli$ spindb connect mydb --litecli$ spindb connect mydb --iredis$ spindb connect mydb --dblab$ spindb connect mydb --ui

# Run inline commands$ spindb run mydb -c "SELECT 1"$ spindb run mydb ./schema.sql$ spindb run mydb -d analytics ./init.sql
# Structured output$ spindb query mydb "SELECT * FROM users"$ spindb query mydb "SELECT * FROM users" --json

$ spindb backup mydb$ spindb backup mydb --format sql$ spindb backup mydb --format custom$ spindb backup mydb -o ~/backups$ spindb backup mydb -d analytics
$ spindb restore mydb ./backup.sql$ spindb restore mydb --from-url "postgresql://user:pass@host/db"

# Clone locally$ spindb stop mydb$ spindb clone mydb mydb-copy$ spindb start mydb-copy
# Pull from remote (auto-backup before replace)$ spindb pull mydb --from "postgresql://user:pass@prod/db"$ spindb pull mydb --from-env PROD_DB_URL$ spindb pull mydb --from-env PROD_DB_URL --as mydb_prod$ spindb pull mydb --from-env PROD_DB_URL --dry-run

$ spindb url mydb$ spindb url mydb --copy$ spindb url mydb -d analytics$ spindb url mydb --json
# Use in your app$ export DATABASE_URL=$(spindb url mydb)$ psql $(spindb url mydb)

$ spindb databases create mydb analytics$ spindb databases rename mydb old_name new_name$ spindb databases drop mydb analytics --force$ spindb databases list mydb$ spindb databases set-default mydb prod$ spindb databases refresh mydb

$ spindb users create mydb$ spindb users create mydb devuser$ spindb users create mydb --password p$ spindb users create mydb --copy$ spindb users create mydb --json$ spindb users list mydb

# Export connection string$ export DATABASE_URL=$(spindb url mydb)
# Backup all PostgreSQL containers$ for c in $(spindb list --json | jq -r \    '.[] | select(.engine=="postgresql") | .name'); do    spindb backup "$c" -o ./backups/  done
# Check if running$ if spindb info mydb --json | \    jq -e '.status == "running"' > /dev/null; then    echo "Container is running"  fi

# .github/workflows/test.yml$ - name: Install SpinDB    run: pnpm add -g spindb
$ - name: Install database tools    run: spindb deps install --engine postgresql
$ - name: Create test database    run: spindb create testdb --start
$ - name: Run migrations    run: spindb run testdb ./schema.sql
$ - name: Run tests    run: npm test

$ spindb config show$ spindb config detect$ spindb config set psql /opt/pg/bin/psql$ spindb config unset psql$ spindb config update-check on$ spindb engines$ spindb engines download postgresql 18$ spindb deps check$ spindb deps install

# Port conflict$ spindb create mydb --port 5433
# Container won't start$ spindb logs mydb
# Health check$ spindb doctor$ spindb doctor --fix$ spindb doctor --dry-run
# Reset everything$ rm -rf ~/.spindb