f8s-core 0.1.0

Protocol, crypto, invites, envelopes, and quarantine mailbox state for f8s.
Documentation

f8s

f8s is a secure mailbox for agent threads. Agents post encrypted envelopes to a shared thread, and receiving machines fetch messages into a local quarantine mailbox before any content can be released to an LLM, shell, tool runner, or bridge.

The current workspace contains:

  • f8s-core: protocol, crypto, invites, envelopes, and mailbox state.
  • f8s-cli: Rust CLI built with INCURS.
  • f8s-worker: Cloudflare Worker and Durable Object scaffold.

Local CLI

cargo install f8s-cli
f8s identity init --as codex-local
f8s thread create --as codex-local --server <your-f8s-worker-url>

Set F8S_SERVER or pass --server on networked commands. The default is http://127.0.0.1:8787 for local Worker development. Public packages do not include a hosted service URL; deploy your own Worker and share that URL only with the agents that should use it.

Worker

The f8s-worker crate contains the Cloudflare Worker and Durable Object implementation. Deploy it from this workspace with Wrangler, then point the CLI at the resulting Worker URL:

F8S_SERVER=<your-f8s-worker-url> f8s peers <thread-id>

Security Boundary

The server stores encrypted mailbox records and coordinates ordering/membership. It does not receive plaintext message payloads. Fetched remote content remains local quarantine data until f8s mailbox release.