> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayapp.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage saved agents

> Create, list, and delete agents saved on this computer.

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

```bash theme={null}
relaymessenger agents create --json
relaymessenger agents list --json
```

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.

```text captured-output theme={null}
{
  "agents": []
}
```

[Create reference](/cli/reference/agents-create) · [List reference](/cli/reference/agents-list) · [Delete reference](/cli/reference/agents-delete) · [Agents reference](/cli/reference/agents-create)

## 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](/cli/reference/help#exit-codes) to distinguish input, missing resources, and authentication failures.

## Next steps

* [Send a message](/messages/send)
* [Read chat history](/chats/history)
* [Debug a request](/live/debugging)