ox coworker
Manage expert AI coworkers defined in your team context. These are specialized AI agents with deep domain expertise that can be loaded into your coding session for tasks, code reviews, and specialized work.
Usage
Subcommands
| Command | Description |
|---|---|
list | List available AI coworkers |
load <name> | Load an AI coworker's prompt into context |
add <file> | Add an AI coworker to the team |
remove <name> | Remove an AI coworker from the team |
List available coworkers
| Flag | Description |
|---|---|
--json | Output as JSON |
--team | Use a specific team (defaults to this repo's team) |
Load a coworker
Load an AI coworker's expertise into your current coding session.
The coworker's full prompt is output to stdout for the calling agent to consume. Session metrics are logged when in a recording session.
| Flag | Description |
|---|---|
--model | Override the coworker's default model (sonnet, opus, haiku) |
--json | Output as JSON |
--team | Use a specific team |
This command is agent-gated. It's designed to be called by AI coding agents, not humans directly.
Add a coworker
Add an AI coworker to your team's context.
The file is validated, copied to the team context repository, and committed automatically.
| Flag | Description |
|---|---|
--team | Add to a specific team |
Remove a coworker
Remove an AI coworker from your team.
| Flag | Description |
|---|---|
--force | Skip confirmation prompt |
--team | Remove from a specific team |
Coworker file format
AI coworkers are markdown files with YAML frontmatter. They live in your team context at coworkers/agents/.
---
description: "Expert code reviewer specializing in security and performance"
model: "sonnet"
---
# Code Reviewer
You are an expert code reviewer with deep knowledge of...Required frontmatter
| Field | Description |
|---|---|
description | Brief description of the coworker's expertise |
Optional frontmatter
| Field | Values | Description |
|---|---|---|
model | opus, sonnet, haiku | Recommended model tier. Defaults to inheriting from the calling agent. |
Where coworkers live
AI coworkers are stored in the team context repository:
team-context/
├── coworkers/
│ └── agents/
│ ├── api-designer.md
│ ├── code-reviewer.md
│ └── security-engineer.mdEach team shares the same set of coworkers. Changes to coworkers are version-controlled in the team context repo.
Workflow example
- List available coworkers to see what expertise your team has defined:
- Load a coworker when you need specialized expertise. In a Claude Code session, the agent runs:
- Add a new coworker when your team needs new expertise: