Teams

Teams are the core organizational unit in Operum. Each team has its own set of agents, working directory, and configuration.

What is a Team?

A team represents a project or product you're working on. It includes:

• Working Directory - Where agent files and context are stored
• Agents - The AI agents assigned to work on this project
• GitHub Repository - Optional connected repo for code operations
• Templates - CLAUDE.md configurations for each agent

Creating a Team

1. Click "Create Team" in the sidebar
2. Enter a name for your team
3. Select a working directory on your machine
4. Optionally connect a GitHub repository
5. Click "Create"

Teams are stored in ~/.config/operum/teams/ or in your repo directory:

~/.config/operum/teams/my-team/
├── pm/
│   └── agent.md           # Your customizations
├── architect/
│   └── agent.md
├── engineer/
│   └── agent.md
├── tester/
│   └── agent.md
├── marketing/
│   └── agent.md
├── community/
│   └── agent.md
└── shared/
    ├── triggers/          # Agent task triggers
    ├── responses/         # Agent responses
    └── knowledge/         # Project knowledge base

Team Limits

The number of teams you can create depends on your subscription:

Switching Teams

Use the team switcher in the top-left corner of the app to switch between teams. Each team maintains its own state, so you can context-switch between projects easily.

Deleting a Team

To delete a team:

1. Open team settings
2. Scroll to the bottom
3. Click "Delete Team"
4. Confirm the deletion

Best Practices

• One team per project - Keep teams focused on a single product or codebase
• Use descriptive names - Make it easy to identify teams at a glance
• Connect GitHub early - Agents work better with repository access
• Customize templates - Tailor agent behavior to your project's needs