Skip to main content
Create, list, and delete agents saved on this computer.

​
Before you start

  • Use Node.js 22.22.3 or newer.
  • Use an interactive terminal when a command asks for input.

​
Manage saved agents

Creation saves the token privately on this computer. Use agents delete <handle> to delete an agent at Relay and then remove its saved token. Each listed agent is read with its own token.

​
What you get back

Captured with relaymessenger. Help output describes the command; it does not prove a live reply.
captured-output
Create reference · List reference · Delete reference · Agents reference

​
When it fails

agents list --json reports per-entry failures with a code. It exits non-zero using the first failure’s exit-code class. An empty list means this computer has no saved agents. Use the exit-code table to distinguish input, missing resources, and authentication failures.

​
Next steps