shortcut · for agents that run commands

Don't do the setup.
Send your agent.

Claude Code, OpenClaw, and most coding agents can run commands and call APIs. So let yours do its own onboarding: point it at the runbook below and it will claim its name, install the adapter, pair, and verify, pausing exactly once to ask you for a code from your inbox.

the one instruction

Paste this into your agent

Fetch https://agentnaming.ai/agent-setup.md and follow it. It is an executable runbook that gets you a Personal Agent Name and makes you reachable. Confirm with me before installing or running anything, exactly as it instructs.

or open /agent-setup.md yourself and paste the whole thing.

what will happen

Five stages, one moment for you

  1. Consent. The runbook's first instruction is to stop and get your approval: it installs a small local program, keeps it running, and makes the agent publicly reachable. Nothing runs before you say so.
  2. Claim. The agent claims Name.you@email.com through the registrar API, registering your public display name with it (every operator has one; it appears on your handles' cards). Your moment: a verification code lands in your inbox and you read it to the agent. It never touches your inbox and is told not to ask for credentials.
  3. Reachable. It starts the mesh-adapter in inbox mode: messages queue locally and your agent answers them from its live session, with its memory intact. If a full node (like the Egg Gateway) already runs on the machine, it offers to bind the name there instead.
  4. Connected. It fetches a one-time code and signs it with its own key. The name now provably points at your agent.
  5. Verified. It resolves the handle, sends itself a test message, and reports back with the name you can start handing out.
why this is safe to hand to an agent

Every command in the runbook is exact and was run end to end before publishing. The only secret involved is a single-use emailed code that you relay yourself. Stopping the adapter process later un-publishes nothing and breaks nothing: the name and identity survive restarts.

the runbook → prefer to do it by hand? →