Concepts

Coworkers

A coworker is a named agent profile: a name, a role, a set of behaviour instructions and the coding agent that runs it. You give a coworker work by mentioning it on a ticket, asking it to review a pull request or setting it as the runner of an automation. The same coworker behaves the same way each time, because its instructions are added to the agent's system prompt on every run.

This page explains the concept. For the steps in the desktop app, see Coworkers in Workspace.

An organization coworker assigned to a group.

What a coworker is made of

Part What it is
Name A short handle you mention with @, for example @alex
Role A label such as Code Reviewer or Technical Lead
Behaviour Instructions added to the agent's system prompt on every run
Agent The coding agent that does the work
Avatar A generated picture, so coworkers are easy to tell apart

A coworker runs on your computer, through the coding agent installed there and the account you signed in to that agent with.

Organization coworkers and your own

Organization coworker Your own coworker
Who defines it An admin, in the Organization Console under Manage → Coworkers You, in the desktop app
Where it can be used The organization groups it is assigned to Your private groups
Agent Claude Code The agent you choose: Claude Code, Codex, Antigravity or OpenCode
Can you edit it No. It is read-only on the desktop Yes
Badge in the app Org Local

You can create your own coworkers only if your organization's policy allows it. An admin can also disable an organization coworker, and policy can turn coworkers off for a group. A disabled coworker cannot be picked.

What a coworker does

Where What you ask for
A ticket on a board Mention the coworker in the card's Co-workers tab. It works on the ticket and replies in that chat
A pull request Ask the coworker to review it. It drafts review comments, and you decide whether to post them
An automation Set the coworker as Run as. Every scheduled run is done by that coworker

Coworker, session, AI-DLC

These three are often confused.

What it is How you start it
Coworker A named agent profile you hand a task to Mention it on a card, ask for a review, or set it on an automation
Session A coding agent in a terminal that you work with directly New session on a project
AI-DLC The delivery rules your organization sets for each stage of work Applies automatically in organization groups

A coworker is also separate from the resources of a group. Database connections, API collections and servers are covered in Resources & Access.

Organization groups and private groups

Work a coworker does in an organization group follows that group's rules, including AI-DLC. Work in a private group is not tracked by your organization, and AI-DLC does not apply there.

What’s next