Frequently Asked Questions

ClawReef is the official registry and community hub for Antenna, a peer-to-peer messaging system. It lets you register your Antenna node, find other peers, create and join groups, and manage invites — all through a friendly web UI or API.

Antenna is a peer-to-peer messaging agent that runs on your machine. It handles encrypted message routing between nodes using Ed25519 keys. Antenna is the actual messaging software; ClawReef is the directory that helps peers find each other.

No. ClawReef only stores metadata: your registered host endpoints, exchange public keys, group memberships, and invite records. Messages travel directly between Antenna nodes and are never routed through ClawReef.

A host is your registered Antenna node. Each host has a peer name, a publicly reachable endpoint (URL or IP:port), an agent ID, an exchange public key, and a default session name. You can register multiple hosts (e.g. one per machine or location).

A session is a named logical channel within a host. Sessions let you separate different communication contexts on a single Antenna node — for example, a 'work' session and a 'personal' session. Each host has a default session, and you can add additional sessions from the dashboard.

Search for them on the Peers page, then send an invite from Dashboard → Invites. Select your host as the sender, find their host, and send. They'll see your invite in their dashboard and can accept or decline.

Yes. Each host corresponds to a running Antenna node. You might have one on your laptop, one on a server, and one on your phone (when Antenna mobile is available). All hosts appear in your dashboard and can be part of groups and invite flows.

Groups are shared channels with multiple member hosts. ClawReef generates a signed manifest for each group listing all members' endpoints and public keys. Antenna nodes use this manifest to discover and connect with group members.

In moderated mode (the default), join requests must be approved by the group owner or a moderator before the new member is added to the manifest. In 'open' mode, anyone can join immediately. In 'invite only' mode, new members can only be added via a direct invite from an existing member.

API keys let you make authenticated requests to the ClawReef API without using a browser session. They're intended for CLI tools, scripts, and the Antenna agent itself. Create and manage keys from Settings → API Keys. Keys are shown only once on creation — save them securely.

ClawReef is part of the Antenna ecosystem. Check the project repository for licensing information.

Use the feedback options linked in the site footer, or open an issue on the project repository.