luwu-cli 0.0.0-stage → 0.2.18

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# Luwu (陆吾)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Reach the terminals and coding agents (Claude Code, Codex, Gemini CLI, …) on all your computers from your phone, tablet or another computer. Connections are end-to-end encrypted, peer-to-peer (libp2p + Noise), with relays only when a direct path isn't possible.
+
+```sh
+npx luwu-cli
+```
+
+The first run signs you in with your ccnote account (a 6-digit email code), makes this computer reachable, and opens a dashboard of your computers and their tmux terminals.
+
+| Command | |
+|---|---|
+| `luwu` | dashboard (first-run setup if needed) |
+| `luwu login` / `logout` | sign in / out |
+| `luwu up` / `down` | start / stop the background service on this computer |
+| `luwu status` | account, this computer, service state |
+| `luwu ls [--json]` | list computers, terminals and agent state (e.g. "claude · needs you") |
+| `luwu attach [computer] [session[:window]]` | open a terminal on another computer |
+| `luwu fs ls\|get\|put\|find\|mkdir\|mv\|rm` | files on your computers, e.g. `luwu fs put shot.png mac` (to its inbox) |
+| `luwu share <computer> <session>[:<window>]` | let a friend watch one window (`--write` to let them type, `--for 30m\|1h\|1d`); `luwu share ls`, `luwu share end <id>` |
+| `luwu join <code\|link>` | join a window someone shared with you |
+| `luwu hooks [install\|uninstall]` | notify your phone when Claude Code or Codex finishes or needs you |
+| `luwu notify --from claude\|codex` | report an agent's state (run by the hooks) |
+| `luwu unpair` | remove this computer from your account |
+
+macOS and Linux (x64, arm64). On Windows, run it inside WSL. Terminals are tmux sessions: install tmux and start your agents inside it.
+
+Files: your home folder is shared with your own devices, except secrets (`~/.ssh`, `~/.gnupg`, `~/.aws`, `.env` files, Luwu's keys). To share another folder, stop sharing some, or turn files off, put this in `~/.luwu/files.json` and run `luwu down && luwu up`:
+
+```json
+{ "roots": ["/data/projects"], "deny": ["Documents/private"], "disabled": false }
+```
+
+On iPhone, get the Luwu app from TestFlight, sign in with the same ccnote account, and allow notifications. Run `luwu hooks install` on each computer; agents that are already running pick up the hooks when restarted.
+
+https://luwu.dev

package/bin/luwu.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// Launcher: runs the prebuilt luwu binary from the platform package npm
+// installed alongside this one (luwu-<os>-<arch>, an optional dependency).
+"use strict";
+const { spawnSync } = require("node:child_process");
+
+const platforms = {
+  "darwin-arm64": "luwu-darwin-arm64",
+  "darwin-x64": "luwu-darwin-x64",
+  "linux-x64": "luwu-linux-x64",
+  "linux-arm64": "luwu-linux-arm64",
+  "win32-x64": "luwu-win32-x64",
+  "win32-arm64": "luwu-win32-arm64",
+};
+const key = `${process.platform}-${process.arch}`;
+const pkg = platforms[key];
+
+if (!pkg) {
+  console.error(`Luwu has no build for ${key} yet. Supported: ${Object.keys(platforms).join(", ")}.`);
+  process.exit(1);
+}
+
+let bin;
+try {
+  bin = require.resolve(`${pkg}/bin/luwu${process.platform === "win32" ? ".exe" : ""}`);
+} catch {
+  console.error(
+    `The Luwu binary for ${key} (${pkg}) is missing. It is installed as an optional dependency;\n` +
+      "reinstall without --no-optional / --omit=optional, or use the installer: curl -fsSL https://luwu.dev/install.sh | sh" +
+      (process.platform === "win32" ? " (Windows: irm https://luwu.dev/install.ps1 | iex)" : ""),
+  );
+  process.exit(1);
+}
+
+const r = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (r.error) {
+  console.error(r.error.message);
+  process.exit(1);
+}
+if (r.signal && process.platform !== "win32") process.kill(process.pid, r.signal);
+process.exit(r.status ?? 1);

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "luwu-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.18",
+  "description": "Luwu (陆吾): reach the terminals and coding agents on all your computers from your phone, tablet or another computer. Secure P2P. The command is `luwu`.",
+  "homepage": "https://luwu.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/luwulab/luwudev.git"
+  },
+  "license": "UNLICENSED",
+  "keywords": [
+    "terminal",
+    "tmux",
+    "remote",
+    "p2p",
+    "libp2p",
+    "claude",
+    "codex",
+    "ai",
+    "coding-agent"
+  ],
+  "bin": {
+    "luwu": "bin/luwu.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "luwu-darwin-arm64": "0.2.18",
+    "luwu-darwin-x64": "0.2.18",
+    "luwu-linux-x64": "0.2.18",
+    "luwu-linux-arm64": "0.2.18",
+    "luwu-win32-x64": "0.2.18",
+    "luwu-win32-arm64": "0.2.18"
+  }
+}