@tray-sh/cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddharth Borderwala
+
+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,55 @@
-# Temporary Holding Version
+# tray
 
-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.
+Tray turns a folder or an HTML file into a link you can share. Put it on a tray, pass it around. For you, your agents and your friends.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset=".github/assets/banner-dark.png">
+  <img alt="tray. Artifacts for every agent. Put it on a tray. Pass it around." src=".github/assets/banner-light.png">
+</picture>
+
+Tray runs on your own Cloudflare account, on Workers, R2 and Access, so your sites and data stay yours. Setup takes about 60 seconds.
+
+## Install
+
+```sh
+curl -fsSL https://tray.sh/install | sh
+```
+
+Or with npm: `npm i -g @tray-sh/cli`. Either way, the command is `tray`.
+
+## Quick start
+
+```sh
+tray setup --domain acme.dev        # once: creates the Worker, bucket, DNS and TLS
+tray put ./q3-review                # → https://q3-review.acme.dev
+tray put ./q3-review --private      # only you can see it
+tray share q3-review bob@acme.com   # …and Bob
+```
+
+Agents use the same CLI: `tray put ./out --json` prints the result as JSON and never prompts. Docs for agents live at [tray.sh/llms.txt](https://tray.sh/llms.txt).
+
+Full docs: [tray.sh](https://tray.sh).
+
+## Development
+
+```sh
+bun install
+bun test          # all tests
+bun run build     # worker → cli → site
+bun run lint && bun run fmt:check
+```
+
+The repo is a Bun workspace:
+
+| Path | What |
+|---|---|
+| `apps/cli` | The `tray` CLI (Bun, compiled to a single binary) |
+| `apps/worker` | The Cloudflare Worker: API and site serving (Hono) |
+| `apps/site` | tray.sh (Astro) |
+| `packages/schema` | Shared zod schemas for the API |
+
+See [SPEC.md](SPEC.md) for how it all works. Issues and PRs welcome.
+
+## License
+
+[MIT](LICENSE)

package/bin/tray.cjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Launcher for `npm i -g @tray-sh/cli`: runs the prebuilt binary from the
+// matching platform package (@tray-sh/cli-<os>-<arch>).
+const { spawnSync } = require("node:child_process");
+
+const os = { darwin: "darwin", linux: "linux", win32: "windows" }[process.platform];
+const arch = { x64: "x64", arm64: "arm64" }[process.arch];
+const musl =
+  process.platform === "linux" && !process.report?.getReport().header.glibcVersionRuntime;
+const target = `${os}-${arch}${musl ? "-musl" : ""}`;
+const exe = process.platform === "win32" ? "tray.exe" : "tray";
+
+let bin;
+try {
+  bin = require.resolve(`@tray-sh/cli-${target}/bin/${exe}`);
+} catch {
+  console.error(
+    `tray: no prebuilt binary for ${target}. Try: curl -fsSL https://tray.sh/install | sh`,
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (result.signal) process.kill(process.pid, result.signal);
+process.exit(result.status ?? 1);

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@tray-sh/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Artifacts for every agent. Turn a folder or an HTML file into a link you can share.",
+  "license": "MIT",
+  "homepage": "https://tray.sh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siddharthborderwala/tray.git"
+  },
+  "bin": {
+    "tray": "bin/tray.cjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "optionalDependencies": {
+    "@tray-sh/cli-darwin-arm64": "0.1.0",
+    "@tray-sh/cli-darwin-x64": "0.1.0",
+    "@tray-sh/cli-linux-arm64": "0.1.0",
+    "@tray-sh/cli-linux-x64": "0.1.0",
+    "@tray-sh/cli-linux-arm64-musl": "0.1.0",
+    "@tray-sh/cli-linux-x64-musl": "0.1.0",
+    "@tray-sh/cli-windows-x64": "0.1.0"
+  }
 }