spindb 0.23.5 → 0.24.0

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 12 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 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.
 
 ```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]
+spindb create mydb --engine [postgresql|mysql|mariadb|mongodb|ferretdb|redis|valkey|clickhouse|sqlite|duckdb|qdrant|meilisearch|couchdb]
 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 **12 database engines** and **5 platform architectures** with a **single, consistent API**.
+SpinDB works across **13 database engines** and **5 platform architectures** with a **single, consistent API**.
 
 | Database | macOS ARM64 | macOS Intel | Linux x64 | Linux ARM64 | Windows x64 |
 |----------|:-----------:|:-----------:|:---------:|:-----------:|:-----------:|
@@ -86,8 +86,9 @@ SpinDB works across **12 database engines** and **5 platform architectures** wit
 | 🏠 **ClickHouse** | ✅ | ✅ | ✅ | ✅ | ❌ |
 | 🧭 **Qdrant** | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🔍 **Meilisearch** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 🛋 **CouchDB** | ✅ | ✅ | ✅ | ✅ | ✅ |
 
-**58 combinations. One CLI. Zero configuration.**
+**63 combinations. One CLI. Zero configuration.**
 
 ---
 
@@ -166,7 +167,7 @@ SpinDB runs databases as **native processes** with **isolated data directories**
 | Feature | SpinDB | Docker | DBngin | Postgres.app | XAMPP |
 |---------|--------|--------|--------|--------------|-------|
 | No Docker required | ✅ | ❌ | ✅ | ✅ | ✅ |
-| Multiple DB engines | ✅ 12 engines | ✅ Unlimited | ✅ 3 engines | ❌ PostgreSQL only | ⚠️ MySQL only |
+| Multiple DB engines | ✅ 13 engines | ✅ Unlimited | ✅ 3 engines | ❌ PostgreSQL only | ⚠️ MySQL only |
 | CLI-first | ✅ | ✅ | ❌ GUI-first | ❌ GUI-first | ❌ GUI-first |
 | Multiple versions | ✅ | ✅ | ✅ | ✅ | ❌ |
 | Clone databases | ✅ | Manual | ✅ | ❌ | ❌ |
@@ -180,7 +181,7 @@ SpinDB runs databases as **native processes** with **isolated data directories**
 
 ## Supported Databases
 
-SpinDB supports **12 database engines** with **multiple versions** for each:
+SpinDB supports **13 database engines** with **multiple versions** for each:
 
 | Engine | Type | Versions | Default Port | Query Language |
 |--------|------|----------|--------------|----------------|
@@ -196,10 +197,11 @@ SpinDB supports **12 database engines** with **multiple versions** for each:
 | 🏠 **ClickHouse** | Columnar OLAP | 25.12 | 9000 (TCP), 8123 (HTTP) | SQL (ClickHouse dialect) |
 | 🧭 **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 |
 
 ### Engine Categories
 
-**Server-Based Databases** (PostgreSQL, MySQL, MariaDB, MongoDB, FerretDB, Redis, Valkey, ClickHouse, Qdrant, Meilisearch):
+**Server-Based Databases** (PostgreSQL, MySQL, MariaDB, MongoDB, FerretDB, Redis, Valkey, ClickHouse, Qdrant, Meilisearch, CouchDB):
 - Start/stop server processes
 - Bind to localhost ports
 - Data stored in `~/.spindb/containers/{engine}/{name}/`
@@ -601,6 +603,7 @@ SpinDB supports enhanced database shells with auto-completion, syntax highlighti
 | ClickHouse | `clickhouse-client` | - | `usql` |
 | Qdrant | REST API | - | - |
 | Meilisearch | REST API | - | - |
+| CouchDB | REST API | - | - |
 
 Install and use in one command:
 
@@ -751,6 +754,7 @@ spindb restore mydb --from-url "postgresql://user:pass@prod-host:5432/production
 | ClickHouse | `clickhouse://` or `http://` | `clickhouse://default:pass@host:8123/db` |
 | 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` |
 
 ### Multi-Version Support
 
@@ -831,7 +835,7 @@ The following engines may be added based on community interest:
 - **Local only** - Databases bind to `127.0.0.1`. Remote connection support planned for v1.1.
 - **ClickHouse Windows** - Not supported (hostdb doesn't build for Windows).
 - **FerretDB Windows** - Not supported (postgresql-documentdb has startup issues on Windows).
-- **Qdrant & Meilisearch** - Use REST API instead of CLI shell. Access via HTTP at the configured port.
+- **Qdrant, Meilisearch & CouchDB** - Use REST API instead of CLI shell. Access via HTTP at the configured port.
 
 ---
 
@@ -906,7 +910,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 11 engines across all major platforms. Makes Docker-free multi-version database support possible.
+- **[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.
 
 ---
 

package/cli/commands/engines.ts

@@ -43,6 +43,7 @@ import {
   type InstalledValkeyEngine,
   type InstalledQdrantEngine,
   type InstalledMeilisearchEngine,
+  type InstalledCouchDBEngine,
 } from '../helpers'
 import { Engine, Platform } from '../../types'
 import {
@@ -60,6 +61,7 @@ import { clickhouseBinaryManager } from '../../engines/clickhouse/binary-manager
 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 {
   DEFAULT_DOCUMENTDB_VERSION,
   normalizeDocumentDBVersion,
@@ -457,6 +459,9 @@ async function listEngines(options: { json?: boolean }): Promise<void> {
   const meilisearchEngines = engines.filter(
     (e): e is InstalledMeilisearchEngine => e.engine === 'meilisearch',
   )
+  const couchdbEngines = engines.filter(
+    (e): e is InstalledCouchDBEngine => e.engine === 'couchdb',
+  )
 
   // Calculate total size for PostgreSQL
   const totalPgSize = pgEngines.reduce((acc, e) => acc + e.sizeBytes, 0)
@@ -621,6 +626,21 @@ async function listEngines(options: { json?: boolean }): Promise<void> {
     )
   }
 
+  // CouchDB rows
+  for (const engine of couchdbEngines) {
+    const icon = ENGINE_ICONS.couchdb
+    const platformInfo = `${engine.platform}-${engine.arch}`
+    const engineDisplay = `${icon} couchdb`
+
+    console.log(
+      chalk.gray('  ') +
+        chalk.cyan(padWithEmoji(engineDisplay, 13)) +
+        chalk.yellow(engine.version.padEnd(12)) +
+        chalk.gray(platformInfo.padEnd(18)) +
+        chalk.white(formatBytes(engine.sizeBytes)),
+    )
+  }
+
   console.log(chalk.gray('  ' + '─'.repeat(55)))
 
   // Summary
@@ -716,6 +736,17 @@ async function listEngines(options: { json?: boolean }): Promise<void> {
       ),
     )
   }
+  if (couchdbEngines.length > 0) {
+    const totalCouchDBSize = couchdbEngines.reduce(
+      (acc, e) => acc + e.sizeBytes,
+      0,
+    )
+    console.log(
+      chalk.gray(
+        `  CouchDB: ${couchdbEngines.length} version(s), ${formatBytes(totalCouchDBSize)}`,
+      ),
+    )
+  }
   console.log()
 }
 
@@ -1601,9 +1632,53 @@ enginesCommand
         return
       }
 
+      if (['couchdb', 'couch'].includes(normalizedEngine)) {
+        if (!version) {
+          console.error(uiError('CouchDB requires a version (e.g., 3)'))
+          process.exit(1)
+        }
+
+        const engine = getEngine(Engine.CouchDB)
+
+        const spinner = createSpinner(`Checking CouchDB ${version} binaries...`)
+        spinner.start()
+
+        let wasCached = false
+        await engine.ensureBinaries(version, ({ stage, message }) => {
+          if (stage === 'cached') {
+            wasCached = true
+            spinner.text = `CouchDB ${version} binaries ready (cached)`
+          } else {
+            spinner.text = message
+          }
+        })
+
+        if (wasCached) {
+          spinner.succeed(`CouchDB ${version} binaries already installed`)
+        } else {
+          spinner.succeed(`CouchDB ${version} binaries downloaded`)
+        }
+
+        // Show the path for reference
+        const { platform: couchdbPlatform, arch: couchdbArch } =
+          platformService.getPlatformInfo()
+        const couchdbFullVersion = couchdbBinaryManager.getFullVersion(version)
+        const binPath = paths.getBinaryPath({
+          engine: 'couchdb',
+          version: couchdbFullVersion,
+          platform: couchdbPlatform,
+          arch: couchdbArch,
+        })
+        console.log(chalk.gray(`  Location: ${binPath}`))
+
+        // Skip client tools check for CouchDB - it's a REST API server
+        // with no CLI client tools (uses HTTP protocols instead)
+        return
+      }
+
       console.error(
         uiError(
-          `Unknown engine "${engineName}". Supported: postgresql, mysql, mariadb, sqlite, duckdb, mongodb, ferretdb, redis, valkey, clickhouse, qdrant, meilisearch`,
+          `Unknown engine "${engineName}". Supported: postgresql, mysql, mariadb, sqlite, duckdb, mongodb, ferretdb, redis, valkey, clickhouse, qdrant, meilisearch, couchdb`,
         ),
       )
       process.exit(1)

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

@@ -165,6 +165,15 @@ function validateConnectionString(
         return 'Connection string must start with meilisearch://, http://, or https://'
       }
       break
+    case Engine.CouchDB:
+      if (
+        !input.startsWith('couchdb://') &&
+        !input.startsWith('http://') &&
+        !input.startsWith('https://')
+      ) {
+        return 'Connection string must start with couchdb://, 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

@@ -151,19 +151,29 @@ export async function handleCreate(): Promise<'main' | void> {
     )
     binarySpinner.start()
 
-    const isInstalled = await dbEngine.isBinaryInstalled(version)
-    if (isInstalled) {
-      binarySpinner.succeed(
-        `${dbEngine.displayName} ${version} binaries ready (cached)`,
-      )
-    } else {
-      binarySpinner.text = `Downloading ${dbEngine.displayName} ${version} binaries...`
-      await dbEngine.ensureBinaries(version, ({ message }) => {
-        binarySpinner.text = message
-      })
-      binarySpinner.succeed(
-        `${dbEngine.displayName} ${version} binaries downloaded`,
-      )
+    try {
+      const isInstalled = await dbEngine.isBinaryInstalled(version)
+      if (isInstalled) {
+        binarySpinner.succeed(
+          `${dbEngine.displayName} ${version} binaries ready (cached)`,
+        )
+      } else {
+        binarySpinner.text = `Downloading ${dbEngine.displayName} ${version} binaries...`
+        await dbEngine.ensureBinaries(version, ({ message }) => {
+          binarySpinner.text = message
+        })
+        binarySpinner.succeed(
+          `${dbEngine.displayName} ${version} binaries downloaded`,
+        )
+      }
+    } catch (error) {
+      binarySpinner.fail(`Failed to download ${dbEngine.displayName} binaries`)
+      const e = error as Error
+      console.log()
+      console.log(uiError(e.message))
+      console.log()
+      await pressEnterToContinue()
+      return
     }
   }
 
@@ -221,19 +231,29 @@ export async function handleCreate(): Promise<'main' | void> {
     )
     binarySpinner.start()
 
-    const isInstalled = await dbEngine.isBinaryInstalled(version)
-    if (isInstalled) {
-      binarySpinner.succeed(
-        `${dbEngine.displayName} ${version} binaries ready (cached)`,
-      )
-    } else {
-      binarySpinner.text = `Downloading ${dbEngine.displayName} ${version} binaries...`
-      await dbEngine.ensureBinaries(version, ({ message }) => {
-        binarySpinner.text = message
-      })
-      binarySpinner.succeed(
-        `${dbEngine.displayName} ${version} binaries downloaded`,
-      )
+    try {
+      const isInstalled = await dbEngine.isBinaryInstalled(version)
+      if (isInstalled) {
+        binarySpinner.succeed(
+          `${dbEngine.displayName} ${version} binaries ready (cached)`,
+        )
+      } else {
+        binarySpinner.text = `Downloading ${dbEngine.displayName} ${version} binaries...`
+        await dbEngine.ensureBinaries(version, ({ message }) => {
+          binarySpinner.text = message
+        })
+        binarySpinner.succeed(
+          `${dbEngine.displayName} ${version} binaries downloaded`,
+        )
+      }
+    } catch (error) {
+      binarySpinner.fail(`Failed to download ${dbEngine.displayName} binaries`)
+      const e = error as Error
+      console.log()
+      console.log(uiError(e.message))
+      console.log()
+      await pressEnterToContinue()
+      return
     }
   }
 
@@ -335,7 +355,7 @@ export async function handleCreate(): Promise<'main' | void> {
     // For other engines (MySQL, SQLite), allow creating a database named 'postgres'
     if (
       config &&
-      !(config.engine === 'postgresql' && database === 'postgres')
+      !(config.engine === Engine.PostgreSQL && database === 'postgres')
     ) {
       const dbSpinner = createSpinner(`Creating database "${database}"...`)
       dbSpinner.start()
@@ -625,14 +645,14 @@ export async function showContainerSubmenu(
   })
 
   // Run SQL/script - always enabled for file-based DBs (if file exists), server databases need to be running
-  // Qdrant and Meilisearch use REST API and don't support script files - hide the option entirely
-  if (config.engine !== 'qdrant' && config.engine !== 'meilisearch') {
+  // 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 uses scripts, others use SQL
+    // Engine-specific terminology: Redis/Valkey use commands, MongoDB/FerretDB use scripts, others use SQL
     const runScriptLabel =
-      config.engine === 'redis' || config.engine === 'valkey'
+      config.engine === Engine.Redis || config.engine === Engine.Valkey
         ? 'Run command file'
-        : config.engine === 'mongodb'
+        : config.engine === Engine.MongoDB || config.engine === Engine.FerretDB
           ? 'Run script file'
           : 'Run SQL file'
     actionChoices.push({

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

@@ -208,6 +208,13 @@ export async function handleOpenShell(containerName: string): Promise<void> {
     engineSpecificInstalled = false
     engineSpecificValue = null
     engineSpecificInstallValue = null
+  } else if (config.engine === 'couchdb') {
+    // CouchDB uses REST API, open Fauxton dashboard in browser
+    defaultShellName = 'Fauxton Dashboard'
+    engineSpecificCli = null
+    engineSpecificInstalled = false
+    engineSpecificValue = null
+    engineSpecificInstallValue = null
   } else {
     defaultShellName = 'psql'
     engineSpecificCli = 'pgcli'
@@ -259,8 +266,19 @@ export async function handleOpenShell(containerName: string): Promise<void> {
       name: `ℹ Show API info`,
       value: 'api-info',
     })
+  } else if (config.engine === 'couchdb') {
+    // CouchDB: Fauxton dashboard is built-in at /_utils
+    choices.push({
+      name: `◎ Open Fauxton Dashboard in browser`,
+      value: 'default',
+    })
+    // Always show API info option for CouchDB
+    choices.push({
+      name: `ℹ Show API info`,
+      value: 'api-info',
+    })
   } else {
-    // Non-Qdrant/Meilisearch engines: show default shell option
+    // Non-Qdrant/Meilisearch/CouchDB engines: show default shell option
     choices.push({
       name: `>_ Use default shell (${defaultShellName})`,
       value: 'default',
@@ -291,14 +309,15 @@ export async function handleOpenShell(containerName: string): Promise<void> {
     }
   }
 
-  // usql supports SQL databases (PostgreSQL, MySQL, SQLite) - skip for Redis, Valkey, MongoDB, FerretDB, Qdrant, and Meilisearch
+  // usql supports SQL databases (PostgreSQL, MySQL, SQLite) - skip for Redis, Valkey, MongoDB, FerretDB, Qdrant, Meilisearch, and CouchDB
   const isNonSqlEngine =
     config.engine === 'redis' ||
     config.engine === 'valkey' ||
     config.engine === 'mongodb' ||
     config.engine === 'ferretdb' ||
     config.engine === 'qdrant' ||
-    config.engine === 'meilisearch'
+    config.engine === 'meilisearch' ||
+    config.engine === 'couchdb'
   if (!isNonSqlEngine) {
     if (usqlInstalled) {
       choices.push({
@@ -368,6 +387,19 @@ export async function handleOpenShell(containerName: string): Promise<void> {
       console.log(chalk.gray(`  curl http://127.0.0.1:${config.port}/indexes`))
       console.log(chalk.gray(`  curl http://127.0.0.1:${config.port}/health`))
       console.log(chalk.gray(`  curl http://127.0.0.1:${config.port}/stats`))
+    } else if (config.engine === 'couchdb') {
+      console.log(chalk.cyan('CouchDB REST API:'))
+      console.log(chalk.white(`  HTTP: http://127.0.0.1:${config.port}`))
+      console.log(chalk.white(`  Fauxton: http://127.0.0.1:${config.port}/_utils`))
+      console.log()
+      console.log(chalk.cyan('Credentials:'))
+      console.log(chalk.white(`  Username: admin`))
+      console.log(chalk.white(`  Password: admin`))
+      console.log()
+      console.log(chalk.gray('Example curl commands:'))
+      console.log(chalk.gray(`  curl http://127.0.0.1:${config.port}`))
+      console.log(chalk.gray(`  curl http://127.0.0.1:${config.port}/_all_dbs`))
+      console.log(chalk.gray(`  curl -X PUT http://127.0.0.1:${config.port}/mydb`))
     }
     console.log()
     await pressEnterToContinue()
@@ -814,6 +846,29 @@ async function launchShell(
     openInBrowser(dashboardUrl)
     await pressEnterToContinue()
     return
+  } else if (config.engine === 'couchdb') {
+    // CouchDB: Open Fauxton dashboard in browser (served at /_utils)
+    const dashboardUrl = `http://127.0.0.1:${config.port}/_utils`
+    console.log()
+    console.log(chalk.cyan('CouchDB Fauxton Dashboard'))
+    console.log(chalk.gray(`  ${dashboardUrl}`))
+    console.log()
+    console.log(chalk.cyan('Credentials (if prompted):'))
+    console.log(chalk.white(`  Username: admin`))
+    console.log(chalk.white(`  Password: admin`))
+    console.log()
+
+    // Prompt before opening so user can see credentials
+    await escapeablePrompt([
+      {
+        type: 'input',
+        name: 'continue',
+        message: chalk.gray('Press Enter to open in browser...'),
+      },
+    ])
+
+    openInBrowser(dashboardUrl)
+    return
   } else {
     shellCmd = 'psql'
     shellArgs = [connectionString]

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

@@ -71,11 +71,12 @@ export async function handleRunSql(containerName: string): Promise<void> {
 
       // Document/search engines use "Script" terminology
       // MongoDB and FerretDB use JavaScript via mongosh
-      // Qdrant and Meilisearch use REST API (JSON)
+      // Qdrant, Meilisearch, and CouchDB use REST API (JSON)
       case Engine.MongoDB:
       case Engine.FerretDB:
       case Engine.Qdrant:
       case Engine.Meilisearch:
+      case Engine.CouchDB:
         return { type: 'Script', lower: 'script' }
 
       // SQL engines use "SQL" terminology

package/cli/constants.ts

@@ -12,6 +12,7 @@ export const ENGINE_ICONS: Record<string, string> = {
   clickhouse: '🏠',
   qdrant: '🧭',
   meilisearch: '🔍',
+  couchdb: '🛋',
 }
 
 // Visual width of each icon in terminal columns
@@ -30,6 +31,7 @@ export const ENGINE_ICON_WIDTHS: Record<string, number> = {
   clickhouse: 2,
   qdrant: 2,
   meilisearch: 2,
+  couchdb: 1, // 🛋 couch renders narrow
 }
 
 export const DEFAULT_ENGINE_ICON = '▣'

package/cli/helpers.ts

@@ -184,6 +184,16 @@ export type InstalledFerretDBEngine = {
   source: 'downloaded'
 }
 
+export type InstalledCouchDBEngine = {
+  engine: 'couchdb'
+  version: string
+  platform: string
+  arch: string
+  path: string
+  sizeBytes: number
+  source: 'downloaded'
+}
+
 export type InstalledEngine =
   | InstalledPostgresEngine
   | InstalledMariadbEngine
@@ -197,6 +207,7 @@ export type InstalledEngine =
   | InstalledClickHouseEngine
   | InstalledQdrantEngine
   | InstalledMeilisearchEngine
+  | InstalledCouchDBEngine
 
 async function getPostgresVersion(binPath: string): Promise<string | null> {
   const ext = platformService.getExecutableExtension()
@@ -813,6 +824,58 @@ async function getInstalledMeilisearchEngines(): Promise<InstalledMeilisearchEng
   return engines
 }
 
+// Get CouchDB version from binary path
+// Note: CouchDB doesn't support --version flag, so we just verify the binary exists
+// and return null to use the version from the directory name
+async function getCouchDBVersion(binPath: string): Promise<string | null> {
+  const ext = platformService.getExecutableExtension()
+  const couchdbPath = join(binPath, 'bin', `couchdb${ext}`)
+  if (!existsSync(couchdbPath)) {
+    return null
+  }
+  // CouchDB is an Erlang app that tries to start when run with any args
+  // Just return null to use directory-parsed version
+  return null
+}
+
+// Get installed CouchDB engines from downloaded binaries
+async function getInstalledCouchDBEngines(): Promise<InstalledCouchDBEngine[]> {
+  const binDir = paths.bin
+
+  if (!existsSync(binDir)) {
+    return []
+  }
+
+  const entries = await readdir(binDir, { withFileTypes: true })
+  const engines: InstalledCouchDBEngine[] = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (!entry.name.startsWith('couchdb-')) continue
+
+    const parsed = parseEngineDirectory(entry.name, 'couchdb-', binDir)
+    if (!parsed) continue
+
+    const actualVersion =
+      (await getCouchDBVersion(parsed.path)) || parsed.version
+    const sizeBytes = await calculateDirectorySize(parsed.path)
+
+    engines.push({
+      engine: 'couchdb',
+      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()
@@ -899,6 +962,7 @@ const ENGINE_PREFIXES = [
   'clickhouse-',
   'qdrant-',
   'meilisearch-',
+  'couchdb-',
 ] as const
 
 /**
@@ -941,6 +1005,7 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     clickhouseEngines,
     qdrantEngines,
     meilisearchEngines,
+    couchdbEngines,
   ] = await Promise.all([
     getInstalledPostgresEngines(),
     getInstalledMariadbEngines(),
@@ -954,6 +1019,7 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     getInstalledClickHouseEngines(),
     getInstalledQdrantEngines(),
     getInstalledMeilisearchEngines(),
+    getInstalledCouchDBEngines(),
   ])
 
   return [
@@ -969,6 +1035,7 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     ...clickhouseEngines,
     ...qdrantEngines,
     ...meilisearchEngines,
+    ...couchdbEngines,
   ]
 }
 
@@ -984,4 +1051,5 @@ export {
   getInstalledClickHouseEngines,
   getInstalledQdrantEngines,
   getInstalledMeilisearchEngines,
+  getInstalledCouchDBEngines,
 }

package/cli/ui/prompts.ts

@@ -15,7 +15,7 @@ import {
   installEngineDependencies,
 } from '../../core/dependency-manager'
 import { getEngineDependencies } from '../../config/os-dependencies'
-import { getEngineIcon } from '../constants'
+import { getEngineIcon, getEngineIconPadded } from '../constants'
 import { type ContainerConfig, type Engine, type BackupFormatType } from '../../types'
 
 // Navigation sentinel values for menu navigation
@@ -221,7 +221,7 @@ export async function promptEngine(options?: {
     | inquirer.Separator
 
   const choices: Choice[] = engines.map((e) => ({
-    name: `${getEngineIcon(e.name)} ${e.displayName} ${chalk.gray(`(versions: ${e.supportedVersions.join(', ')})`)}`,
+    name: `${getEngineIconPadded(e.name)} ${e.displayName} ${chalk.gray(`(versions: ${e.supportedVersions.join(', ')})`)}`,
     value: e.name,
     short: e.displayName,
   }))
@@ -233,6 +233,7 @@ export async function promptEngine(options?: {
       name: `${chalk.blue('⌂')} Back to main menu ${chalk.gray('(esc)')}`,
       value: MAIN_MENU_VALUE,
     })
+    choices.push(new inquirer.Separator())
   }
 
   const { engine } = await escapeablePrompt<{ engine: string }>([

package/config/backup-formats.ts

@@ -22,6 +22,7 @@ import {
   type ClickHouseFormat,
   type QdrantFormat,
   type MeilisearchFormat,
+  type CouchDBFormat,
   type BackupFormatType,
 } from '../types'
 
@@ -53,6 +54,7 @@ export const BACKUP_FORMATS: {
   [Engine.ClickHouse]: EngineBackupFormats<ClickHouseFormat>
   [Engine.Qdrant]: EngineBackupFormats<QdrantFormat>
   [Engine.Meilisearch]: EngineBackupFormats<MeilisearchFormat>
+  [Engine.CouchDB]: EngineBackupFormats<CouchDBFormat>
 } = {
   [Engine.PostgreSQL]: {
     formats: {
@@ -252,6 +254,18 @@ export const BACKUP_FORMATS: {
     supportsFormatChoice: false, // Only snapshot format supported
     defaultFormat: 'snapshot',
   },
+  [Engine.CouchDB]: {
+    formats: {
+      json: {
+        extension: '.json',
+        label: '.json',
+        description: 'JSON backup - all documents exported as JSON',
+        spinnerLabel: 'JSON',
+      },
+    },
+    supportsFormatChoice: false, // Only JSON format supported
+    defaultFormat: 'json',
+  },
 }
 
 /**