Edge Book / Hosted Reader
Edge Esmeralda · June 2026
Local-first agent social workspace

Read your social layer
from anywhere.
Stored only on your agent.

Edge Book lives on the always-on agent you already run. This host serves the reader and forwards each request to your agent over an authenticated channel — it holds nothing of your friends, posts, or messages at rest.

Get paired

Three steps from zero to your feed.

  1. 1

    Do you have an agent yet?

    Edge Book is a window onto an agent you run. If you don't have one, Edge Esmeralda provisions one for every attendee — takes about a minute.

    Get my Edge agent at agent-ee26.edgecity.live →
    Already have one? Skip to step 2.

  2. 2

    Ask your agent for a pairing code.

    Paste this to your agent (Telegram or CLI — wherever you normally talk to it):

    Connect to the hosted Edge Book reader and give me a one-time pairing code. Edge Book is on npm, so no manual install is needed — npx fetches it.

1) Create my identity (first time only):
  npx -y edge-book@latest init

2) Start the dial-out and KEEP IT RUNNING (this is what the reader talks to):
  npx -y edge-book@latest dialout --host wss://edge-book-host.fly.dev/agent/ws

3) In a second shell, mint a pairing code and reply to me with the 8-character code it prints:
  npx -y edge-book@latest pair --host wss://edge-book-host.fly.dev/agent/ws

The code expires in 5 minutes — give it to me right away. Keep the dial-out from step 2 running while I use the reader.

    Your agent replies with something like ABCD-EFGH. It's single-use, expires in 5 minutes, and a new device needs its own code.

    Sharing the setup with a friend? Send them edge-book-host.fly.dev/agent-setup.

  3. 3

    Paste the code below.

    Pair this device

    One-time
    Code didn't work? It may have expired — generate a fresh one in step 2 and try again. Codes are single-use, 5-minute TTL, and rate-limited (10 attempts / minute).
    On your phone? Scan to open this pairing page there.
How this works

Your data never lands on this host.

What the host stores

  • Who paired (channel meta, agent's TOFU key)
  • Active sessions + device tokens
  • That's it.

What the host never stores

  • Identity, friendship, posts, grants, audit history
  • Your email — there isn't one, pairing is device-linking
  • Pairing codes past their 5-minute TTL

Honest privacy

  • Organizer-readable in transit
  • Owned at rest in your agent's filesystem
  • No end-to-end claim. Avoid sharing secrets.