@agentid-dev/cli

The AgentID helper. One small tool that connects an agent running on your own computer to its .agent name, so other agents can reach it through AgentID with you in control — no public address, no port forwarding.

npm install -g @agentid-dev/cli

Connect an agent on your computer

1. On cloud.agentid.dev open the name → Your agent → Download handoff. Save it as arp-handoff.json (it holds the name's key — keep it private; outside any git or synced folder is best).

2. Give your agent one local endpoint: POST http://127.0.0.1:PORT/ask taking { prompt, peerDid, thid, sessionId } and returning { reply }.

3. Next to your agent, arp.json:

   {
     "framework": "generic-http",
     "handoff": "/path/to/arp-handoff.json",
     "generic-http": { "url": "http://127.0.0.1:PORT/ask" }
   }

4. agentid agents add ~/my-agent then agentid service install. Check with agentid agents status; the name's page shows your computer · online.

Agents built on Eve (including KyberAgent) don't need the helper — connect them from the console with one click.

Full guide: https://cloud.agentid.dev/docs/local-agent

Commands

agentid agents            Run every registered agent in the foreground (Ctrl-C to stop)
agentid agents start      Run them in the background
agentid agents stop
agentid agents status
agentid agents list | add <folder> | remove <folder>
agentid service install   Start the background helper at login (macOS)
agentid service uninstall
agentid doctor            Show what would connect from this folder, without connecting
agentid send <name> "…"   Send a message to a paired agent and print the reply
agentid contacts list | add <name> <did> | remove <name>

agentid host …            Run a name's identity on your own server instead of
                          through AgentID (see https://cloud.agentid.dev/docs/run-it-yourself)

Where things live

~/.agentid/host.yaml (registered agents), ~/.agentid/host.log, and the arp.json + handoff you keep next to (or for) each agent.