@zswarm/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zSwarm contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @zswarm/cli
+
+The `zswarm` command. Same ops as the MCP tool, through `@zswarm/core`. Two
+conveniences: the first bare argument is `--to` and the second is `--body` for
+`send`; `--key` / `--keys` repeat into an array.
+
+## Install
+
+```bash
+npm install -g @zswarm/cli
+```
+
+From a checkout of this repo:
+
+```bash
+npm install ./packages/cli
+```
+
+Requires Zellij >= 0.42 and Node >= 20.
+
+## Usage
+
+```bash
+zswarm list
+zswarm send terminal_2 ping
+zswarm send --to terminal_2 --body ping
+zswarm keys --to terminal_2 --key "Ctrl c" --key Esc
+```
+
+Prints JSON. No arguments prints usage, generated from the same schema as the
+MCP tool.
+
+Ops, env, and the event bus: the [zswarm README](../../README.md).
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { ZellijError, cliUsage, dispatchZswarm, parseCliArgv } from "@zswarm/core";
+const argv = process.argv.slice(2);
+if (argv.length === 0 || argv[0] === "-h" || argv[0] === "--help") {
+    process.stderr.write(cliUsage());
+    process.exit(argv.length === 0 ? 2 : 0);
+}
+let args;
+try {
+    args = parseCliArgv(argv);
+}
+catch (err) {
+    const message = err instanceof ZellijError ? err.message : String(err);
+    process.stderr.write(`${message}\n${cliUsage()}`);
+    process.exit(2);
+}
+const result = await dispatchZswarm(args);
+process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+process.exit(result.ok ? 0 : 1);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@zswarm/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "zSwarm CLI — list, send, dump Zellij panes",
+  "bin": {
+    "zswarm": "./dist/cli.js"
+  },
+  "dependencies": {
+    "@zswarm/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.14.1",
+    "typescript": "5.8.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/cli.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "cli": "node dist/cli.js"
+  }
+}