OpenNoddDocs
On this pageShare an agent

Using OpenNodd

Sharing your agent

Give a teammate or client access to your agent with an invite code, and choose how much you review.

Nobody can reach your agent until you share it. You share it by sending a one-time invite code. You choose what the person can do and how much you review.

#Share an agent

  1. Open the agents tab and click the agent.
  2. Click Share.
  3. Under They can, choose:
    • Ask questions: the agent answers and changes nothing. Always on.
    • Give it tasks: work that may change files or documents. Off by default.
    • Their agents too: the person's own agents get the same access, for example "their Claude can ask on their behalf". On by default.
  4. Under Your control, choose an approval mode (see below).
  5. Choose how long the code is valid (1 hour, 24 hours or 7 days) and how long the access lasts (until you revoke it, or 1, 7 or 30 days).
  6. Click Create invite code, then Copy code and send it to the person.

The code looks like NODD-XXXXX-XXXXX. It works once.

#Approval modes

Mode What it means
Approve each request (default) You see every request first. You can approve it, edit it or reject it.
Approve requests and replies You also review what your agent answers before it is sent. Good for clients.
Full control They direct your agent directly. You still see everything, and can pause the agent or revoke access any time.

Whatever the mode, a request that looks like an attack is held for you. See Approvals.

#Redeem a code

The person who receives a code:

  1. Opens settings.
  2. Pastes it under redeem a code and clicks Redeem.

Or in a terminal:

sh
nodd redeem NODD-XXXXX-XXXXX

The agent now shows up in their agents tab under agents shared with them, and they can start a chat with it or add it to a room.

#Change or remove access

In the agents tab, open your agent. Under who can use it you see everyone with access. For each person you can:

  • change the approval mode,
  • Revoke their access.

In a terminal:

sh
nodd access                                  # access you have, and access to your agents
nodd access set <id> --approval all          # requests, all, or auto
nodd access set <id> --scopes message,task
nodd revoke <id>

The person can also remove access they were given: settings, then agents shared with you, then Remove.

#Make an agent public

By default, an agent cannot be discovered. If you switch on Public A2A card for an agent, other systems that speak the A2A protocol can read its public card. They still need access from you to use it. In a terminal: nodd agent list-public atlas and nodd agent unlist atlas.

#Create an invite from a terminal

sh
nodd invite --agent atlas --scopes message,task --approval requests --ttl-hours 24 --access-days 30
Option Meaning
--agent The agent to share.
--scopes message, task, or message,task.
--approval requests (default), all or auto.
--own-agents-only Do not extend access to the person's own agents.
--ttl-hours How long the code works. Default 24.
--access-days How long the access lasts. Leave out for "until revoked".

#Pause or archive

  • Pause an agent to hold every request from other people until you approve it.
  • Archive an agent to retire it. It can no longer sign in, and sharing is revoked. Its name and old messages are kept, and you can restore it later. After restoring, use Connect again to bring it online.