thingd-cli 0.6.0 → 0.8.0

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm version](https://badge.fury.io/js/thingd-cli.svg)](https://www.npmjs.com/package/thingd-cli)
 
-Admin and operator CLI for [thingd](https://www.npmjs.com/package/thingd).
+Command-line interface, Interactive TUI Dashboard, and Model Context Protocol (MCP) server for [thingd](https://www.npmjs.com/package/thingd).
 
-This package provides the `thingd` binary. It uses the public `thingd` SDK for store access and can connect to a local store or a remote sidecar through `THINGD_URL`.
+This package provides the unified `thingd` binary, which serves as a persistent stdio/HTTP MCP server for AI editors (Cursor, Claude Desktop), an interactive terminal UI dashboard for database operations, and a scriptable JSON utility to inspect and manage local or remote databases.
 
 ## Installation
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAKhB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AA0CF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AA+UD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAiBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAKhB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AA0CF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AA+UD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA2BxE"}

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
@@ -359,13 +360,24 @@ export function resolveConnection(context) {
     const url = stringFlag(context.parsed, "url") ?? context.env.THINGD_URL;
     const path = url ?? stringFlag(context.parsed, "path") ?? context.env.THINGD_PATH ?? defaultThingdDbPath();
     const cloud = isCloudPath(path);
-    const driver = parseDriver(stringFlag(context.parsed, "driver") ?? context.env.THINGD_DRIVER);
+    let driver = parseDriver(stringFlag(context.parsed, "driver") ?? context.env.THINGD_DRIVER);
+    if (!driver) {
+        if (cloud) {
+            driver = "cloud";
+        }
+        else if (path !== ":memory:") {
+            driver = "native";
+        }
+        else {
+            driver = "memory";
+        }
+    }
     if (!cloud && path === defaultThingdDbPath()) {
         ensureThingdDir();
     }
     return {
         path,
-        driver: driver ?? (cloud ? "cloud" : undefined),
+        driver,
         authToken: stringFlag(context.parsed, "auth-token") ?? context.env.THINGD_AUTH_TOKEN,
         cloud,
     };
@@ -506,6 +518,15 @@ function writeJson(target, data, pretty) {
 function writeText(target, text) {
     target.write(text.endsWith("\n") ? text : `${text}\n`);
 }
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+let isMain = false;
+if (process.argv[1]) {
+    try {
+        isMain = import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href;
+    }
+    catch {
+        // Ignore realpath resolution errors.
+    }
+}
+if (isMain) {
     process.exitCode = await runCli();
 }

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAY7C,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCnE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAY7C,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDnE"}

package/dist/install.js

@@ -9,12 +9,23 @@ export async function runInstall(context) {
     const dbPath = defaultThingdDbPath();
     const driver = detectDriver();
     ensureThingdDir();
-    const config = generateMcpConfig(nodePath, cliPath, dbPath, driver);
+    const globalBin = findGlobalBinPath();
+    const config = globalBin
+        ? {
+            command: globalBin,
+            args: ["mcp", "--path", dbPath, "--driver", driver],
+        }
+        : generateMcpConfig(nodePath, cliPath, dbPath, driver);
     context.stderr.write(`\n${pc.bold("thingd install")}\n\n`);
     context.stderr.write(`  ${pc.green("✓")} Database path: ${pc.cyan(dbPath)}\n`);
     context.stderr.write(`  ${pc.green("✓")} Driver: ${pc.cyan(driver)}\n`);
-    context.stderr.write(`  ${pc.green("✓")} Node: ${pc.cyan(nodePath)}\n`);
-    context.stderr.write(`  ${pc.green("✓")} CLI:   ${pc.cyan(cliPath)}\n\n`);
+    if (globalBin) {
+        context.stderr.write(`  ${pc.green("✓")} Command: ${pc.cyan(globalBin)}\n\n`);
+    }
+    else {
+        context.stderr.write(`  ${pc.green("✓")} Node: ${pc.cyan(nodePath)}\n`);
+        context.stderr.write(`  ${pc.green("✓")} CLI:   ${pc.cyan(cliPath)}\n\n`);
+    }
     const claudeResult = updateClaudeDesktopConfig(config);
     if (claudeResult.updated) {
         context.stderr.write(`  ${pc.bold("Claude Desktop:")}\n`);
@@ -34,6 +45,22 @@ export async function runInstall(context) {
     context.stdout.write(`${JSON.stringify(fullConfig, null, 2)}\n`);
     context.stderr.write(`\n  Restart Claude Desktop to activate. Cursor activates immediately after pasting.\n\n`);
 }
+function findGlobalBinPath() {
+    try {
+        const cliPath = resolveCliPath();
+        // In standard npm/nvm/pnpm global installations:
+        // CLI is at <prefix>/lib/node_modules/thingd-cli/dist/index.js
+        // Binary is at <prefix>/bin/thingd
+        const candidate = resolve(cliPath, "../../../../../bin/thingd");
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return null;
+}
 function resolveCliPath() {
     const scriptPath = process.argv[1];
     if (!scriptPath) {

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,YAAY,CAAC;AAGrD,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/D"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAA6B,MAAM,YAAY,CAAC;AAGxE,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/D"}

package/dist/mcp.js

@@ -1,11 +1,16 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { withDb } from "./index.js";
+import { resolveConnection, withDb } from "./index.js";
 import { createThingdMcpServer } from "./mcp/index.js";
 export async function runMcp(context) {
+    const connection = resolveConnection(context);
     await withDb(context, async (db) => {
         // We pass empty options to createThingdMcpServer so it uses default audit behavior
         const server = createThingdMcpServer(db);
         const transport = new StdioServerTransport();
+        context.stderr.write(`\nthingd stdio MCP server started successfully.\n`);
+        context.stderr.write(`  ✓ Database: ${connection.path}\n`);
+        context.stderr.write(`  ✓ Driver:   ${connection.driver ?? "memory"}\n`);
+        context.stderr.write(`  ✓ Transport: Stdio (listening silently on stdin)\n\n`);
         await server.connect(transport);
         // Keep the process alive and the database connection open
         // so the MCP server can continue to receive messages over stdio.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "thingd-cli",
-  "version": "0.6.0",
-  "description": "Admin and operator CLI for thingd.",
+  "version": "0.8.0",
+  "description": "Command-line interface, Interactive TUI Dashboard, and MCP server for thingd.",
   "type": "module",
   "author": "Sayan Mohsin",
   "license": "Apache-2.0",
@@ -33,7 +33,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "thingd": "0.6.0"
+    "thingd": "0.8.0"
   },
   "engines": {
     "node": ">=20"