tray

Tray turns a folder, a file or a few files into a link you can share. Put it on a tray, pass it around. For you, your agents and your friends.

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

curl -fsSL https://tray.sh/install | sh

Or with npm: npm i -g @tray-sh/cli. Either way, the command is tray.

Quick start

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 put "Q3 Report.pdf"            # one file works too: a PDF, an image…
tray share q3-review [email protected]   # …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.

Full docs: tray.sh.

Development

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 for how it all works. Issues and PRs welcome.

License

MIT