grain-tools 0.10.8 → 0.10.9

package/README.md

@@ -105,38 +105,41 @@ named connection profile when you open **Grain: Show Welcome Guide** or
 
 ## Quick Start: MCP Agents
 
-### One command
+### Install once, then connect every client
 
 ```
-npx -y grain-tools --stdio
+grain --stdio
 ```
 
-That is the command every MCP client is given, on every platform. There is no
-second setup path.
+This is the normal command for an installed Grain setup on every platform. It
+attaches to the shared local Grain service when that service is available, so
+connections and result tabs stay shared. If the service cannot be reached, the
+bridge reports isolated mode and its sessions do not appear in the editor.
 
 1. Run **Grain: Manage Connections** and confirm your active connection.
 2. Open the Grain settings panel and **enable the MCP server** (`grain.mcpEnabled`).
    This is required and ships **off** — the daemon serves no MCP surface until you turn it on.
 3. Keep safe mode enabled unless you explicitly want agents to run mutating SQL.
 4. Give your client the command:
-   - **Claude Code**: `claude mcp add grain -- npx -y grain-tools --stdio`
+   - **Claude Code**: `claude mcp add grain -- grain --stdio`
    - **Cursor**: Settings → MCP Servers → Add new MCP server, type `command`,
-     command `npx -y grain-tools --stdio`
-   - **VS Code**: open the Extensions view, search `@mcp Grain`, and install it
-     into your user profile or the current workspace — the gallery entry carries
-     the command
+     command `grain --stdio`
+   - **VS Code**: add `grain --stdio` through **MCP: Open User Configuration**;
+     VS Code uses a `servers` key rather than `mcpServers`
    - **Claude Desktop and other file-configured clients**: see
      [the setup guide](docs/engineering/guides/mcp-client-setup.md), which
      transcribes the same command into that client's config file
 
-This bridges to the daemon the VS Code extension is already running, so agent
-queries and sessions show up in the results grid alongside anything you run from
-the editor. It works with every MCP client — including ones that cannot send
+This bridges to the shared Grain service, so agent queries and sessions show up
+in the results grid alongside anything you run from the editor. It works with
+every MCP client — including ones that cannot send
 custom HTTP headers, such as Claude Desktop — and it needs no credential in your
 config, because the bridge reads the daemon's access token itself.
 
-`-y` is not decoration: an MCP client starts the server with no terminal
-attached, so npm's install prompt would have nobody to answer it.
+To try Grain without installing it, use `npx -y grain-tools --stdio`. This
+requires Node.js and may run in isolated mode when no shared Grain service is
+available, so it is a trial and headless path rather than the recommended
+desktop setup.
 
 Enabling `grain.mcpEnabled` in the Grain settings panel is required
 for this stdio bridge too. Launching the bridge without it produces a clear
@@ -199,7 +202,7 @@ command carries its own connection profiles through the environment:
 
 ```bash
 GRAIN_CONNECTIONS='[{"id":"analytics","name":"Analytics","type":"postgres","host":"localhost","port":5432,"user":"analyst","database":"warehouse","password":"YOUR_PASSWORD"}]' \
-  npx -y grain-tools --stdio
+  grain --stdio --embedded
 ```
 
 The same variable goes in an `env` block for a file-configured client; see

package/dist/web-app.html

@@ -150744,8 +150744,8 @@ function SettingsPanel({ onSave, onClose, onShowWelcome, initialTab = "general"
   const mcpClientConfig = `{
   "mcpServers": {
     "grain": {
-      "command": "npx",
-      "args": ["-y", "grain-tools", "--stdio"]
+      "command": "grain",
+      "args": ["--stdio"]
     }
   }
 }`;
@@ -151291,7 +151291,7 @@ function SettingsPanel({ onSave, onClose, onShowWelcome, initialTab = "general"
                       /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sp-settings-row-label", children: "Client configuration (recommended)" }),
                       /* @__PURE__ */ jsxRuntimeExports.jsx(SettingsCopyButton, { text: mcpClientConfig, label: "Copy client configuration" })
                     ] }),
-                    /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sp-settings-mcp-description", children: "Works with every MCP client, including ones that cannot send custom headers. The server reads its own access token, so nothing secret goes in your config." }),
+                    /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sp-settings-mcp-description", children: "Uses the installed Grain service, so connections and result tabs stay shared. GUI clients that cannot find your shell PATH may need the full path to Grain." }),
                     /* @__PURE__ */ jsxRuntimeExports.jsx("pre", { className: "sp-settings-code-block", "data-testid": "mcp-client-config", children: mcpClientConfig })
                   ] }),
                   /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "sp-settings-guide-section", children: [

package/out/server/standalone.js

@@ -21724,6 +21724,9 @@ async function probeRegistration(runner, command, args) {
   const result = await runner.run(command, args);
   return result.exitCode === 0;
 }
+function isCommandMissing(error52) {
+  return error52?.code === "ENOENT";
+}
 function createSupervisorAdapter(platform2, runner, uid) {
   if (platform2 === "darwin") {
     const target = (identifier) => `gui/${uid}/${identifier}`;
@@ -21736,10 +21739,26 @@ function createSupervisorAdapter(platform2, runner, uid) {
   }
   if (platform2 === "linux") {
     return {
-      isRegistered: (identifier) => probeRegistration(runner, "systemctl", ["--user", "is-enabled", identifier]),
+      isRegistered: async (identifier) => {
+        try {
+          return await probeRegistration(runner, "systemctl", ["--user", "is-enabled", identifier]);
+        } catch (error52) {
+          if (isCommandMissing(error52)) {
+            return false;
+          }
+          throw error52;
+        }
+      },
       register: async (_unitPath, identifier) => {
-        await runRegistration(platform2, runner, "systemctl", ["--user", "daemon-reload"]);
-        await runRegistration(platform2, runner, "systemctl", ["--user", "enable", identifier]);
+        try {
+          await runRegistration(platform2, runner, "systemctl", ["--user", "daemon-reload"]);
+          await runRegistration(platform2, runner, "systemctl", ["--user", "enable", identifier]);
+        } catch (error52) {
+          if (isCommandMissing(error52)) {
+            throw new ServiceManagerMissingError("systemctl was not found");
+          }
+          throw error52;
+        }
       },
       unregister: async (identifier) => {
         await runner.run("systemctl", ["--user", "stop", identifier]);
@@ -21766,13 +21785,15 @@ function createSupervisorAdapter(platform2, runner, uid) {
     start: (identifier) => runStart(runner, "schtasks", ["/Run", "/TN", identifier])
   };
 }
-var import_child_process2, UserServicesForbiddenError;
+var import_child_process2, UserServicesForbiddenError, ServiceManagerMissingError;
 var init_supervisorAdapter = __esm({
   "src/server/install/supervisorAdapter.ts"() {
     "use strict";
     import_child_process2 = require("child_process");
     UserServicesForbiddenError = class extends Error {
     };
+    ServiceManagerMissingError = class extends UserServicesForbiddenError {
+    };
   }
 });
 
@@ -21783,7 +21804,7 @@ var require_package = __commonJS({
       name: "grain",
       displayName: "Grain SQL",
       description: "Run SQL in VS Code and expose safe, visible MCP database tools for Claude, Cursor, and other AI agents.",
-      version: "0.10.8",
+      version: "0.10.9",
       license: "UNLICENSED",
       mcpName: "io.github.pattrnlabs/grain",
       publisher: "pattrnlabs",
@@ -22185,7 +22206,7 @@ var require_package = __commonJS({
             "grain.mcpEnabled": {
               type: "boolean",
               default: false,
-              description: "(Beta) Serve the MCP surface so LLM agents can interact with Grain. When off, the daemon does not register /mcp at all. Changing this restarts the daemon. A bridge you launch yourself with `npx -y grain-tools --stdio` is treated as explicit consent and still works; to refuse MCP everywhere, set mcp.enabled to false in ~/.grain/daemon.json.",
+              description: "(Beta) Serve the MCP surface so LLM agents can interact with Grain. When off, the daemon does not register /mcp at all. Changing this restarts the daemon. An explicitly launched stdio bridge is treated as consent and still works; to refuse MCP everywhere, set mcp.enabled to false in ~/.grain/daemon.json.",
               order: 20
             },
             "grain.mcpSafeMode": {
@@ -249855,9 +249876,15 @@ async function installCommand(deps = {}) {
         } catch {
         }
         writeServiceMode(fileSystem, configHome, { mode: "spawn-on-demand" });
-        writeOutput(
-          "This machine does not permit background services. Grain will start when needed instead of staying running; the first request may take a moment longer."
-        );
+        if (error52 instanceof ServiceManagerMissingError) {
+          writeOutput(
+            "This machine has no service manager (systemctl was not found). Grain will start when needed instead of staying running; the first request may take a moment longer."
+          );
+        } else {
+          writeOutput(
+            "This machine does not permit background services. Grain will start when needed instead of staying running; the first request may take a moment longer."
+          );
+        }
         return 0;
       }
       const failure = new AppError("service_supervisor_registration_failed", describeError(error52), {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grain-tools",
-  "version": "0.10.8",
+  "version": "0.10.9",
   "mcpName": "io.github.pattrnlabs/grain",
   "description": "Standalone Grain MCP database server for VS Code, Claude Desktop, Cursor, and other MCP clients.",
   "main": "out/server/standalone.js",

package/server.json

@@ -8,14 +8,14 @@
     "source": "github",
     "id": "1348511592"
   },
-  "version": "0.10.8",
+  "version": "0.10.9",
   "websiteUrl": "https://grain.tools",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "grain-tools",
-      "version": "0.10.8",
+      "version": "0.10.9",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {