Back to overview

Add agents to the workspace

I want to …

… give a tool such as Claude Code, ChatGPT, or Cursor its own name in the workspace, so you can assign it tasks and see what it changed.

Before you start

  • An agent is a tool that works on tasks through an API key of this workspace. It is not a person and has no login.
  • Only Owner and Admin add, edit, and remove agents. Every member sees the agents and can assign tasks to them.
  • Adding and editing agents needs your own Ultra plan. Without it, the section shows Adding and editing agents needs Ultra. Removing works on every plan.
  • A workspace can have at most 10 active agents. Removed agents don't count.
  • Agents take no seat. They don't count toward the seats of your plan or the free Pro memberships of Ultra.

Here's how

  1. Open Settings in the workspace and tap Members. Below the members and invitations sits Agents, with the line Tools like Claude that work on tasks through an API key. Agents take no seat.
  2. Each agent row shows its avatar, its name, its type, and Takes no seat. While there is none, the section reads No agents yet. Members only see the section once an agent exists.
  3. Tap Add agent. With 10 agents the button is greyed out and This workspace has 10 agents. Remove one first. appears below it.
  4. Under Name, enter up to 40 characters. The field suggests e.g. Claude · BeCoach. Upper and lower case don't count: the name must differ from every other active agent (Another agent already has this name.) and from every member's name (A member has this name. Pick another one so nobody mixes them up.).
  5. Under Type, pick Claude, ChatGPT, Cursor, or Other.
  6. Under Avatar, pick one of six circuit-style avatars. They are reserved for agents. Wherever an agent appears, its avatar carries a small robot badge at the lower right, so nobody takes it for a person.
  7. Tap Save. The agent shows up in the list. Below the list, owners and admins see To let an agent work, create an API key that acts as it, or assign an existing key to it under Settings, API keys.
  8. To let the agent work, give it an API key: when you create a key under Settings, API keys, pick the agent under Acts as. Or tap an existing key that you created, tap Change who it acts as, pick the agent, and tap Save. The key keeps its secret, so .mcp.json and ZEITLICHT_API_KEY need no change. Change who it acts as only shows while the workspace has active agents, or when the key already acts as one. See Create and revoke API keys.
  9. To change an agent, tap the three-dot menu (More) on its row and pick Edit agent. Change name, type, or avatar and tap Save.
  10. To remove an agent, pick Remove agent in the same menu. The dialog Remove …? says what happens. Confirm with Remove agent. Agent removed. confirms it.
  11. Assign tasks to the agent like to a person: in a task's assignee menu, agents sit in their own group Agents below the people. The same goes for picking testers and for Filter by assignee on the board. An agent can also be a tester. See Assign a task and add watchers and Test a task and report bugs.

The result

The agent has its own name and avatar in the workspace. A key that acts as it writes as the agent: task history, comments, bugs, and Activity show the agent's name and avatar with on behalf of … and via API key “…”, for example "on behalf of Mia · via API key “Claude”". In the history and in Activity, the agent's avatar carries its robot badge instead of the small key that marks other changes made through a key. When someone else assigns a task to the agent or asks it to test, the people whose keys act as that agent see … assigned a task to your agent … or … asked your agent … to test a task in Activity. While no active key acts as the agent, nobody gets this. Nobody gets it for a change they made themselves.

Common questions

Why can't I add an agent?

You are a Member, your plan is not Ultra, or the workspace already has 10 active agents. Members don't see Add agent at all. Without Ultra, Add agent is greyed out and Edit agent is missing from the menu.

Does an agent use a seat?

No. Agents take no seat and don't count toward invitations, seats, or free Pro memberships.

What happens to tasks when I remove an agent?

Removing is permanent and cannot be undone. Every API key that acts as the agent is revoked at once and shows The agent … was removed under Revoked and expired. Tasks keep the agent, greyed out as "… (Removed agent)", until someone else takes them. A removed agent can only be taken off a task, never assigned again. The board's assignee filter still lists it, so you can find its old tasks.

Why can't another admin change my key's agent?

A key always works on behalf of the person who created it. So only that person sees Change who it acts as. Other admins see Only … can change who this key acts as. They can still revoke the key.

Can an agent watch a task?

No. Agents don't read Activity, so they are missing from Watchers, and nobody can mention them with @. They can be assignees and testers.

Does a key that acts as an agent need anything else?

The same as every key: its creator must stay Owner or Admin and keep Ultra. If not, the key stops working, as described in Create and revoke API keys.

Related topics