tilt-live 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cloudycotton
+
+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

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# tilt-live
 
-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.
+See and control any Linux desktop, right in your browser.
+
+```sh
+npx tilt-live
+```
+
+Run it on the Linux machine or VM whose screen you want, open the link it prints, click the cursor
+button, and the desktop is yours.
+
+- The first run downloads [tilt](https://github.com/cloudycotton/tilt) (checksum-verified). After
+  that tilt updates itself whenever it starts; `TILT_NO_UPDATE=1` turns this off.
+- `npx tilt-live --display :1`: every flag goes to [tilt](https://github.com/cloudycotton/tilt/blob/main/docs/guide.md#flags).
+- Linux on x86_64 or arm64, Node 18+. MIT licensed.

package/bin/tilt-live.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// tilt-live: runs tilt (https://github.com/cloudycotton/tilt) with every argument passed through.
+// The first run downloads the latest release (checksum-verified); after that tilt updates itself
+// whenever it starts. Linux on x86_64 or arm64.
+'use strict';
+
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+
+// TILT_RELEASES points elsewhere for tests: a URL with GitHub's /latest/download layout.
+const RELEASES = process.env.TILT_RELEASES || 'https://github.com/cloudycotton/tilt/releases';
+const TRIPLE = { x64: 'x86_64-unknown-linux-musl', arm64: 'aarch64-unknown-linux-musl' }[process.arch];
+const cacheDir = path.join(process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache'), 'tilt-live');
+const bin = path.join(cacheDir, 'tilt');
+
+function fail(msg) {
+  process.stderr.write(`tilt-live: ${msg}\n`);
+  process.exit(1);
+}
+
+async function download() {
+  const get = async (name) => {
+    const res = await fetch(`${RELEASES}/latest/download/${name}`, { signal: AbortSignal.timeout(120_000) });
+    if (!res.ok) throw new Error(`${name}: HTTP ${res.status}`);
+    return Buffer.from(await res.arrayBuffer());
+  };
+  const name = `tilt-${TRIPLE}`;
+  const [data, sums] = await Promise.all([get(name), get('SHA256SUMS')]);
+  const want = sums.toString().split('\n').map((l) => l.trim().split(/\s+/)).find((f) => f[1] === name)?.[0];
+  if (crypto.createHash('sha256').update(data).digest('hex') !== want) throw new Error(`${name}: checksum mismatch`);
+  fs.mkdirSync(cacheDir, { recursive: true });
+  const tmp = `${bin}.${process.pid}`;
+  fs.writeFileSync(tmp, data, { mode: 0o755 });
+  fs.renameSync(tmp, bin);
+}
+
+async function main() {
+  if (process.platform !== 'linux') fail('tilt streams a Linux desktop: run it on the Linux machine or VM whose screen you want');
+  if (!TRIPLE) fail('tilt runs on x86_64 or arm64');
+  if (!fs.existsSync(bin)) {
+    process.stderr.write('tilt-live: downloading tilt...\n');
+    await download().catch((e) => fail(`download failed: ${e.message}`));
+  }
+  const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+  for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP', 'SIGQUIT']) process.on(sig, () => child.kill(sig));
+  child.on('error', (e) => fail(e.message));
+  child.on('exit', (code, sig) => process.exit(code ?? 128 + (os.constants.signals[sig] || 0)));
+}
+
+main();

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "tilt-live",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "See and control any Linux desktop, right in your browser (downloads tilt, which then keeps itself up to date)",
+  "keywords": [
+    "vnc",
+    "remote-desktop",
+    "x11",
+    "xvfb",
+    "webcodecs",
+    "h264",
+    "screen-sharing",
+    "e2b"
+  ],
+  "homepage": "https://github.com/cloudycotton/tilt",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloudycotton/tilt.git",
+    "directory": "npm"
+  },
+  "license": "MIT",
+  "bin": {
+    "tilt-live": "bin/tilt-live.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/launcher.test.mjs"
+  }
+}