Coworkers
This page covers the Co-workers screen in Workspace: how to create a coworker, and how to use one on a ticket, a pull request review or an automation. For what a coworker is and how organization coworkers differ from your own, see Coworkers.
Open the Co-workers screen
Select Co-workers at the bottom of the Workspace sidebar. The screen has up to two sections:
| Section | Badge | What you can do |
|---|---|---|
| From your organization · read-only | Org | See each coworker and the groups it is assigned to. These tiles do not open |
| Yours | Local | Click a tile to edit it. + New coworker creates one |
+ New coworker is available only if your organization's policy allows you to create your own coworkers.
Create a coworker
- On the Co-workers screen, select + New coworker.
- Pick an Avatar style. Select Re-roll to get a different picture in that style.
- Enter a Name. It can contain lowercase letters only, because it is what you type after
@. - Enter a Role / skill, for example
Code Reviewer. - Write how the coworker should behave. This text is appended to the agent's system prompt on every run.
- Under Powered by, choose the agent: Claude, Codex, Antigravity or OpenCode. If the agent shows Not installed, run one of the install commands shown, then select Re-check.
- Optional: set the Review model used when this coworker reviews a pull request. The dialog shows Signed in when you are signed in to that agent.
- Optional: set the Review timeout (minutes). This is the limit before a stuck review is stopped. Blank means 20 minutes.
- Select Create coworker.
Edit or delete a coworker
- On the Co-workers screen, click one of your own tiles.
- Change the fields and select Save, or select Delete and confirm.
Organization coworkers cannot be edited or deleted from the desktop.
Use a coworker on a ticket
- Open a card on a board.
- Open the Co-workers tab.
- Type
@, pick a coworker from the list, and write what you want done. - Send the message. The coworker works on the ticket and replies in the same chat.
This chat is private to Clauge. It is not posted to the issue on GitHub, GitLab or Jira.
Only one coworker is active on a card at a time. If you mention a different one, Clauge asks you to confirm with Switch coworker?. If the ticket is already being worked on in one of your sessions, the chat is locked until you switch to that session or end the work there. A coworker needs a working directory, so on a project board the project must have a linked folder.
Ask a coworker to review a pull request
- On a board, switch the header to Reviews and open a pull request.
- On the Review tab, select Ask a coworker to review.
- Pick the coworker and select Start review.
- When the review is ready, read the draft comments.
- Select Post review to post them to the pull request, or dismiss them.
You get a notification in Clauge when the drafts are ready. Nothing is posted to the pull request until you post it.
Run an automation as a coworker
Every automation runs as a coworker. In the automation editor, choose the coworker under Run as. If you have none, select + Create a co-worker there.
Which coworkers you can pick
The pickers list only the coworkers that can be used in the group you are working in:
| You are in | Coworkers offered |
|---|---|
| An organization group | Organization coworkers assigned to that group |
| A private group | Your own coworkers |
The group's overview page lists these under Coworkers.
If a coworker is missing or cannot run
| What you see | Cause |
|---|---|
| No coworkers assigned to this group | No organization coworker is assigned to this organization group. An admin assigns them in the Organization Console |
| The coworker is marked Disabled | An admin has disabled it |
| No + New coworker button | Policy does not allow you to create your own coworkers |
| The agent shows Not installed | Install the agent's command-line tool on this computer, then select Re-check |