@firenet-designs/fnd-cli 2.3.0 → 2.3.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @firenet-designs/fnd-cli
 $ fnd COMMAND
 running command...
 $ fnd (--version)
-@firenet-designs/fnd-cli/2.3.0 linux-x64 node-v24.18.0
+@firenet-designs/fnd-cli/2.3.1 linux-x64 node-v24.18.0
 $ fnd --help [COMMAND]
 USAGE
   $ fnd COMMAND
@@ -62,7 +62,7 @@ EXAMPLES
   $ fnd backfill-project my-store "extra hints"
 ```
 
-_See code: [src/commands/backfill-project.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.0/src/commands/backfill-project.ts)_
+_See code: [src/commands/backfill-project.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.1/src/commands/backfill-project.ts)_
 
 ## `fnd create-app`
 
@@ -83,7 +83,7 @@ EXAMPLES
   $ fnd create-app
 ```
 
-_See code: [src/commands/create-app.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.0/src/commands/create-app.ts)_
+_See code: [src/commands/create-app.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.1/src/commands/create-app.ts)_
 
 ## `fnd create-project [SHOP]`
 
@@ -113,7 +113,7 @@ EXAMPLES
   $ fnd create-project my-store "Acme storefront, Klaviyo"
 ```
 
-_See code: [src/commands/create-project.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.0/src/commands/create-project.ts)_
+_See code: [src/commands/create-project.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.1/src/commands/create-project.ts)_
 
 ## `fnd help [COMMAND]`
 
@@ -165,7 +165,7 @@ EXAMPLES
   $ fnd token -s mystore -i <id> -c <secret> --write ./.mcp.json
 ```
 
-_See code: [src/commands/token.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.0/src/commands/token.ts)_
+_See code: [src/commands/token.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.1/src/commands/token.ts)_
 
 ## `fnd workspace`
 
@@ -190,11 +190,11 @@ DESCRIPTION
   Open a remote workspace: two-way sync the current directory to a remote Linux box with Mutagen and drop into a shell
   there, tearing the sync down on exit.
 
-  Both sides keep a real copy on local disk and only deltas cross the network, so the remote reads files at native speed
-  (unlike reverse SSHFS). Conflicting edits on both ends are flagged rather than silently overwritten; pass --source to
-  auto-resolve them in favour of one side. Mutagen connects the normal direction (this machine → remote over SSH) and
-  auto-deploys its agent to the remote, so no local SSH server, reverse tunnel, or authorized_keys trust is required.
-  You need the Mutagen CLI installed on THIS machine.
+  Both sides keep a real copy on local disk and only deltas cross the network, so the remote reads files at native
+  speed. Conflicting edits on both ends are flagged rather than silently overwritten; pass --source to auto-resolve them
+  in favour of one side. Mutagen connects the normal direction (this machine → remote over SSH) and auto-deploys its
+  agent to the remote, so no local SSH server, reverse tunnel, or authorized_keys trust is required. You need the
+  Mutagen CLI installed on THIS machine.
 
 EXAMPLES
   $ fnd workspace --ssh user@203.0.113.4
@@ -208,7 +208,7 @@ EXAMPLES
   $ fnd workspace --ssh user@host --devtools 9333:9222
 ```
 
-_See code: [src/commands/workspace/index.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.0/src/commands/workspace/index.ts)_
+_See code: [src/commands/workspace/index.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.1/src/commands/workspace/index.ts)_
 
 ## `fnd workspace cleanup`
 
@@ -236,5 +236,5 @@ EXAMPLES
   $ fnd workspace cleanup --ssh user@host --remote-dir /home/fnd/cole/fnd-cli
 ```
 
-_See code: [src/commands/workspace/cleanup.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.0/src/commands/workspace/cleanup.ts)_
+_See code: [src/commands/workspace/cleanup.ts](https://github.com/FireNet-Designs/fnd-cli/blob/v2.3.1/src/commands/workspace/cleanup.ts)_
 <!-- commandsstop -->

package/dist/commands/workspace/index.js

@@ -3,7 +3,7 @@ import chalk from 'chalk';
 import { spawn } from 'node:child_process';
 import { browserDebugInstructions, buildContext, buildMutagenCreateArgs, buildMutagenFlushArgs, buildMutagenTerminateArgs, buildRemoteScript, DEFAULT_MOUNT_BASE, hasMutagen, hasSshClient, isLocalDebugPortLive, mutagenInstallInstructions, parseDevtoolsPort, parseSshTarget, runMutagen, runRemoteCleanup, } from '../../lib/workspace.js';
 export default class Workspace extends Command {
-    static description = 'Open a remote workspace: two-way sync the current directory to a remote Linux box with Mutagen and drop into a shell there, tearing the sync down on exit.\n\nBoth sides keep a real copy on local disk and only deltas cross the network, so the remote reads files at native speed (unlike reverse SSHFS). Conflicting edits on both ends are flagged rather than silently overwritten; pass --source to auto-resolve them in favour of one side. Mutagen connects the normal direction (this machine → remote over SSH) and auto-deploys its agent to the remote, so no local SSH server, reverse tunnel, or authorized_keys trust is required. You need the Mutagen CLI installed on THIS machine.';
+    static description = 'Open a remote workspace: two-way sync the current directory to a remote Linux box with Mutagen and drop into a shell there, tearing the sync down on exit.\n\nBoth sides keep a real copy on local disk and only deltas cross the network, so the remote reads files at native speed. Conflicting edits on both ends are flagged rather than silently overwritten; pass --source to auto-resolve them in favour of one side. Mutagen connects the normal direction (this machine → remote over SSH) and auto-deploys its agent to the remote, so no local SSH server, reverse tunnel, or authorized_keys trust is required. You need the Mutagen CLI installed on THIS machine.';
     static examples = [
         '<%= config.bin %> <%= command.id %> --ssh user@203.0.113.4',
         '<%= config.bin %> <%= command.id %> --ssh user@host --source local',

package/dist/lib/workspace.d.ts

@@ -12,15 +12,15 @@
  *   │  copy on disk)      │   deltas only  │                              │
  *   └─────────────────────┘                └──────────────────────────────┘
  *
- * Unlike the old reverse-SSHFS approach, BOTH sides hold a real copy on local
- * disk and Mutagen propagates only the deltas. The remote therefore reads files
- * at native disk speed (no per-file network round-trips), which is the whole
- * point — lint/build/test on the remote stop being IO-bound on the tunnel.
+ * BOTH sides hold a real copy on local disk and Mutagen propagates only the
+ * deltas. The remote therefore reads files at native disk speed (no per-file
+ * network round-trips), so lint/build/test on the remote are not IO-bound on
+ * the tunnel.
  *
- * Mutagen connects the normal direction (local → remote over SSH), so — unlike
- * SSHFS — we need NO local SSH server, NO reverse tunnel, and NO authorized_keys
- * trust dance. Mutagen auto-deploys its agent to the remote over that same SSH
- * connection; nothing to install on the remote by hand.
+ * Mutagen connects the normal direction (local → remote over SSH), so we need
+ * NO local SSH server, NO reverse tunnel, and NO authorized_keys trust dance.
+ * Mutagen auto-deploys its agent to the remote over that same SSH connection;
+ * nothing to install on the remote by hand.
  *
  * The one reverse tunnel that remains is optional and unrelated to files: with
  * --devtools we open `ssh -R` so the remote's chrome-devtools MCP can reach the
@@ -95,9 +95,10 @@ export declare const buildRemoteScript: (ctx: WorkspaceContext) => string;
 /** Run the remote-side teardown (strip this project's chrome-devtools MCP) over a fresh ssh connection. */
 export declare const runRemoteCleanup: (target: string, remoteDir: string) => Promise<number>;
 /**
- * The remote-side teardown script: strip this project's chrome-devtools MCP from
- * the remote's ~/.claude.json. A no-op if there is nothing to undo. The synced
- * files themselves are left in place — they are a real copy, not a mount.
+ * The remote-side teardown script: strip this project's chrome-devtools MCP via
+ * the `claude` CLI. Runs from inside the workspace dir so local scope resolves to
+ * the right project. A no-op if there is nothing to undo. The synced files
+ * themselves are left in place — they are a real copy, not a mount.
  */
 export declare const buildCleanupScript: (remoteDir: string) => string;
 /** True if an `ssh` client is on PATH (works on Windows, macOS, Linux). */

package/dist/lib/workspace.js

@@ -64,64 +64,43 @@ export const buildContext = (opts) => {
 };
 /** POSIX single-quote a string so it can be embedded safely in the remote shell script. */
 export const shQuote = (value) => `'${value.replaceAll("'", `'\\''`)}'`;
+/** MCP server name registered for the workspace's chrome-devtools tunnel. */
+const DEVTOOLS_MCP_NAME = 'chrome-devtools';
 /**
- * Node program (run on the REMOTE) that adds the chrome-devtools MCP to the
- * remote's ~/.claude.json under this project (the remote dir). Project-scoped,
- * never the top-level mcpServers, so it is not globally exposed. Reads the
- * remote dir and remote tunnel port from the environment.
+ * Bash lines (run on the REMOTE, from inside the workspace dir) that register the
+ * chrome-devtools MCP with the `claude` CLI. Local scope keys off the current
+ * directory, so this only affects the workspace project — never a global server.
+ * A prior entry is cleared first so a re-connect after a crashed session is
+ * idempotent. Skips gracefully if the claude CLI is missing.
+ *
+ * The block runs inside a login shell (`$SHELL -lc`): the outer script arrives as
+ * a non-login ssh command whose PATH lacks the node/nvm/volta/Homebrew dirs that
+ * login profiles add, so a bare `command -v claude` misses an installed CLI. A
+ * login shell reproduces the same PATH the interactive session below gets.
  */
-const claudeDevtoolsAddProgram = () => [
-    "const fs = require('node:fs');",
-    "const os = require('node:os');",
-    "const path = require('node:path');",
-    "const file = path.join(os.homedir(), '.claude.json');",
-    'let data = {};',
-    "try { data = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { data = {}; }",
-    'const mount = process.env.FND_MOUNT;',
-    'const port = process.env.FND_DEVTOOLS_PORT;',
-    'if (!data.projects) data.projects = {};',
-    'if (!data.projects[mount]) data.projects[mount] = {};',
-    'const project = data.projects[mount];',
-    'if (!project.mcpServers) project.mcpServers = {};',
-    "project.mcpServers['chrome-devtools'] = { command: 'npx', args: ['-y', 'chrome-devtools-mcp@latest', '--browserUrl', 'http://127.0.0.1:' + port] };",
-    String.raw `fs.writeFileSync(file, JSON.stringify(data, null, 2) + '\n');`,
-];
-/**
- * Node program (run on the REMOTE) that removes the chrome-devtools MCP this
- * workspace added for its project from ~/.claude.json, dropping an emptied
- * mcpServers map. No-op if the file or entry is absent.
- */
-const claudeDevtoolsRemoveProgram = () => [
-    "const fs = require('node:fs');",
-    "const os = require('node:os');",
-    "const path = require('node:path');",
-    "const file = path.join(os.homedir(), '.claude.json');",
-    'let data;',
-    "try { data = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { process.exit(0); }",
-    'const mount = process.env.FND_MOUNT;',
-    'const project = data.projects && data.projects[mount];',
-    "if (project && project.mcpServers && project.mcpServers['chrome-devtools']) {",
-    "  delete project.mcpServers['chrome-devtools'];",
-    '  if (Object.keys(project.mcpServers).length === 0) delete project.mcpServers;',
-    String.raw `  fs.writeFileSync(file, JSON.stringify(data, null, 2) + '\n');`,
-    "  console.log('Removed chrome-devtools MCP config for ' + mount + '.');",
-    '}',
-];
+const claudeDevtoolsAddScript = (remotePort, okMessage) => {
+    const body = [
+        'if command -v claude >/dev/null 2>&1; then',
+        `  claude mcp remove ${DEVTOOLS_MCP_NAME} >/dev/null 2>&1 || true`,
+        `  claude mcp add ${DEVTOOLS_MCP_NAME} -- npx -y chrome-devtools-mcp@latest --browserUrl http://127.0.0.1:${remotePort}`,
+        `  echo ${shQuote(okMessage)}`,
+        'else',
+        '  echo "WARNING: claude CLI not found on the remote; skipped chrome-devtools MCP config." >&2',
+        'fi',
+    ].join('\n');
+    return [`"\${SHELL:-bash}" -lc ${shQuote(body)}`];
+};
 /**
- * Wrap a node program in a bash snippet that runs it on the remote with FND_MOUNT
- * (and optionally FND_DEVTOOLS_PORT) in the environment, skipping gracefully if
- * node is missing.
+ * Bash lines (run on the REMOTE, from inside the workspace dir) that remove the
+ * chrome-devtools MCP this workspace registered. Local scope keys off the current
+ * directory, so it targets only the workspace project. No-op if the entry or the
+ * claude CLI is absent. Runs under a login shell for the same PATH reason as
+ * `claudeDevtoolsAddScript`.
  */
-const runNodeOnRemote = (program, env, okMessage) => [
-    'if command -v node >/dev/null 2>&1; then',
-    `  ${env} node <<'FND_NODE_EOF'`,
-    ...program,
-    'FND_NODE_EOF',
-    ...(okMessage ? [`  echo ${shQuote(okMessage)}`] : []),
-    'else',
-    '  echo "WARNING: node not found on the remote; skipped chrome-devtools MCP config." >&2',
-    'fi',
-];
+const claudeDevtoolsRemoveScript = () => {
+    const body = ['if command -v claude >/dev/null 2>&1; then', `  claude mcp remove ${DEVTOOLS_MCP_NAME}`, 'fi'].join('\n');
+    return [`"\${SHELL:-bash}" -lc ${shQuote(body)}`];
+};
 /**
  * The bash script the remote runs for the interactive session. Mutagen already
  * keeps the directory in sync, so this just makes sure the directory exists,
@@ -130,15 +109,16 @@ const runNodeOnRemote = (program, env, okMessage) => [
 export const buildRemoteScript = (ctx) => {
     const dir = shQuote(ctx.remoteDir);
     const devtoolsSetup = ctx.devtools
-        ? runNodeOnRemote(claudeDevtoolsAddProgram(), `FND_MOUNT=${dir} FND_DEVTOOLS_PORT=${ctx.devtools.remote}`, `Configured chrome-devtools MCP for this workspace (browser via 127.0.0.1:${ctx.devtools.remote}).`)
+        ? claudeDevtoolsAddScript(ctx.devtools.remote, `Configured chrome-devtools MCP for this workspace (browser via 127.0.0.1:${ctx.devtools.remote}).`)
         : [];
     return [
         'set -u',
         `DIR=${dir}`,
         // Mutagen creates the sync root, but ensure it exists so `cd` never races it.
         'mkdir -p "$DIR" || { echo "ERROR: could not create $DIR" >&2; exit 1; }',
-        ...devtoolsSetup,
         'cd "$DIR" || { echo "ERROR: could not enter $DIR" >&2; exit 1; }',
+        // Register the MCP from inside $DIR: `claude mcp add` local scope keys off cwd.
+        ...devtoolsSetup,
         'echo "Workspace ready at $DIR — files sync in the background (exit to stop syncing)."',
         // eslint-disable-next-line no-template-curly-in-string -- shell parameter expansion, not a JS template
         '"${SHELL:-bash}" -l',
@@ -151,11 +131,16 @@ export const runRemoteCleanup = (target, remoteDir) => new Promise((resolve, rej
     child.once('close', (code) => resolve(code ?? 0));
 });
 /**
- * The remote-side teardown script: strip this project's chrome-devtools MCP from
- * the remote's ~/.claude.json. A no-op if there is nothing to undo. The synced
- * files themselves are left in place — they are a real copy, not a mount.
+ * The remote-side teardown script: strip this project's chrome-devtools MCP via
+ * the `claude` CLI. Runs from inside the workspace dir so local scope resolves to
+ * the right project. A no-op if there is nothing to undo. The synced files
+ * themselves are left in place — they are a real copy, not a mount.
  */
-export const buildCleanupScript = (remoteDir) => runNodeOnRemote(claudeDevtoolsRemoveProgram(), `FND_MOUNT=${shQuote(remoteDir)}`).join('\n');
+export const buildCleanupScript = (remoteDir) => [
+    `DIR=${shQuote(remoteDir)}`,
+    'cd "$DIR" 2>/dev/null || { echo "Nothing to clean up: $DIR is gone." >&2; exit 0; }',
+    ...claudeDevtoolsRemoveScript(),
+].join('\n');
 /** True if an `ssh` client is on PATH (works on Windows, macOS, Linux). */
 export const hasSshClient = () => {
     const result = spawnSync('ssh', ['-V'], { stdio: 'ignore' });

package/oclif.manifest.json

@@ -235,7 +235,7 @@
     "workspace": {
       "aliases": [],
       "args": {},
-      "description": "Open a remote workspace: two-way sync the current directory to a remote Linux box with Mutagen and drop into a shell there, tearing the sync down on exit.\n\nBoth sides keep a real copy on local disk and only deltas cross the network, so the remote reads files at native speed (unlike reverse SSHFS). Conflicting edits on both ends are flagged rather than silently overwritten; pass --source to auto-resolve them in favour of one side. Mutagen connects the normal direction (this machine → remote over SSH) and auto-deploys its agent to the remote, so no local SSH server, reverse tunnel, or authorized_keys trust is required. You need the Mutagen CLI installed on THIS machine.",
+      "description": "Open a remote workspace: two-way sync the current directory to a remote Linux box with Mutagen and drop into a shell there, tearing the sync down on exit.\n\nBoth sides keep a real copy on local disk and only deltas cross the network, so the remote reads files at native speed. Conflicting edits on both ends are flagged rather than silently overwritten; pass --source to auto-resolve them in favour of one side. Mutagen connects the normal direction (this machine → remote over SSH) and auto-deploys its agent to the remote, so no local SSH server, reverse tunnel, or authorized_keys trust is required. You need the Mutagen CLI installed on THIS machine.",
       "examples": [
         "<%= config.bin %> <%= command.id %> --ssh user@203.0.113.4",
         "<%= config.bin %> <%= command.id %> --ssh user@host --source local",
@@ -296,5 +296,5 @@
       ]
     }
   },
-  "version": "2.3.0"
+  "version": "2.3.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@firenet-designs/fnd-cli",
   "description": "A new CLI generated with oclif",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "author": "Cole Denslow",
   "contributors": [
     "Justin Schellenberg"
@@ -76,7 +76,7 @@
         "description": "Say hello to the world and others"
       },
       "workspace": {
-        "description": "Open a remote reverse-SSHFS workspace and run Claude on it"
+        "description": "Open a remote Mutagen workspace and run Claude on it"
       }
     }
   },
@@ -87,10 +87,12 @@
   "scripts": {
     "build": "shx rm -rf dist && tsc -b",
     "lint": "eslint",
+    "pack": "npm run prepack && npm run postpack",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",
     "prepack": "oclif manifest && oclif readme",
     "version": "oclif readme && git add README.md",
+    "prerelease": "npm run build && npm run prepack",
     "release": "npm run build && npm run prepack && npm publish --access public"
   },
   "types": "dist/index.d.ts"