@libtmux/workspace-cli 0.1.0-alpha.11 → 0.1.0-alpha.12

package/README.md

@@ -1,24 +1,58 @@
 # Workspace CLI
 
 Manage tmux workspaces from YAML and JSON with Node.js 22.12+ or Bun 1.3.14+.
-This local implementation is in development.
+`tmux-workspace` loads, captures, converts and imports tmuxp workspace files.
+This implementation is in development.
 
-## Build
+## Install
 
-Run from the repository root:
+Run the command without installing it. With Node:
 
 ```console
-$ bun run --cwd packages/libtmux build
+$ npx -y @libtmux/workspace-cli@0.1.0-alpha.12 --help
 ```
 
+With Bun. The command names `node` in its shebang, so `bunx` runs it on Node
+when Node is installed; `--bun` runs it on Bun:
+
 ```console
-$ bun run --cwd packages/workspace-cli build
+$ bunx --bun @libtmux/workspace-cli@0.1.0-alpha.12 --help
+```
+
+With pnpm:
+
+```console
+$ pnpm dlx @libtmux/workspace-cli@0.1.0-alpha.12 --help
 ```
 
+With Yarn. Yarn refuses a release younger than its `npmMinimalAgeGate`, one
+day by default:
+
 ```console
-$ node packages/workspace-cli/dist/main.js --help
+$ yarn dlx @libtmux/workspace-cli@0.1.0-alpha.12 --help
+```
+
+Or install it globally, which puts `tmux-workspace` on `PATH`. With npm:
+
+```console
+$ npm install --global @libtmux/workspace-cli@0.1.0-alpha.12
+```
+
+With pnpm:
+
+```console
+$ pnpm add --global @libtmux/workspace-cli@0.1.0-alpha.12
+```
+
+With Bun:
+
+```console
+$ bun add --global @libtmux/workspace-cli@0.1.0-alpha.12
 ```
 
+The rest of this page runs the installed `tmux-workspace`. A runner passes
+the same arguments to the command when they follow the package name.
+
 ## Load and capture
 
 Save this document as `workspace.yaml`:
@@ -36,7 +70,7 @@ windows:
 Load on a separate tmux socket:
 
 ```console
-$ node packages/workspace-cli/dist/main.js load ./workspace.yaml \
+$ tmux-workspace load ./workspace.yaml \
     -L workspace-cli-demo \
     -d \
     --json
@@ -45,7 +79,7 @@ $ node packages/workspace-cli/dist/main.js load ./workspace.yaml \
 Capture its live topology:
 
 ```console
-$ node packages/workspace-cli/dist/main.js freeze dev \
+$ tmux-workspace freeze dev \
     -L workspace-cli-demo \
     --json
 ```
@@ -126,17 +160,22 @@ lists and blank builder names still use native validation.
 ## Inspect a workspace through MCP
 
 The separate [MCP server](../mcp/README.md) inspects loaded workspaces on the
-same tmux socket. Build it from the repository root:
-
-```console
-$ bun run --cwd packages/mcp build
+same tmux socket. After the detached load above, add it to your MCP client with
+that socket and the `inspect` toolset:
+
+```json
+{
+  "mcpServers": {
+    "tmux": {
+      "command": "npx",
+      "args": ["-y", "@libtmux/mcp@0.1.0-alpha.12"],
+      "env": { "LIBTMUX_SOCKET": "workspace-cli-demo", "LIBTMUX_TOOLSETS": "inspect" }
+    }
+  }
+}
 ```
 
-After the detached load above, configure your MCP client to launch `node` with
-the built `packages/mcp/dist/server.js` as its argument. Use an absolute program
-path if the client starts outside this repository. Set `LIBTMUX_SOCKET` to
-`workspace-cli-demo` and `LIBTMUX_TOOLSETS` to `inspect` in that subprocess's
-environment. The socket is selected when the MCP server starts.
+The socket is selected when the MCP server starts.
 
 For a workspace loaded with `-S`, set `LIBTMUX_SOCKET_PATH` to the same absolute
 socket path instead of `LIBTMUX_SOCKET`. If the CLI uses `TMUX_BIN`, select that
@@ -287,7 +326,7 @@ their completion scope.
 Completion is tested on Linux with Bash 5.2, Zsh 5.9, and fish 4.8. Bash 3.2 is
 a syntax target; older shells and filenames containing newlines remain unverified.
 
-After installing the local package, load the script for your shell. Bash:
+With `tmux-workspace` on `PATH`, load the script for your shell. Bash:
 
 ```console
 $ source <(tmux-workspace completion bash)
@@ -307,6 +346,22 @@ $ tmux-workspace completion fish | source
 
 For automation, `--json` and `--ndjson` wrap the script in a structured result.
 
+## Build from source
+
+Run from the repository root:
+
+```console
+$ bun run --cwd packages/libtmux build
+```
+
+```console
+$ bun run --cwd packages/workspace-cli build
+```
+
+```console
+$ node packages/workspace-cli/dist/main.js --help
+```
+
 ## Development status
 
 Native discovery, conversion, imports, common searches, detached load, append,

package/dist/{app-w7cbtf0n.js → app-p3e1j12e.js}

@@ -26,7 +26,7 @@ import {
   CommanderError,
   createParser,
   package_default
-} from "./main-bfnr2nkj.js";
+} from "./main-kvjzz67q.js";
 import {
   __require
 } from "./main-1de529jm.js";
@@ -605,7 +605,7 @@ async function run(argv, context) {
       return await shell(request, context);
     if (request.command === "completion") {
       const [{ commandCatalog }, { completionScript }] = await Promise.all([
-        import("./reference-ebfxh6yp.js"),
+        import("./reference-n7rt65hv.js"),
         import("./completions-2a9fqwq3.js")
       ]);
       const shell2 = request.values.shell;

package/dist/{main-bfnr2nkj.js → main-kvjzz67q.js}

@@ -2044,7 +2044,7 @@ var program = new Command;
 // package.json
 var package_default = {
   name: "@libtmux/workspace-cli",
-  version: "0.1.0-alpha.11",
+  version: "0.1.0-alpha.12",
   description: "A tmuxp-compatible workspace manager for Node and Bun.",
   license: "MIT",
   repository: {
@@ -2075,17 +2075,16 @@ var package_default = {
     "test:package": "bun run build && bun scripts/check-install.ts --package-only",
     "test:install": "bun run build && bun scripts/check-install.ts"
   },
+  dependencies: {
+    libtmux: "0.1.0-alpha.12"
+  },
   devDependencies: {
     "cli-truncate": "6.1.1",
     commander: "15.0.0",
-    libtmux: "0.1.0-alpha.11",
     oxfmt: "0.68.0",
     "string-width": "8.2.2",
     yaml: "2.9.0"
   },
-  peerDependencies: {
-    libtmux: "0.1.0-alpha.11"
-  },
   engines: {
     bun: ">=1.3.14",
     node: ">=22.12.0"

package/dist/main.js

@@ -21,7 +21,7 @@ for (const stream of [process.stdout, process.stderr])
     } else
       throw error;
   });
-var { run } = await import("./app-w7cbtf0n.js");
+var { run } = await import("./app-p3e1j12e.js");
 var exitCode = await run(process.argv.slice(2), {
   cwd: process.cwd(),
   env: process.env,

package/dist/{reference-ebfxh6yp.js → reference-n7rt65hv.js}

@@ -1,6 +1,6 @@
 import {
   createParser
-} from "./main-bfnr2nkj.js";
+} from "./main-kvjzz67q.js";
 import"./main-1de529jm.js";
 
 // src/reference.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libtmux/workspace-cli",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.12",
   "description": "A tmuxp-compatible workspace manager for Node and Bun.",
   "license": "MIT",
   "repository": {
@@ -31,17 +31,16 @@
     "test:package": "bun run build && bun scripts/check-install.ts --package-only",
     "test:install": "bun run build && bun scripts/check-install.ts"
   },
+  "dependencies": {
+    "libtmux": "0.1.0-alpha.12"
+  },
   "devDependencies": {
     "cli-truncate": "6.1.1",
     "commander": "15.0.0",
-    "libtmux": "0.1.0-alpha.11",
     "oxfmt": "0.68.0",
     "string-width": "8.2.2",
     "yaml": "2.9.0"
   },
-  "peerDependencies": {
-    "libtmux": "0.1.0-alpha.11"
-  },
   "engines": {
     "bun": ">=1.3.14",
     "node": ">=22.12.0"