cawide 0.4.4 → 0.4.6

package/README.md

@@ -1,66 +1,63 @@
-# Cawide
+# Cawide CLI
 
-The official npm launcher for the Cawide desktop companion daemon. It runs a local development build when used from the Cawide repository; otherwise it downloads the matching Cawide release binary and caches it for later runs.
+**Mobile remote code editor & AI agent terminal companion**
 
-## Quick start
+Connect your mobile device (iOS & Android) to your desktop or remote server with end-to-end encrypted, zero-trust P2P tunnels. Edit code, view diffs, and control AI coding agents (Claude Code, OpenCode, Codex) directly from your phone.
 
-Run Cawide without installing it globally:
+## Quick start
 
 ```sh
+# Run directly via npx
 npx cawide start
-```
-
-Or install the command globally:
 
-```sh
+# Or install globally
 npm install -g cawide
 cawide start
 ```
 
-All arguments are forwarded to the native Cawide CLI. Common commands include:
+## Commands
 
-```sh
-cawide --help
-cawide start --help
-cawide status
-cawide qr
-cawide logs
-cawide stop
-```
+| Command | Description |
+|---------|-------------|
+| `cawide start` | Start the daemon in your project directory and display the pairing QR code. |
+| `cawide qr` | Show the pairing QR code for the active workspace. |
+| `cawide status` | Inspect connected sessions, active terminals, and relay status. |
+| `cawide setup [agent]` | Configure hooks and skills for AI agents (Claude, Codex, OpenCode). |
+| `cawide logs` | View daemon logs. |
+| `cawide stop` | Stop the background daemon. |
 
 Use `cawide <command> --help` for the options supported by a particular command.
 
-## Supported platforms
-
-- macOS on Apple Silicon and Intel
-- Linux on x64 and ARM64
-- Windows on x64 and ARM64
-
-On first use, the launcher downloads the binary for the current platform from the matching [GitHub release](https://github.com/longd2k3/cawide/releases). The binary is cached at:
-
-- macOS and Linux: `~/.cache/cawide/bin/v0.4.4/cawide`
-- Windows: `%LOCALAPPDATA%\cawide\bin\v0.4.4\cawide.exe`
-
-## Troubleshooting
+## Security & Architecture
 
-### The download fails
+- **Peer-to-peer QUIC / UDP** direct connection with automatic relay fallback.
+- **Ed25519** cryptographic challenge-response authentication.
+- **End-to-end encrypted** transport — your code never passes through third-party servers unencrypted.
 
-Check that GitHub Releases is reachable from your network and that release `v0.4.4` contains an artifact for your platform. A proxy or firewall may block redirected downloads from GitHub's asset host.
-
-### The cached binary is damaged
+## Supported platforms
 
-Remove the versioned cache directory shown above and run the command again. Cawide will download a fresh copy.
+The right prebuilt binary is installed automatically as an optional dependency
+of this package (the same approach used by esbuild and `@biomejs/biome`) — no
+extra download step at runtime.
 
-### Permission denied on macOS or Linux
+| Platform | Package |
+|----------|---------|
+| macOS (Apple Silicon) | [`cawide-darwin-arm64`](https://www.npmjs.com/package/cawide-darwin-arm64) |
+| macOS (Intel) | [`cawide-darwin-x64`](https://www.npmjs.com/package/cawide-darwin-x64) |
+| Linux (x86_64) | [`cawide-linux-x64`](https://www.npmjs.com/package/cawide-linux-x64) |
+| Linux (ARM64) | [`cawide-linux-arm64`](https://www.npmjs.com/package/cawide-linux-arm64) |
+| Windows (x86_64) | [`cawide-win32-x64`](https://www.npmjs.com/package/cawide-win32-x64) |
+| Windows (ARM64) | [`cawide-win32-arm64`](https://www.npmjs.com/package/cawide-win32-arm64) |
 
-The launcher makes the downloaded binary executable automatically. If the cache was copied from another machine, remove it and rerun Cawide so it can be recreated with the correct permissions.
+If `npm install` was run with `--no-optional`/`--omit=optional`, or the
+platform is unsupported, `cawide` prints a clear error explaining how to
+reinstall.
 
-### macOS blocks the binary
+## Support
 
-Open **System Settings → Privacy & Security** and allow Cawide if macOS reports that it blocked the downloaded application. Only use binaries from the official Cawide GitHub release.
+- [cawide.dev](https://cawide.dev) — documentation, updates, and community
+- [Support](https://cawide.dev/support) — report issues and get help
 
-### Show available commands
+## License
 
-```sh
-cawide --help
-```
+MIT

package/bin/cawide.js

@@ -2,20 +2,19 @@
 
 const fs = require("node:fs");
 const path = require("node:path");
-const os = require("node:os");
-const https = require("node:https");
 const childProcess = require("node:child_process");
-const zlib = require("node:zlib");
 
-const VERSION = "0.4.4";
-const RELEASE_BASE = `https://github.com/longd2k3/cawide/releases/download/v${VERSION}`;
-const TARGETS = {
-  "darwin-arm64": ["aarch64-apple-darwin"],
-  "darwin-x64": ["x86_64-apple-darwin", "aarch64-apple-darwin"],
-  "linux-x64": ["x86_64-unknown-linux-gnu"],
-  "linux-arm64": ["aarch64-unknown-linux-gnu"],
-  "win32-x64": ["x86_64-pc-windows-msvc"],
-  "win32-arm64": ["aarch64-pc-windows-msvc"],
+// Maps `${process.platform}-${process.arch}` to the platform-specific npm
+// package that ships the prebuilt binary for it (see
+// scripts/build-platforms.js and the six `cawide-<platform>`
+// optionalDependencies in package.json).
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "cawide-darwin-arm64",
+  "darwin-x64": "cawide-darwin-x64",
+  "linux-x64": "cawide-linux-x64",
+  "linux-arm64": "cawide-linux-arm64",
+  "win32-x64": "cawide-win32-x64",
+  "win32-arm64": "cawide-win32-arm64",
 };
 const SIGNAL_EXIT_CODES = { SIGINT: 130, SIGTERM: 143 };
 
@@ -23,6 +22,10 @@ function executableName() {
   return process.platform === "win32" ? "cawide.exe" : "cawide";
 }
 
+function platformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
 function localBinary() {
   const repositoryRoot = path.resolve(__dirname, "../../..");
   if (!fs.existsSync(path.join(repositoryRoot, "Cargo.toml"))) return null;
@@ -34,168 +37,60 @@ function localBinary() {
   return null;
 }
 
-function cacheBinary() {
-  const cacheRoot =
-    process.platform === "win32"
-      ? process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local")
-      : path.join(os.homedir(), ".cache");
-  return path.join(cacheRoot, "cawide", "bin", `v${VERSION}`, executableName());
-}
-
-function platformTargets() {
-  const targets = TARGETS[`${process.platform}-${process.arch}`];
-  if (!targets) {
+function platformPackageName() {
+  const packageName = PLATFORM_PACKAGES[platformKey()];
+  if (!packageName) {
     throw new Error(
-      `Cawide does not provide a binary for ${process.platform}/${process.arch}. Supported platforms: macOS (arm64, x64), Linux (arm64, x64), and Windows (arm64, x64).`
-    );
-  }
-  return targets;
-}
-
-function download(url, redirectsLeft = 5) {
-  return new Promise((resolve, reject) => {
-    const request = https.get(
-      url,
-      { headers: { "User-Agent": `cawide-npm/${VERSION}` } },
-      (response) => {
-        const status = response.statusCode || 0;
-        if (status >= 300 && status < 400 && response.headers.location) {
-          response.resume();
-          if (redirectsLeft === 0) {
-            reject(new Error(`Too many redirects while downloading ${url}`));
-            return;
-          }
-          resolve(download(new URL(response.headers.location, url).toString(), redirectsLeft - 1));
-          return;
-        }
-        if (status !== 200) {
-          response.resume();
-          const error = new Error(`Download failed with HTTP ${status}: ${url}`);
-          error.statusCode = status;
-          reject(error);
-          return;
-        }
-
-        const chunks = [];
-        response.on("data", (chunk) => chunks.push(chunk));
-        response.on("end", () => resolve(Buffer.concat(chunks)));
-        response.on("error", reject);
-      }
+      `Cawide does not provide a binary for ${process.platform}/${process.arch}. Supported platforms: ${Object.keys(
+        PLATFORM_PACKAGES
+      ).join(", ")}.`
     );
-    request.on("error", reject);
-  });
-}
-
-function tarBinary(archive) {
-  const tar = zlib.gunzipSync(archive);
-  let offset = 0;
-  while (offset + 512 <= tar.length) {
-    const header = tar.subarray(offset, offset + 512);
-    if (header.every((byte) => byte === 0)) break;
-    const name = header.subarray(0, 100).toString("utf8").replace(/\0.*$/, "");
-    const sizeText = header.subarray(124, 136).toString("ascii").replace(/\0.*$/, "").trim();
-    const size = Number.parseInt(sizeText || "0", 8);
-    const dataStart = offset + 512;
-    if (!Number.isFinite(size) || dataStart + size > tar.length) {
-      throw new Error("Downloaded tar archive is corrupt");
-    }
-    if (path.posix.basename(name) === "cawide") return tar.subarray(dataStart, dataStart + size);
-    offset = dataStart + Math.ceil(size / 512) * 512;
   }
-  throw new Error("Downloaded archive does not contain the cawide binary");
+  return packageName;
 }
 
-function zipBinary(archive) {
-  const endSignature = 0x06054b50;
-  const centralSignature = 0x02014b50;
-  const localSignature = 0x04034b50;
-  const searchStart = Math.max(0, archive.length - 65557);
-  let endOffset = -1;
-  for (let offset = archive.length - 22; offset >= searchStart; offset -= 1) {
-    if (archive.readUInt32LE(offset) === endSignature) {
-      endOffset = offset;
-      break;
+function resolvePlatformBinary() {
+  const packageName = platformPackageName();
+
+  let packageJsonPath;
+  try {
+    packageJsonPath = require.resolve(`${packageName}/package.json`);
+  } catch (error) {
+    if (error.code === "MODULE_NOT_FOUND") {
+      throw new Error(
+        `Cawide could not find the "${packageName}" platform package for ${platformKey()}.\n` +
+          "This usually happens when the package was installed with --no-optional/--omit=optional, " +
+          "npm skipped optional dependencies, or the platform is unsupported.\n" +
+          "Try reinstalling without skipping optional dependencies: npm install -g cawide"
+      );
     }
+    throw error;
   }
-  if (endOffset < 0) throw new Error("Downloaded zip archive is corrupt");
 
-  const entryCount = archive.readUInt16LE(endOffset + 10);
-  let offset = archive.readUInt32LE(endOffset + 16);
-  for (let index = 0; index < entryCount; index += 1) {
-    if (archive.readUInt32LE(offset) !== centralSignature) {
-      throw new Error("Downloaded zip archive has an invalid directory");
-    }
-    const method = archive.readUInt16LE(offset + 10);
-    const compressedSize = archive.readUInt32LE(offset + 20);
-    const fileNameLength = archive.readUInt16LE(offset + 28);
-    const extraLength = archive.readUInt16LE(offset + 30);
-    const commentLength = archive.readUInt16LE(offset + 32);
-    const localOffset = archive.readUInt32LE(offset + 42);
-    const name = archive.subarray(offset + 46, offset + 46 + fileNameLength).toString("utf8");
-
-    if (path.posix.basename(name.replace(/\\/g, "/")) === "cawide.exe") {
-      if (archive.readUInt32LE(localOffset) !== localSignature) {
-        throw new Error("Downloaded zip archive has an invalid entry");
-      }
-      const localNameLength = archive.readUInt16LE(localOffset + 26);
-      const localExtraLength = archive.readUInt16LE(localOffset + 28);
-      const dataStart = localOffset + 30 + localNameLength + localExtraLength;
-      const compressed = archive.subarray(dataStart, dataStart + compressedSize);
-      if (method === 0) return compressed;
-      if (method === 8) return zlib.inflateRawSync(compressed);
-      throw new Error(`Downloaded zip uses unsupported compression method ${method}`);
-    }
-    offset += 46 + fileNameLength + extraLength + commentLength;
-  }
-  throw new Error("Downloaded archive does not contain cawide.exe");
-}
-
-async function installBinary(destination) {
-  const extension = process.platform === "win32" ? "zip" : "tar.gz";
-  let lastError;
-  for (const target of platformTargets()) {
-    const asset = `cawide-${target}.${extension}`;
-    const url = `${RELEASE_BASE}/${asset}`;
-    try {
-      process.stderr.write(`Downloading Cawide v${VERSION} for ${target}...\n`);
-      const archive = await download(url);
-      const binary = extension === "zip" ? zipBinary(archive) : tarBinary(archive);
-      fs.mkdirSync(path.dirname(destination), { recursive: true });
-      const temporary = `${destination}.${process.pid}.tmp`;
-      try {
-        fs.writeFileSync(temporary, binary, { mode: 0o755 });
-        fs.chmodSync(temporary, 0o755);
-        fs.renameSync(temporary, destination);
-      } finally {
-        if (fs.existsSync(temporary)) fs.unlinkSync(temporary);
-      }
-      return;
-    } catch (error) {
-      lastError = error;
-      if (error.statusCode !== 404) break;
-    }
+  const binaryPath = path.join(path.dirname(packageJsonPath), "bin", executableName());
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error(
+      `The "${packageName}" platform package is installed but is missing its binary at ${binaryPath}. ` +
+        "Try reinstalling: npm install -g cawide"
+    );
   }
-  throw lastError;
+  return binaryPath;
 }
 
 function run(binaryPath) {
   const result = childProcess.spawnSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
   if (result.error) throw result.error;
-  if (result.signal && SIGNAL_EXIT_CODES[result.signal])
-    process.exit(SIGNAL_EXIT_CODES[result.signal]);
+  if (result.signal && SIGNAL_EXIT_CODES[result.signal]) process.exit(SIGNAL_EXIT_CODES[result.signal]);
   process.exit(result.status ?? 0);
 }
 
-async function main() {
-  const local = localBinary();
-  if (local) run(local);
-
-  const cached = cacheBinary();
-  if (!fs.existsSync(cached)) await installBinary(cached);
-  run(cached);
+function main() {
+  run(localBinary() || resolvePlatformBinary());
 }
 
-main().catch((error) => {
+try {
+  main();
+} catch (error) {
   process.stderr.write(`cawide: ${error.message}\n`);
   process.exit(1);
-});
+}

package/package.json

@@ -1,19 +1,35 @@
 {
   "name": "cawide",
-  "version": "0.4.4",
-  "description": "Desktop companion daemon for Cawide remote coding terminal",
+  "version": "0.4.6",
+  "description": "Mobile remote code editor & AI agent terminal companion",
+  "homepage": "https://cawide.dev",
+  "bugs": "https://cawide.dev/support",
   "bin": {
-    "cawide": "./bin/cawide.js"
+    "cawide": "bin/cawide.js"
   },
-  "files": ["bin/", "README.md"],
+  "files": [
+    "bin/",
+    "README.md"
+  ],
   "engines": {
     "node": ">=16.0.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/longd2k3/cawide.git"
-  },
-  "keywords": ["cawide", "terminal", "ai-agent", "remote-editor", "gpui"],
+  "keywords": [
+    "cawide",
+    "terminal",
+    "ai-agent",
+    "remote-editor",
+    "mobile",
+    "editor"
+  ],
   "author": "Cawide Team",
-  "license": "MIT"
+  "license": "MIT",
+  "optionalDependencies": {
+    "cawide-darwin-arm64": "0.4.6",
+    "cawide-darwin-x64": "0.4.6",
+    "cawide-linux-x64": "0.4.6",
+    "cawide-linux-arm64": "0.4.6",
+    "cawide-win32-x64": "0.4.6",
+    "cawide-win32-arm64": "0.4.6"
+  }
 }