spindb 0.24.0 → 0.26.2

package/README.md

@@ -7,7 +7,7 @@
 
 **One CLI for all your local databases.**
 
-SpinDB is a universal database management tool that combines a package manager, a unified API, and native client tooling for 13 different database engines—all from a single command-line interface. No Docker, no VMs, no platform-specific installers. Just databases, running natively on your machine.
+SpinDB is a universal database management tool that combines a package manager, a unified API, and native client tooling for 15 different database engines—all from a single command-line interface. No Docker, no VMs, no platform-specific installers. Just databases, running natively on your machine.
 
 ```bash
 npm install -g spindb
@@ -48,7 +48,7 @@ One consistent interface across SQL databases, document stores, key-value stores
 
 ```bash
 # Same commands work for ANY database
-spindb create mydb --engine [postgresql|mysql|mariadb|mongodb|ferretdb|redis|valkey|clickhouse|sqlite|duckdb|qdrant|meilisearch|couchdb]
+spindb create mydb --engine [postgresql|mysql|mariadb|mongodb|ferretdb|redis|valkey|clickhouse|sqlite|duckdb|qdrant|meilisearch|couchdb|cockroachdb|surrealdb]
 spindb start mydb
 spindb connect mydb
 spindb backup mydb
@@ -70,7 +70,7 @@ spindb run mydb -c "SELECT * FROM system.tables"        # ClickHouse
 
 ## Platform Coverage
 
-SpinDB works across **13 database engines** and **5 platform architectures** with a **single, consistent API**.
+SpinDB works across **15 database engines** and **5 platform architectures** with a **single, consistent API**.
 
 | Database | macOS ARM64 | macOS Intel | Linux x64 | Linux ARM64 | Windows x64 |
 |----------|:-----------:|:-----------:|:---------:|:-----------:|:-----------:|
@@ -87,8 +87,10 @@ SpinDB works across **13 database engines** and **5 platform architectures** wit
 | 🧭 **Qdrant** | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🔍 **Meilisearch** | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🛋 **CouchDB** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 🪳 **CockroachDB** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 🌀 **SurrealDB** | ✅ | ✅ | ✅ | ✅ | ✅ |
 
-**63 combinations. One CLI. Zero configuration.**
+**73 combinations. One CLI. Zero configuration.**
 
 ---
 
@@ -166,13 +168,13 @@ SpinDB runs databases as **native processes** with **isolated data directories**
 
 | Feature | SpinDB | Docker | DBngin | Postgres.app | XAMPP |
 |---------|--------|--------|--------|--------------|-------|
+| **All database types unified** | ✅ 15 engines | ❌ | ❌ | ❌ | ❌ |
 | No Docker required | ✅ | ❌ | ✅ | ✅ | ✅ |
-| Multiple DB engines | ✅ 13 engines | ✅ Unlimited | ✅ 3 engines | ❌ PostgreSQL only | ⚠️ MySQL only |
 | CLI-first | ✅ | ✅ | ❌ GUI-first | ❌ GUI-first | ❌ GUI-first |
-| Multiple versions | ✅ | ✅ | ✅ | ✅ | ❌ |
+| Multiple versions side-by-side | ✅ | ✅ | ✅ | ✅ | ❌ |
 | Clone databases | ✅ | Manual | ✅ | ❌ | ❌ |
 | Backup/restore built-in | ✅ | Manual | ✅ | ❌ | ❌ |
-| Low resource usage | ✅ Native | ❌ VM on macOS/Win | ✅ Native | ✅ Native | ✅ Native |
+| Low resource usage | ✅ Native | ❌ VM overhead | ✅ Native | ✅ Native | ✅ Native |
 | Linux support | ✅ | ✅ | ❌ | ❌ | ✅ |
 | ARM64 support | ✅ | ✅ | ✅ | ✅ | ❌ |
 | Free for commercial use | ❌ | ⚠️ Paid for orgs | ✅ | ✅ | ✅ |
@@ -181,7 +183,7 @@ SpinDB runs databases as **native processes** with **isolated data directories**
 
 ## Supported Databases
 
-SpinDB supports **13 database engines** with **multiple versions** for each:
+SpinDB supports **15 database engines** with **multiple versions** for each:
 
 | Engine | Type | Versions | Default Port | Query Language |
 |--------|------|----------|--------------|----------------|
@@ -198,10 +200,12 @@ SpinDB supports **13 database engines** with **multiple versions** for each:
 | 🧭 **Qdrant** | Vector Search | 1 | 6333 (HTTP), 6334 (gRPC) | REST API |
 | 🔍 **Meilisearch** | Full-Text Search | 1 | 7700 | REST API |
 | 🛋 **CouchDB** | Document Store | 3 | 5984 | REST API |
+| 🪳 **CockroachDB** | Distributed SQL | 25 | 26257 | SQL (PostgreSQL-compatible) |
+| 🌀 **SurrealDB** | Multi-Model | 2 | 8000 | SurrealQL |
 
 ### Engine Categories
 
-**Server-Based Databases** (PostgreSQL, MySQL, MariaDB, MongoDB, FerretDB, Redis, Valkey, ClickHouse, Qdrant, Meilisearch, CouchDB):
+**Server-Based Databases** (PostgreSQL, MySQL, MariaDB, MongoDB, FerretDB, Redis, Valkey, ClickHouse, Qdrant, Meilisearch, CouchDB, CockroachDB, SurrealDB):
 - Start/stop server processes
 - Bind to localhost ports
 - Data stored in `~/.spindb/containers/{engine}/{name}/`
@@ -427,6 +431,7 @@ Databases run as **native processes**, and **data persists across restarts**. Wh
 | Redis | RDB snapshots (periodic) | May lose ~60 seconds on unexpected crash |
 | Valkey | RDB snapshots (periodic) | May lose ~60 seconds on unexpected crash |
 | ClickHouse | MergeTree storage | Committed transactions survive crashes |
+| CockroachDB | Raft consensus | Strongly consistent, distributed replication |
 
 ---
 
@@ -583,6 +588,31 @@ curl http://127.0.0.1:6333/collections
 **Query interface:** REST API (no CLI shell - use curl or API clients)
 **Tools:** `qdrant` (included)
 
+### CockroachDB 🪳
+
+```bash
+# Create CockroachDB database (distributed SQL)
+spindb create cluster --engine cockroachdb
+spindb start cluster
+
+# PostgreSQL-compatible SQL
+spindb run cluster -c "CREATE TABLE users (id INT PRIMARY KEY, name STRING)"
+spindb run cluster -c "SELECT * FROM users"
+
+# Connect with cockroach sql shell
+spindb connect cluster
+```
+
+**Version:** 25 (25.4.2)
+**Platforms:** macOS, Linux, Windows (all platforms)
+**Ports:** 26257 (SQL), HTTP Admin UI on SQL port + 1 (default 26258)
+**Query language:** SQL (PostgreSQL-compatible)
+**Tools:** `cockroach` (included)
+**Default user:** `root`
+**Default database:** `defaultdb`
+
+CockroachDB is a distributed SQL database with automatic replication and failover. Single-node mode is used for local development.
+
 ---
 
 ## Enhanced CLI Tools
@@ -604,6 +634,7 @@ SpinDB supports enhanced database shells with auto-completion, syntax highlighti
 | Qdrant | REST API | - | - |
 | Meilisearch | REST API | - | - |
 | CouchDB | REST API | - | - |
+| CockroachDB | `cockroach sql` | - | - |
 
 Install and use in one command:
 
@@ -713,6 +744,16 @@ spindb backup mydb --format snapshot    # Snapshot (only format)
 spindb backup mydb --format snapshot    # Snapshot (only format)
 ```
 
+### CockroachDB
+
+| Format | Extension | Tool | Use Case |
+|--------|-----------|------|----------|
+| sql | `.sql` | cockroach dump | Plain SQL dump |
+
+```bash
+spindb backup mydb --format sql         # SQL dump (only format)
+```
+
 ---
 
 ## Advanced Features
@@ -755,6 +796,7 @@ spindb restore mydb --from-url "postgresql://user:pass@prod-host:5432/production
 | Qdrant | `qdrant://` or `http://` | `http://host:6333?api_key=KEY` |
 | Meilisearch | `meilisearch://` or `http://` | `http://host:7700?api_key=KEY` |
 | CouchDB | `couchdb://` or `http://` | `http://user:pass@host:5984/db` |
+| CockroachDB | `postgresql://` or `postgres://` | `postgresql://root@host:26257/db?sslmode=disable` |
 
 ### Multi-Version Support
 
@@ -809,10 +851,7 @@ See [TODO.md](TODO.md) for the complete roadmap.
 - Environment variable support in connection strings
 - Secrets management with macOS Keychain integration
 
-### v1.2 - Additional Engines
-- **CockroachDB** - Distributed PostgreSQL-compatible database
-
-### v1.3 - Advanced Features
+### v1.2 - Advanced Features
 - Container templates for common configurations
 - Scheduled automated backups
 - Import databases from Docker containers
@@ -910,7 +949,7 @@ See [FEATURE.md](FEATURE.md) for adding new database engines.
 
 SpinDB is powered by:
 
-- **[hostdb](https://github.com/robertjbass/hostdb)** - Pre-compiled database binaries for 14 engines across all major platforms. Makes Docker-free multi-version database support possible.
+- **[hostdb](https://github.com/robertjbass/hostdb)** - Pre-compiled database binaries for 15 engines across all major platforms. Makes Docker-free multi-version database support possible.
 
 ---
 

package/cli/commands/engines.ts

@@ -62,6 +62,8 @@ import { qdrantBinaryManager } from '../../engines/qdrant/binary-manager'
 import { meilisearchBinaryManager } from '../../engines/meilisearch/binary-manager'
 import { ferretdbBinaryManager } from '../../engines/ferretdb/binary-manager'
 import { couchdbBinaryManager } from '../../engines/couchdb/binary-manager'
+import { cockroachdbBinaryManager } from '../../engines/cockroachdb/binary-manager'
+import { surrealdbBinaryManager } from '../../engines/surrealdb/binary-manager'
 import {
   DEFAULT_DOCUMENTDB_VERSION,
   normalizeDocumentDBVersion,
@@ -1676,9 +1678,95 @@ enginesCommand
         return
       }
 
+      if (['cockroachdb', 'crdb'].includes(normalizedEngine)) {
+        if (!version) {
+          console.error(uiError('CockroachDB requires a version (e.g., 25)'))
+          process.exit(1)
+        }
+
+        const engine = getEngine(Engine.CockroachDB)
+
+        const spinner = createSpinner(`Checking CockroachDB ${version} binaries...`)
+        spinner.start()
+
+        let wasCached = false
+        await engine.ensureBinaries(version, ({ stage, message }) => {
+          if (stage === 'cached') {
+            wasCached = true
+            spinner.text = `CockroachDB ${version} binaries ready (cached)`
+          } else {
+            spinner.text = message
+          }
+        })
+
+        if (wasCached) {
+          spinner.succeed(`CockroachDB ${version} binaries already installed`)
+        } else {
+          spinner.succeed(`CockroachDB ${version} binaries downloaded`)
+        }
+
+        // Show the path for reference
+        const { platform: cockroachdbPlatform, arch: cockroachdbArch } =
+          platformService.getPlatformInfo()
+        const cockroachdbFullVersion = cockroachdbBinaryManager.getFullVersion(version)
+        const binPath = paths.getBinaryPath({
+          engine: 'cockroachdb',
+          version: cockroachdbFullVersion,
+          platform: cockroachdbPlatform,
+          arch: cockroachdbArch,
+        })
+        console.log(chalk.gray(`  Location: ${binPath}`))
+
+        // Skip client tools check for CockroachDB - the cockroach binary is both server and client
+        return
+      }
+
+      if (['surrealdb', 'surreal'].includes(normalizedEngine)) {
+        if (!version) {
+          console.error(uiError('SurrealDB requires a version (e.g., 2)'))
+          process.exit(1)
+        }
+
+        const engine = getEngine(Engine.SurrealDB)
+
+        const spinner = createSpinner(`Checking SurrealDB ${version} binaries...`)
+        spinner.start()
+
+        let wasCached = false
+        await engine.ensureBinaries(version, ({ stage, message }) => {
+          if (stage === 'cached') {
+            wasCached = true
+            spinner.text = `SurrealDB ${version} binaries ready (cached)`
+          } else {
+            spinner.text = message
+          }
+        })
+
+        if (wasCached) {
+          spinner.succeed(`SurrealDB ${version} binaries already installed`)
+        } else {
+          spinner.succeed(`SurrealDB ${version} binaries downloaded`)
+        }
+
+        // Show the path for reference
+        const { platform: surrealdbPlatform, arch: surrealdbArch } =
+          platformService.getPlatformInfo()
+        const surrealdbFullVersion = surrealdbBinaryManager.getFullVersion(version)
+        const binPath = paths.getBinaryPath({
+          engine: 'surrealdb',
+          version: surrealdbFullVersion,
+          platform: surrealdbPlatform,
+          arch: surrealdbArch,
+        })
+        console.log(chalk.gray(`  Location: ${binPath}`))
+
+        // Skip client tools check for SurrealDB - the surreal binary is both server and client
+        return
+      }
+
       console.error(
         uiError(
-          `Unknown engine "${engineName}". Supported: postgresql, mysql, mariadb, sqlite, duckdb, mongodb, ferretdb, redis, valkey, clickhouse, qdrant, meilisearch, couchdb`,
+          `Unknown engine "${engineName}". Supported: postgresql, mysql, mariadb, sqlite, duckdb, mongodb, ferretdb, redis, valkey, clickhouse, qdrant, meilisearch, couchdb, cockroachdb, surrealdb`,
         ),
       )
       process.exit(1)

package/cli/commands/menu/backup-handlers.ts

@@ -174,6 +174,25 @@ function validateConnectionString(
         return 'Connection string must start with couchdb://, http://, or https://'
       }
       break
+    case Engine.CockroachDB:
+      if (
+        !input.startsWith('postgresql://') &&
+        !input.startsWith('postgres://')
+      ) {
+        return 'Connection string must start with postgresql:// or postgres://'
+      }
+      break
+    case Engine.SurrealDB:
+      if (
+        !input.startsWith('surrealdb://') &&
+        !input.startsWith('ws://') &&
+        !input.startsWith('wss://') &&
+        !input.startsWith('http://') &&
+        !input.startsWith('https://')
+      ) {
+        return 'Connection string must start with surrealdb://, ws://, wss://, http://, or https://'
+      }
+      break
     case Engine.SQLite:
     case Engine.DuckDB:
       return 'File-based engines do not support remote connection strings'

package/cli/commands/menu/container-handlers.ts

@@ -648,13 +648,15 @@ export async function showContainerSubmenu(
   // REST API engines (Qdrant, Meilisearch, CouchDB) don't support script files - hide the option entirely
   if (config.engine !== Engine.Qdrant && config.engine !== Engine.Meilisearch && config.engine !== Engine.CouchDB) {
     const canRunSql = isFileBasedDB ? existsSync(config.database) : isRunning
-    // Engine-specific terminology: Redis/Valkey use commands, MongoDB/FerretDB use scripts, others use SQL
+    // Engine-specific terminology: Redis/Valkey use commands, MongoDB/FerretDB use scripts, SurrealDB uses SurrealQL, others use SQL
     const runScriptLabel =
       config.engine === Engine.Redis || config.engine === Engine.Valkey
         ? 'Run command file'
         : config.engine === Engine.MongoDB || config.engine === Engine.FerretDB
           ? 'Run script file'
-          : 'Run SQL file'
+          : config.engine === Engine.SurrealDB
+            ? 'Run SurrealQL file'
+            : 'Run SQL file'
     actionChoices.push({
       name: canRunSql
         ? `${chalk.yellow('▷')} ${runScriptLabel}`

package/cli/commands/menu/shell-handlers.ts

@@ -215,6 +215,20 @@ export async function handleOpenShell(containerName: string): Promise<void> {
     engineSpecificInstalled = false
     engineSpecificValue = null
     engineSpecificInstallValue = null
+  } else if (config.engine === 'surrealdb') {
+    // SurrealDB uses surreal sql command
+    defaultShellName = 'surreal sql'
+    engineSpecificCli = null
+    engineSpecificInstalled = false
+    engineSpecificValue = null
+    engineSpecificInstallValue = null
+  } else if (config.engine === 'cockroachdb') {
+    // CockroachDB uses cockroach sql command
+    defaultShellName = 'cockroach sql'
+    engineSpecificCli = null
+    engineSpecificInstalled = false
+    engineSpecificValue = null
+    engineSpecificInstallValue = null
   } else {
     defaultShellName = 'psql'
     engineSpecificCli = 'pgcli'
@@ -309,7 +323,7 @@ export async function handleOpenShell(containerName: string): Promise<void> {
     }
   }
 
-  // usql supports SQL databases (PostgreSQL, MySQL, SQLite) - skip for Redis, Valkey, MongoDB, FerretDB, Qdrant, Meilisearch, and CouchDB
+  // usql supports SQL databases (PostgreSQL, MySQL, SQLite) - skip for Redis, Valkey, MongoDB, FerretDB, Qdrant, Meilisearch, CouchDB, and SurrealDB
   const isNonSqlEngine =
     config.engine === 'redis' ||
     config.engine === 'valkey' ||
@@ -317,7 +331,8 @@ export async function handleOpenShell(containerName: string): Promise<void> {
     config.engine === 'ferretdb' ||
     config.engine === 'qdrant' ||
     config.engine === 'meilisearch' ||
-    config.engine === 'couchdb'
+    config.engine === 'couchdb' ||
+    config.engine === 'surrealdb'
   if (!isNonSqlEngine) {
     if (usqlInstalled) {
       choices.push({
@@ -869,6 +884,41 @@ async function launchShell(
 
     openInBrowser(dashboardUrl)
     return
+  } else if (config.engine === 'surrealdb') {
+    // SurrealDB uses surreal sql command
+    const engine = getEngine(config.engine)
+    const surrealPath = await engine.getSurrealPath(config.version).catch(() => 'surreal')
+    const namespace = config.name.replace(/-/g, '_')
+    const database = config.database || 'default'
+    shellCmd = surrealPath
+    shellArgs = [
+      'sql',
+      '--endpoint',
+      `ws://127.0.0.1:${config.port}`,
+      '--namespace',
+      namespace,
+      '--database',
+      database,
+      '--username',
+      'root',
+      '--password',
+      'root',
+    ]
+    installHint = 'spindb engines download surrealdb'
+  } else if (config.engine === 'cockroachdb') {
+    // CockroachDB uses cockroach sql command
+    const engine = getEngine(config.engine)
+    const cockroachPath = await engine.getCockroachPath(config.version).catch(() => 'cockroach')
+    shellCmd = cockroachPath
+    shellArgs = [
+      'sql',
+      '--insecure',
+      '--host',
+      `127.0.0.1:${config.port}`,
+      '--database',
+      config.database,
+    ]
+    installHint = 'spindb engines download cockroachdb'
   } else {
     shellCmd = 'psql'
     shellArgs = [connectionString]

package/cli/commands/menu/sql-handlers.ts

@@ -59,7 +59,8 @@ export async function handleRunSql(containerName: string): Promise<void> {
 
   // Get script type terminology based on engine
   // IMPORTANT: When adding a new engine, update this function and FEATURE.md
-  // - SQL: PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse
+  // - SQL: PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse, CockroachDB
+  // - SurrealQL: SurrealDB (SQL-like but distinct language)
   // - Script: MongoDB, FerretDB (JavaScript via mongosh), Qdrant, Meilisearch (REST API)
   // - Command: Redis, Valkey (Redis commands)
   const getScriptType = (engine: Engine): { type: string; lower: string } => {
@@ -79,6 +80,10 @@ export async function handleRunSql(containerName: string): Promise<void> {
       case Engine.CouchDB:
         return { type: 'Script', lower: 'script' }
 
+      // SurrealDB uses SurrealQL (distinct from SQL)
+      case Engine.SurrealDB:
+        return { type: 'SurrealQL', lower: 'SurrealQL' }
+
       // SQL engines use "SQL" terminology
       case Engine.PostgreSQL:
       case Engine.MySQL:
@@ -86,6 +91,7 @@ export async function handleRunSql(containerName: string): Promise<void> {
       case Engine.SQLite:
       case Engine.DuckDB:
       case Engine.ClickHouse:
+      case Engine.CockroachDB:
         return { type: 'SQL', lower: 'sql' }
 
       default:

package/cli/constants.ts

@@ -13,6 +13,8 @@ export const ENGINE_ICONS: Record<string, string> = {
   qdrant: '🧭',
   meilisearch: '🔍',
   couchdb: '🛋',
+  cockroachdb: '🪳',
+  surrealdb: '🌀',
 }
 
 // Visual width of each icon in terminal columns
@@ -32,6 +34,8 @@ export const ENGINE_ICON_WIDTHS: Record<string, number> = {
   qdrant: 2,
   meilisearch: 2,
   couchdb: 1, // 🛋 couch renders narrow
+  cockroachdb: 1, // 🪳 cockroach renders narrow
+  surrealdb: 2, // 🌀 cyclone renders at standard width
 }
 
 export const DEFAULT_ENGINE_ICON = '▣'

package/cli/helpers.ts

@@ -194,6 +194,26 @@ export type InstalledCouchDBEngine = {
   source: 'downloaded'
 }
 
+export type InstalledCockroachDBEngine = {
+  engine: 'cockroachdb'
+  version: string
+  platform: string
+  arch: string
+  path: string
+  sizeBytes: number
+  source: 'downloaded'
+}
+
+export type InstalledSurrealDBEngine = {
+  engine: 'surrealdb'
+  version: string
+  platform: string
+  arch: string
+  path: string
+  sizeBytes: number
+  source: 'downloaded'
+}
+
 export type InstalledEngine =
   | InstalledPostgresEngine
   | InstalledMariadbEngine
@@ -208,6 +228,8 @@ export type InstalledEngine =
   | InstalledQdrantEngine
   | InstalledMeilisearchEngine
   | InstalledCouchDBEngine
+  | InstalledCockroachDBEngine
+  | InstalledSurrealDBEngine
 
 async function getPostgresVersion(binPath: string): Promise<string | null> {
   const ext = platformService.getExecutableExtension()
@@ -876,6 +898,118 @@ async function getInstalledCouchDBEngines(): Promise<InstalledCouchDBEngine[]> {
   return engines
 }
 
+// Get CockroachDB version from binary path
+async function getCockroachDBVersion(binPath: string): Promise<string | null> {
+  const ext = platformService.getExecutableExtension()
+  const cockroachPath = join(binPath, 'bin', `cockroach${ext}`)
+  if (!existsSync(cockroachPath)) {
+    return null
+  }
+
+  try {
+    const { stdout } = await execFileAsync(cockroachPath, ['version'])
+    // Parse output like "Build Tag:        v25.4.2" or "CockroachDB CCL v25.4.2"
+    const match = stdout.match(/v?(\d+\.\d+\.\d+)/)
+    return match ? match[1] : null
+  } catch {
+    return null
+  }
+}
+
+// Get installed CockroachDB engines from downloaded binaries
+async function getInstalledCockroachDBEngines(): Promise<InstalledCockroachDBEngine[]> {
+  const binDir = paths.bin
+
+  if (!existsSync(binDir)) {
+    return []
+  }
+
+  const entries = await readdir(binDir, { withFileTypes: true })
+  const engines: InstalledCockroachDBEngine[] = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (!entry.name.startsWith('cockroachdb-')) continue
+
+    const parsed = parseEngineDirectory(entry.name, 'cockroachdb-', binDir)
+    if (!parsed) continue
+
+    const actualVersion =
+      (await getCockroachDBVersion(parsed.path)) || parsed.version
+    const sizeBytes = await calculateDirectorySize(parsed.path)
+
+    engines.push({
+      engine: 'cockroachdb',
+      version: actualVersion,
+      platform: parsed.platform,
+      arch: parsed.arch,
+      path: parsed.path,
+      sizeBytes,
+      source: 'downloaded',
+    })
+  }
+
+  engines.sort((a, b) => compareVersions(b.version, a.version))
+
+  return engines
+}
+
+// Get SurrealDB version from binary path
+async function getSurrealDBVersion(binPath: string): Promise<string | null> {
+  const ext = platformService.getExecutableExtension()
+  const surrealPath = join(binPath, 'bin', `surreal${ext}`)
+  if (!existsSync(surrealPath)) {
+    return null
+  }
+
+  try {
+    const { stdout } = await execFileAsync(surrealPath, ['version'])
+    // Parse output like "surreal 2.3.2 for linux on x86_64" or "2.3.2"
+    const match = stdout.match(/(\d+\.\d+\.\d+)/)
+    return match ? match[1] : null
+  } catch {
+    return null
+  }
+}
+
+// Get installed SurrealDB engines from downloaded binaries
+async function getInstalledSurrealDBEngines(): Promise<InstalledSurrealDBEngine[]> {
+  const binDir = paths.bin
+
+  if (!existsSync(binDir)) {
+    return []
+  }
+
+  const entries = await readdir(binDir, { withFileTypes: true })
+  const engines: InstalledSurrealDBEngine[] = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (!entry.name.startsWith('surrealdb-')) continue
+
+    const parsed = parseEngineDirectory(entry.name, 'surrealdb-', binDir)
+    if (!parsed) continue
+
+    const actualVersion =
+      (await getSurrealDBVersion(parsed.path)) || parsed.version
+    const sizeBytes = await calculateDirectorySize(parsed.path)
+
+    engines.push({
+      engine: 'surrealdb',
+      version: actualVersion,
+      platform: parsed.platform,
+      arch: parsed.arch,
+      path: parsed.path,
+      sizeBytes,
+      source: 'downloaded',
+    })
+  }
+
+  engines.sort((a, b) => compareVersions(b.version, a.version))
+
+  return engines
+}
+
 // Get FerretDB version from binary path
 async function getFerretDBVersion(binPath: string): Promise<string | null> {
   const ext = platformService.getExecutableExtension()
@@ -963,6 +1097,8 @@ const ENGINE_PREFIXES = [
   'qdrant-',
   'meilisearch-',
   'couchdb-',
+  'cockroachdb-',
+  'surrealdb-',
 ] as const
 
 /**
@@ -1006,6 +1142,8 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     qdrantEngines,
     meilisearchEngines,
     couchdbEngines,
+    cockroachdbEngines,
+    surrealdbEngines,
   ] = await Promise.all([
     getInstalledPostgresEngines(),
     getInstalledMariadbEngines(),
@@ -1020,6 +1158,8 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     getInstalledQdrantEngines(),
     getInstalledMeilisearchEngines(),
     getInstalledCouchDBEngines(),
+    getInstalledCockroachDBEngines(),
+    getInstalledSurrealDBEngines(),
   ])
 
   return [
@@ -1036,6 +1176,8 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     ...qdrantEngines,
     ...meilisearchEngines,
     ...couchdbEngines,
+    ...cockroachdbEngines,
+    ...surrealdbEngines,
   ]
 }
 
@@ -1052,4 +1194,6 @@ export {
   getInstalledQdrantEngines,
   getInstalledMeilisearchEngines,
   getInstalledCouchDBEngines,
+  getInstalledCockroachDBEngines,
+  getInstalledSurrealDBEngines,
 }

package/cli/index.ts

@@ -125,5 +125,5 @@ export async function run(): Promise<void> {
     return
   }
 
-  program.parse()
+  await program.parseAsync()
 }