Menagerie.

00Get a relay running

This page can't reach your agents until a relay is running next to them. A relay is one small Go binary — one per machine, not one per agent: a single relay launches and streams every agent on that box. Set it up once where your agents run (your laptop, a dev box, a server) and leave it running. Most people run exactly one, on their laptop — that's the localhost relay the app already lists.

1 · Download it. Grab the prebuilt binary for your machine from the latest release — darwin-arm64 (Apple Silicon), darwin-amd64 (Intel Mac), linux-amd64, or linux-arm64 — then make it runnable and give it a tidy name:

chmod +x menagerie-relay-*
mv menagerie-relay-* menagerie-relay
# macOS only — clear Gatekeeper so it'll run:
xattr -dr com.apple.quarantine menagerie-relay

Prefer to build it yourself? With Go 1.21+ — this puts menagerie-relay on your PATH, so drop the ./ from the commands below:

go install github.com/NakliTechie/menagerie/relay-go/cmd/menagerie-relay@latest

2 · Initialise it. Writes ~/.menagerie/relay.toml with a generated registration token and a sensible default config.

./menagerie-relay init

3 · Copy the registration token. The app needs it to authenticate against this relay. Print it any time:

./menagerie-relay token print

4 · Allow your app's origin. The relay only accepts WebSocket connections from origins you list — that origin check is the security boundary. The hosted app (https://menagerie.naklitechie.com) is allowed out of the box; if you open Menagerie from somewhere else, add that origin to allowed_origins in the config:

# ~/.menagerie/relay.toml
allowed_origins = [
  "https://menagerie.naklitechie.com",
  "http://localhost:8000",
]

!Origins are matched exactly, and "null" is deliberately not allowed by default — a sandboxed iframe also sends Origin: null, so allowing it would let any web page through. Add it by hand only for file:// use.

5 · (Optional) Wire up agents. The [agents] table maps an agent id to the command that launches it — e.g. claude-code → claude, mini → mini. The built-in custom agent runs whatever command you hand it, so you can drive any TUI agent without writing a shim.

6 · Start serving. Listens on 127.0.0.1:7878 by default. For a relay on another machine, front it with TLS (wss://) at a reachable address.

./menagerie-relay serve

That's the whole setup — the relay keeps running and its sessions outlive page reloads. Now open the app and connect to it.

01Pick a workspace folder

On first launch Menagerie asks for a folder it will own. Registered relays and captured trajectories live there — nothing leaves your machine. The handle is persisted so the same workspace reloads next time.

02Register a relay

Open Settings, paste the relay URL and its registration token (printed by menagerie-relay token print), and add it. The browser opens a WebSocket, receives the relay's hello, and registers. Once connected, the relay shows a green dot with its host OS / arch and the agents it can spawn.

03Spawn an agent

Hit + Spawn and pick a relay, an agent, a working directory, and a task. Agents are listed alphabetically — no featured agent, no promoted shim. The relay mints a fresh session token per spawn and a tile appears.

04Watch it run

A live tile carries a status dot, the agent · relay · timer header, and the agent's terminal streaming through xterm.js. An input bar sends keystrokes straight to the PTY; the kill button stops the agent. The dot turns red and the header pulses when the agent needs input — answer without leaving the tab.

05A fleet in one tab

Tiles flow into a flat auto-fit grid. Spawn as many as the screen holds — several agents on one or more relays, all updating in real time, in a single browser tab. One WebSocket per relay carries every tile on that host.

06Replay a trajectory

Every session's raw PTY bytes are captured to your workspace folder. Open a past session and it re-renders losslessly through xterm.js, with play, scrub, and speed controls (1x / 2x / 4x / instant). Close the tab, reopen later — the trajectory is still there.