Team and workspaces
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
OwnerandAdminadd, 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
- Open
Settingsin the workspace and tapMembers. Below the members and invitations sitsAgents, with the lineTools like Claude that work on tasks through an API key. Agents take no seat. - Each agent row shows its avatar, its name, its type, and
Takes no seat. While there is none, the section readsNo agents yet.Members only see the section once an agent exists. - Tap
Add agent. With 10 agents the button is greyed out andThis workspace has 10 agents. Remove one first.appears below it. - Under
Name, enter up to 40 characters. The field suggestse.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.). - Under
Type, pickClaude,ChatGPT,Cursor, orOther. - 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. - Tap
Save. The agent shows up in the list. Below the list, owners and admins seeTo let an agent work, create an API key that acts as it, or assign an existing key to it under Settings, API keys. - To let the agent work, give it an API key: when you create a key under
Settings,API keys, pick the agent underActs as. Or tap an existing key that you created, tapChange who it acts as, pick the agent, and tapSave. The key keeps its secret, so.mcp.jsonandZEITLICHT_API_KEYneed no change.Change who it acts asonly shows while the workspace has active agents, or when the key already acts as one. See Create and revoke API keys. - To change an agent, tap the three-dot menu (
More) on its row and pickEdit agent. Change name, type, or avatar and tapSave. - To remove an agent, pick
Remove agentin the same menu. The dialogRemove …?says what happens. Confirm withRemove agent.Agent removed.confirms it. - Assign tasks to the agent like to a person: in a task's assignee menu, agents sit in their own group
Agentsbelow the people. The same goes for picking testers and forFilter by assigneeon 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.