spindb 0.15.2 → 0.17.3

package/README.md

@@ -7,7 +7,7 @@
 
 **The first npm CLI for running local databases without Docker.**
 
-Spin up PostgreSQL, MySQL, MariaDB, SQLite, MongoDB, and Redis instances for local development. No Docker daemon, no container networking, no volume mounts. Just databases running on localhost, ready in seconds.
+Spin up PostgreSQL, MySQL, MariaDB, SQLite, MongoDB, Redis, and Valkey instances for local development. No Docker daemon, no container networking, no volume mounts. Just databases running on localhost, ready in seconds.
 
 ---
 
@@ -136,7 +136,7 @@ You'll get an interactive menu with arrow-key navigation:
 
 | | |
 |---|---|
-| Versions | 14, 15, 16, 17, 18 |
+| Versions | 15, 16, 17, 18 |
 | Default port | 5432 |
 | Default user | `postgres` |
 | Binary source | [hostdb](https://github.com/robertjbass/hostdb) (macOS/Linux), [EDB](https://www.enterprisedb.com/) (Windows) |
@@ -177,43 +177,39 @@ MariaDB is MySQL-compatible, so most MySQL tools and clients work seamlessly. If
 
 | | |
 |---|---|
-| Versions | Depends on system installation |
+| Versions | 8.0, 8.4, 9 |
 | Default port | 3306 |
 | Default user | `root` |
-| Binary source | System installation |
+| Binary source | [hostdb](https://github.com/robertjbass/hostdb) |
 
-Unlike PostgreSQL, SpinDB uses your system's MySQL installation. While Oracle provides MySQL binary downloads, they require system libraries and configuration—there's no "unzip and run" distribution like zonky.io provides for PostgreSQL. For most local development, a single system-installed MySQL version works well.
+SpinDB downloads MySQL server binaries automatically from [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases—just like PostgreSQL and MariaDB. This provides multi-version support and works across all platforms.
 
 ```bash
-# macOS
-brew install mysql
-
-# Ubuntu/Debian
-sudo apt install mysql-server
-
-# Windows (Chocolatey)
-choco install mysql
+# Create a MySQL container
+spindb create mydb --engine mysql
 
-# Windows (winget)
-winget install Oracle.MySQL
+# Create with specific version
+spindb create mydb --engine mysql --version 8.0
 
-# Check if SpinDB can find MySQL
+# Check what's available
 spindb deps check --engine mysql
 ```
 
-**Linux users:** MariaDB is also available as a standalone engine with downloadable binaries. Use `spindb create mydb --engine mariadb` for the dedicated MariaDB engine.
+**Client tools included:** MySQL binaries include `mysql`, `mysqldump`, and `mysqladmin` for all operations. No system installation required.
 
 #### SQLite
 
 | | |
 |---|---|
-| Version | 3 (system) |
+| Version | 3 |
 | Default port | N/A (file-based) |
 | Data location | Project directory (CWD) |
-| Binary source | System installation |
+| Binary source | [hostdb](https://github.com/robertjbass/hostdb) |
 
 SQLite is a file-based database—no server process, no ports. Databases are stored in your project directory by default, not `~/.spindb/`. SpinDB tracks registered SQLite databases in a registry file.
 
+**Tools included:** SQLite binaries include `sqlite3`, `sqldiff`, `sqlite3_analyzer`, and `sqlite3_rsync`. No system installation required.
+
 ```bash
 # Create in current directory
 spindb create mydb --engine sqlite
@@ -234,25 +230,21 @@ spindb connect mydb --litecli
 
 | | |
 |---|---|
-| Versions | 6.0, 7.0, 8.0 |
+| Versions | 7.0, 8.0, 8.2 |
 | Default port | 27017 |
 | Default user | None (no auth by default) |
-| Binary source | System installation |
+| Binary source | [hostdb](https://github.com/robertjbass/hostdb) |
 
-Like MySQL, SpinDB uses your system's MongoDB installation. While MongoDB provides official binary downloads, they require additional configuration and system dependencies. SpinDB relies on your package manager to handle this setup.
+SpinDB downloads MongoDB server binaries automatically from [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases—just like PostgreSQL, MariaDB, and MySQL. This provides multi-version support on all platforms.
 
 ```bash
-# macOS
-brew tap mongodb/brew
-brew install mongodb-community mongosh mongodb-database-tools
+# Create a MongoDB container (downloads binaries automatically)
+spindb create mydb --engine mongodb
 
-# Ubuntu/Debian (follow MongoDB's official guide)
-# https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-ubuntu/
+# Create with specific version
+spindb create mydb --engine mongodb --version 8.0
 
-# Windows (Chocolatey)
-choco install mongodb mongodb-shell mongodb-database-tools
-
-# Check if SpinDB can find MongoDB
+# Check what's available
 spindb deps check --engine mongodb
 ```
 
@@ -273,24 +265,21 @@ spindb run mydb --file ./scripts/seed.js
 
 | | |
 |---|---|
-| Versions | 6, 7, 8 |
+| Versions | 7, 8 |
 | Default port | 6379 |
 | Default user | None (no auth by default) |
-| Binary source | System installation |
+| Binary source | [hostdb](https://github.com/robertjbass/hostdb) |
 
-Like MySQL and MongoDB, SpinDB uses your system's Redis installation. Redis provides embeddable binaries, but system packages are more reliable for handling dependencies and platform-specific setup.
+SpinDB downloads Redis server binaries automatically from [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases—just like PostgreSQL, MariaDB, MySQL, and MongoDB. This provides multi-version support on all platforms.
 
 ```bash
-# macOS
-brew install redis
-
-# Ubuntu/Debian
-sudo apt install redis-server redis-tools
+# Create a Redis container (downloads binaries automatically)
+spindb create mydb --engine redis
 
-# Windows (Chocolatey)
-choco install redis
+# Create with specific version
+spindb create mydb --engine redis --version 8
 
-# Check if SpinDB can find Redis
+# Check what's available
 spindb deps check --engine redis
 ```
 
@@ -312,6 +301,97 @@ spindb connect myredis --iredis
 
 **Note:** Redis doesn't support remote dump/restore. Creating containers from remote Redis connection strings is not supported. Use `backup` and `restore` commands for data migration.
 
+#### Valkey
+
+| | |
+|---|---|
+| Versions | 8, 9 |
+| Default port | 6379 |
+| Default user | None (no auth by default) |
+| Binary source | [hostdb](https://github.com/robertjbass/hostdb) |
+
+Valkey is a Redis fork created after Redis changed its license (RSALv2/SSPLv1). It's fully API-compatible with Redis, making it a drop-in replacement with permissive BSD-3 licensing.
+
+SpinDB downloads Valkey server binaries automatically from [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases. This provides multi-version support on all platforms.
+
+```bash
+# Create a Valkey container (downloads binaries automatically)
+spindb create mydb --engine valkey
+
+# Create with specific version
+spindb create mydb --engine valkey --version 9
+
+# Check what's available
+spindb deps check --engine valkey
+```
+
+Valkey uses the same commands as Redis:
+
+```bash
+# Set a key
+spindb run myvalkey -c "SET mykey myvalue"
+
+# Get a key
+spindb run myvalkey -c "GET mykey"
+
+# Run a command file
+spindb run myvalkey --file ./scripts/seed.valkey
+
+# Use iredis for enhanced shell experience (Redis-protocol compatible)
+spindb connect myvalkey --iredis
+```
+
+**Note:** Valkey uses `redis://` connection scheme for client compatibility since it's wire-compatible with Redis.
+
+### hostdb Platform Coverage
+
+SpinDB downloads database binaries from [hostdb](https://github.com/robertjbass/hostdb), a repository of pre-built database binaries for all major platforms. The following table shows current platform support and integration status:
+
+| Icon | Meaning |
+|:----:|---------|
+| ✅ | Integrated with SpinDB |
+| 🟦 | Pending SpinDB integration (hostdb ready) |
+| 🟪 | Planned for hostdb (pending/in-progress) |
+
+| Database | macOS ARM64 | macOS Intel | Linux x64 | Linux ARM64 | Windows x64 |
+|----------|:-----------:|:-----------:|:---------:|:-----------:|:-----------:|
+| **Integrated** |||||
+| PostgreSQL | ✅ | ✅ | ✅ | ✅ | ✅ |
+| MySQL | ✅ | ✅ | ✅ | ✅ | ✅ |
+| MariaDB | ✅ | ✅ | ✅ | ✅ | ✅ |
+| SQLite | ✅ | ✅ | ✅ | ✅ | ✅ |
+| MongoDB* | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Redis* | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Valkey | ✅ | ✅ | ✅ | ✅ | ✅ |
+| **Planned for hostdb** |||||
+| CockroachDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| TimescaleDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| DuckDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| Meilisearch | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| OpenSearch | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| QuestDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| FerretDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| TiDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| ArangoDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| Qdrant | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| Apache Cassandra | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| ClickHouse | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| InfluxDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| CouchDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| KeyDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| libSQL | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| FoundationDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+| RocksDB | 🟪 | 🟪 | 🟪 | 🟪 | 🟪 |
+
+**Notes:**
+- **\*** Licensing considerations for commercial use — consider Valkey (Redis) or FerretDB (MongoDB) as alternatives
+- **PostgreSQL** uses [EDB](https://www.enterprisedb.com/) binaries on Windows instead of hostdb
+- **Valkey** is a Redis-compatible drop-in replacement with permissive licensing
+- **CockroachDB** is planned for both hostdb and SpinDB (see [roadmap](TODO.md))
+- All databases under "Planned for hostdb" have permissive open-source licenses (Apache 2.0, MIT, or BSD)
+
+For the latest platform support, see the [hostdb databases.json](https://github.com/robertjbass/hostdb/blob/main/databases.json).
+
 ---
 
 ## Commands
@@ -349,8 +429,8 @@ spindb create mydb --from "postgresql://user:pass@host:5432/production"
 
 | Option | Description |
 |--------|-------------|
-| `--engine`, `-e` | Database engine (`postgresql`, `mariadb`, `mysql`, `sqlite`, `mongodb`, `redis`) |
-| `--db-version` | Engine version (e.g., 17 for PostgreSQL, 11.8 for MariaDB, 8 for Redis) |
+| `--engine`, `-e` | Database engine (`postgresql`, `mariadb`, `mysql`, `sqlite`, `mongodb`, `redis`, `valkey`) |
+| `--db-version` | Engine version (e.g., 17 for PostgreSQL, 11.8 for MariaDB, 8 for Redis, 9 for Valkey) |
 | `--port`, `-p` | Port number (not applicable for SQLite) |
 | `--database`, `-d` | Primary database name (Redis uses 0-15) |
 | `--path` | File path for SQLite databases |
@@ -468,6 +548,7 @@ Format by engine:
 - SQLite: `.sql` (plain SQL) / `.sqlite` (binary copy)
 - MongoDB: `.bson` (BSON dump) / `.archive` (compressed archive)
 - Redis: `.redis` (text commands) / `.rdb` (RDB snapshot)
+- Valkey: `.valkey` (text commands) / `.rdb` (RDB snapshot)
 
 <details>
 <summary>All options</summary>
@@ -622,6 +703,26 @@ Each engine has specific backup formats and restore behaviors:
 
 </details>
 
+<details>
+<summary>Valkey</summary>
+
+| Format | Extension | Tool | Notes |
+|--------|-----------|------|-------|
+| RDB | `.rdb` | BGSAVE | Binary snapshot, requires restart |
+| Text | `.valkey` | Custom | Human-readable Redis-compatible commands |
+
+**Text format detection:** Files are detected as Valkey text commands if they contain valid Redis commands (SET, HSET, DEL, etc.), regardless of file extension.
+
+**Restore behavior:** Same as Redis (Valkey is Redis-compatible).
+- **RDB (`.rdb`):** Requires stopping Valkey, copies file to data directory, restart loads data
+- **Text (`.valkey`):** Pipes commands to running Valkey instance. Prompts for:
+  - **Replace all:** Runs `FLUSHDB` first (clean slate)
+  - **Merge:** Adds/updates keys, keeps existing keys not in backup
+
+**Note:** Valkey uses numbered databases (0-15) that always exist. "Create new database" is not applicable.
+
+</details>
+
 ### Container Management
 
 #### `list` - List all containers
@@ -672,6 +773,10 @@ spindb logs mydb --editor       # Open in $EDITOR
 
 ```bash
 spindb engines                           # List installed engines
+spindb engines list --json               # JSON output
+spindb engines supported                 # List all supported engines
+spindb engines supported --json          # Full engine config as JSON
+spindb engines supported --all           # Include pending/planned engines
 spindb engines delete postgresql 16      # Delete a version (frees ~45MB)
 ```
 
@@ -682,13 +787,25 @@ ENGINE        VERSION     SOURCE            SIZE
 ────────────────────────────────────────────────────────
 🐘 postgresql 18.1        darwin-arm64      46.0 MB
 🐘 postgresql 17.7        darwin-arm64      45.2 MB
-🐬 mysql      8.0.35      system            (system-installed)
-🪶 sqlite     3.43.2      system            (system-installed)
+🐬 mysql      9.0.1       darwin-arm64      150.0 MB
+🪶 sqlite     3.51.2      darwin-arm64      5.0 MB
 ────────────────────────────────────────────────────────
 
 PostgreSQL: 2 version(s), 90.0 MB
-MySQL: system-installed at /opt/homebrew/bin/mysqld
-SQLite: system-installed at /usr/bin/sqlite3
+MySQL: 1 version(s), 150.0 MB
+SQLite: 1 version(s), 5.0 MB
+```
+
+`spindb engines supported` output:
+
+```
+🐘 postgresql
+🐬 mysql
+🦭 mariadb
+🪶 sqlite
+🍃 mongodb
+🔴 redis
+🔷 valkey
 ```
 
 #### `deps` - Manage client tools
@@ -773,6 +890,7 @@ SpinDB supports enhanced database shells that provide features like auto-complet
 | SQLite | `sqlite3` | `litecli` | `usql` |
 | MongoDB | `mongosh` | - | `usql` |
 | Redis | `redis-cli` | `iredis` | - |
+| Valkey | `valkey-cli` | `iredis` | - |
 
 **pgcli / mycli** provide:
 - Intelligent auto-completion (tables, columns, keywords)
@@ -879,42 +997,27 @@ This means Redis may lose up to ~60 seconds of writes on an unexpected crash. Fo
 ### Binary Sources
 
 **PostgreSQL:** Server binaries are downloaded automatically:
-- **All platforms (macOS/Linux/Windows for macOS/Linux via hostdb, Windows via EDB):** From [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases (macOS/Linux) or [EnterpriseDB (EDB)](https://www.enterprisedb.com/download-postgresql-binaries) (Windows)
-
-**MariaDB:** Server binaries are downloaded automatically from [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases for all platforms.
+- **macOS/Linux:** From [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases
+- **Windows:** From [EnterpriseDB (EDB)](https://www.enterprisedb.com/download-postgresql-binaries)
 
-**MySQL/MongoDB/Redis:** Uses your system installation. SpinDB detects binaries from Homebrew (macOS), apt/pacman (Linux), or Chocolatey/winget/Scoop (Windows).
+**MariaDB, MySQL, MongoDB, Redis, Valkey:** Server binaries are downloaded automatically from [hostdb](https://github.com/robertjbass/hostdb) on GitHub Releases for all platforms.
 
-### Why Precompiled Binaries for PostgreSQL and MariaDB, but System Installs for Others?
+### Why Precompiled Binaries?
 
-This isn't a preference—it's a practical reality of what's available.
+The [hostdb](https://github.com/robertjbass/hostdb) project provides pre-compiled, portable database binaries:
 
-**PostgreSQL and MariaDB have excellent embedded binary distributions.** The [hostdb](https://github.com/robertjbass/hostdb) project provides pre-compiled, portable database binaries:
-
-- Cross-platform (macOS Intel/ARM, Linux x64/ARM, Windows)
+- Cross-platform (macOS Intel/ARM, Linux x64/ARM, Windows x64)
 - Hosted on GitHub Releases (highly reliable CDN)
-- ~45-100 MB per version
+- ~45-200 MB per version depending on engine
 - Actively maintained with new database releases
 
-This makes multi-version support trivial: need PostgreSQL 14 for a legacy project and 18 for a new one? Need MariaDB 11.8? SpinDB downloads them all, and they run side-by-side without conflicts.
-
-**No equivalent exists for MySQL, MongoDB, or Redis (yet).** None of these databases have a comparable embedded binary distribution:
-
-- **MySQL:** Oracle distributes MySQL as large installers with system dependencies, not embeddable binaries.
-- **MongoDB:** Server binaries are several hundred MB and aren't designed for portable distribution.
-- **Redis:** While Redis is small (~6-12 MB), there's no official portable distribution. Community Windows ports exist, but macOS/Linux rely on system packages.
-
-For these databases, system packages (Homebrew, apt, choco) are the most reliable option. They handle dependencies, platform quirks, and security updates. SpinDB simply orchestrates what's already installed.
-
-**Does this limit multi-version support?** Yes, for MySQL/MongoDB/Redis you get whatever version your package manager provides. In practice, this is rarely a problem—developers seldom need multiple versions of these databases simultaneously. As hostdb expands to support more databases, SpinDB will adopt them for multi-version support.
+This makes multi-version support trivial: need PostgreSQL 14 for a legacy project and 18 for a new one? Need MongoDB 7.0 and 8.0? Redis 7 and 8? SpinDB downloads them all, and they run side-by-side without conflicts.
 
 ---
 
 ## Limitations
 
-- **Client tools required** - `mysql`, `mongosh`, and `redis-cli` must be installed separately for some operations (connecting, backups, restores) for system-installed engines
 - **Local only** - Databases bind to `127.0.0.1`; remote connections planned for v1.1
-- **Single version for MySQL/MongoDB/Redis** - Unlike PostgreSQL and MariaDB, MySQL, MongoDB, and Redis use system installations, so you're limited to one version per machine (see [Why Precompiled Binaries for PostgreSQL and MariaDB?](#why-precompiled-binaries-for-postgresql-and-mariadb-but-system-installs-for-others))
 - **Redis remote dump not supported** - Redis doesn't support creating containers from remote connection strings. Use backup/restore for data migration.
 
 ---
@@ -938,6 +1041,7 @@ See [TODO.md](TODO.md) for the full roadmap.
 
 ### Future Infrastructure
 - **hostdb npm package**: Available database versions will be published as an npm package from [hostdb](https://github.com/robertjbass/hostdb) and imported into SpinDB, eliminating the need to manually sync version-maps.ts with releases.json
+- **pnpm 10 upgrade**: Currently pinned to pnpm 9.x (`packageManager` in package.json and Docker). Consider upgrading to pnpm 10.x when stable—requires updating package.json, Dockerfile, regenerating pnpm-lock.yaml, and testing for lockfile format changes
 
 ### Possible Future Engines
 
@@ -947,7 +1051,6 @@ These engines are under consideration but not yet on the roadmap. Community inte
 |--------|------|-------|
 | **DuckDB** | Embedded analytical | File-based like SQLite, popular for data/analytics work |
 | **libSQL** | Embedded relational | SQLite fork by Turso with replication and edge support |
-| **Valkey** | Key-value store | Redis fork (post-license change), growing adoption |
 | **Meilisearch** | Search engine | Developer-friendly search, good binary distribution |
 | **Elasticsearch/OpenSearch** | Search engine | Full-text search, common in web applications |
 | **Neo4j** | Graph database | Most popular graph database |
@@ -1011,15 +1114,7 @@ See [ENGINES.md](ENGINES.md) for detailed engine documentation (backup formats,
 
 SpinDB wouldn't be possible without:
 
-- **[zonky.io/embedded-postgres-binaries](https://github.com/zonkyio/embedded-postgres-binaries)** - Pre-compiled PostgreSQL binaries that make Docker-free PostgreSQL possible. These binaries are extracted from official PostgreSQL distributions and hosted on Maven Central.
-
----
-
-## Related Work
-
-We're actively contributing to the broader embedded database ecosystem:
-
-- **[hostdb](https://github.com/robertjbass/hostdb)** - A companion project providing downloadable database binaries (Redis, MySQL/MariaDB, etc.) as GitHub releases. This will enable SpinDB to offer multi-version support for additional engines beyond PostgreSQL.
+- **[hostdb](https://github.com/robertjbass/hostdb)** - Pre-compiled database binaries (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, Valkey, SQLite) that make Docker-free local databases possible. Hosted on GitHub Releases for reliable, fast downloads.
 
 ---
 

package/bin/cli.js

@@ -1,24 +1,60 @@
 #!/usr/bin/env node
 
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { dirname, join } from 'node:path'
 import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { createRequire } from 'node:module'
 
 // Get the directory of this file
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 
-// Path to the main TypeScript entry point
-const mainScript = join(__dirname, '..', 'cli', 'bin.ts')
+// Path to the main TypeScript entry point and package root
+const packageRoot = join(__dirname, '..')
+const mainScript = join(packageRoot, 'cli', 'bin.ts')
 
-// Use tsx to execute the TypeScript file
-const tsxPath = join(__dirname, '..', 'node_modules', '.bin', 'tsx')
+// Use Node.js with tsx as ESM loader
+// This approach works reliably on all platforms because:
+// 1. We use process.execPath (always the current Node.js executable)
+// 2. We use --import with tsx's ESM loader module
+// 3. Arguments pass through without shell interpretation (shell: false)
+// 4. Works on Windows without needing to spawn .cmd files
 
-// Spawn tsx process with the main script and pass through all arguments
-const child = spawn(tsxPath, [mainScript, ...process.argv.slice(2)], {
-  stdio: 'inherit',
-  shell: false,
-})
+// Find tsx ESM loader using Node's module resolution
+// This works with npm, pnpm, yarn regardless of hoisting/symlink structure
+let tsxLoader = null
+
+try {
+  const require = createRequire(import.meta.url)
+  const tsxDir = dirname(require.resolve('tsx/package.json'))
+  const loaderPaths = [
+    join(tsxDir, 'dist', 'esm', 'index.mjs'),
+    join(tsxDir, 'dist', 'loader.mjs'),
+  ]
+  tsxLoader = loaderPaths.find((p) => existsSync(p))
+} catch {
+  // tsx not found via module resolution
+}
+
+if (!tsxLoader) {
+  console.error('Error: tsx loader not found.')
+  console.error('\nTry running: pnpm install')
+  process.exit(1)
+}
+
+// Convert to file URL for --import (required on Windows)
+const tsxLoaderUrl = pathToFileURL(tsxLoader).href
+
+const child = spawn(
+  process.execPath,
+  ['--import', tsxLoaderUrl, mainScript, ...process.argv.slice(2)],
+  {
+    stdio: 'inherit',
+    shell: false,
+    cwd: packageRoot,
+  },
+)
 
 // Forward exit code
 child.on('exit', (code) => {

package/cli/commands/backup.ts

@@ -252,7 +252,10 @@ export const backupCommand = new Command('backup')
           console.log(uiSuccess('Backup complete'))
           console.log()
           console.log(chalk.gray('  Saved to:'), chalk.cyan(result.path))
-          console.log(chalk.gray('  Size:'), chalk.white(formatBytes(result.size)))
+          console.log(
+            chalk.gray('  Size:'),
+            chalk.white(formatBytes(result.size)),
+          )
           console.log(chalk.gray('  Format:'), chalk.white(result.format))
           console.log()
         }

package/cli/commands/backups.ts

@@ -8,6 +8,7 @@
 import { Command } from 'commander'
 import { readdirSync, statSync } from 'fs'
 import { join, extname } from 'path'
+import { homedir } from 'os'
 import chalk from 'chalk'
 import { formatBytes } from '../ui/theme'
 
@@ -20,10 +21,11 @@ type BackupInfo = {
   format: string
 }
 
-/**
- * Detect engine and format from file extension
- */
-function detectBackupType(filename: string): { engine: string | null; format: string } {
+// Detect engine and format from file extension
+function detectBackupType(filename: string): {
+  engine: string | null
+  format: string
+} {
   const ext = extname(filename).toLowerCase()
 
   // Check for double extensions like .sql.gz
@@ -54,9 +56,7 @@ function detectBackupType(filename: string): { engine: string | null; format: st
   }
 }
 
-/**
- * Check if a file looks like a backup file
- */
+// Check if a file looks like a backup file
 function isBackupFile(filename: string): boolean {
   const backupExtensions = [
     '.sql',
@@ -77,9 +77,7 @@ function isBackupFile(filename: string): boolean {
   return backupExtensions.includes(ext)
 }
 
-/**
- * Scan directory for backup files
- */
+// Scan directory for backup files
 function findBackups(directory: string): BackupInfo[] {
   const backups: BackupInfo[] = []
 
@@ -118,9 +116,7 @@ function findBackups(directory: string): BackupInfo[] {
   return backups
 }
 
-/**
- * Format a relative time string
- */
+// Format a relative time string
 function formatRelativeTime(date: Date): string {
   const now = new Date()
   const diffMs = now.getTime() - date.getTime()
@@ -136,9 +132,7 @@ function formatRelativeTime(date: Date): string {
   return date.toLocaleDateString()
 }
 
-/**
- * Get engine icon
- */
+// Get engine icon
 function getEngineIcon(engine: string | null): string {
   switch (engine) {
     case 'postgresql':
@@ -174,11 +168,7 @@ export const backupsCommand = new Command('backups')
       const searchDirs = [directory || process.cwd()]
 
       if (options.all) {
-        const homeBackups = join(
-          process.env.HOME || '',
-          '.spindb',
-          'backups',
-        )
+        const homeBackups = join(homedir(), '.spindb', 'backups')
         searchDirs.push(homeBackups)
       }
 
@@ -219,7 +209,9 @@ export const backupsCommand = new Command('backups')
         console.log(chalk.gray('  No backup files found'))
         console.log()
         console.log(chalk.gray('  Backup files are identified by extensions:'))
-        console.log(chalk.gray('    .sql, .dump, .sqlite, .archive, .rdb, .sql.gz'))
+        console.log(
+          chalk.gray('    .sql, .dump, .sqlite, .archive, .rdb, .sql.gz'),
+        )
         console.log()
         return
       }
@@ -248,7 +240,9 @@ export const backupsCommand = new Command('backups')
         const time = formatRelativeTime(backup.modified).padStart(10)
         const format = chalk.gray(backup.format)
 
-        console.log(`  ${icon} ${chalk.cyan(filename)} ${chalk.white(size)} ${chalk.gray(time)} ${format}`)
+        console.log(
+          `  ${icon} ${chalk.cyan(filename)} ${chalk.white(size)} ${chalk.gray(time)} ${format}`,
+        )
       }
 
       console.log()

package/cli/commands/config.ts

@@ -13,9 +13,7 @@ import { uiError, uiSuccess, header, uiInfo } from '../ui/theme'
 import { createSpinner } from '../ui/spinner'
 import type { BinaryTool } from '../../types'
 
-/**
- * Helper to display a tool's config
- */
+// Helper to display a tool's config
 function displayToolConfig(
   tool: BinaryTool,
   binaryConfig: { path: string; version?: string; source: string } | undefined,

package/cli/commands/connect.ts

@@ -467,7 +467,14 @@ export const connectCommand = new Command('connect')
           clientArgs = [config.database]
         } else if (useIredis) {
           clientCmd = 'iredis'
-          clientArgs = ['-h', '127.0.0.1', '-p', String(config.port), '-n', database]
+          clientArgs = [
+            '-h',
+            '127.0.0.1',
+            '-p',
+            String(config.port),
+            '-n',
+            database,
+          ]
         } else if (usePgcli) {
           clientCmd = 'pgcli'
           clientArgs = [connectionString]
@@ -490,7 +497,14 @@ export const connectCommand = new Command('connect')
           clientArgs = [config.database]
         } else if (engineName === Engine.Redis) {
           clientCmd = 'redis-cli'
-          clientArgs = ['-h', '127.0.0.1', '-p', String(config.port), '-n', database]
+          clientArgs = [
+            '-h',
+            '127.0.0.1',
+            '-p',
+            String(config.port),
+            '-n',
+            database,
+          ]
         } else if (engineName === 'mysql') {
           clientCmd = 'mysql'
           clientArgs = [