> For the complete documentation index, see [llms.txt](https://docs.opscanvas.io/oscar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opscanvas.io/oscar/team-edition.md).

# Team Edition

Oscar Team Edition enables collaborative infrastructure management. Team members can share health check findings, assign tasks, and track resolution status across your organization.

## Quick Start

**Create a new organization:**

```bash
/team create myorg
```

You become the admin and can invite others.

**Join an existing organization:**

```bash
/team join <invite-code>
```

Use the code from your invitation email.

**Check your team status:**

```bash
/team status
```

## Authentication

Use `/team login` to authenticate with your Oscar organization:

```bash
/team login
```

This opens your browser to the OpsCanvas platform where you can sign in with email or Google. Once complete, you're connected to your organization and can use all team features.

![Team login, members, and status commands](/files/8mwtvctCYyBHUOiEiBMn)

**Team vs Solo Mode:**

* **Solo mode** (default): You work independently. Team commands are unavailable.
* **Team mode** (after `/team login`): You're connected to your organization. All team features are active.

Your current mode is shown in the Oscar prompt. Use `/team status` to verify your connection.

**Logout:**

Use `/team logout` to disconnect from your organization:

```bash
/team logout
```

This returns you to solo mode. Your local session is cleared, but your team membership remains intact - you can `/team login` again anytime.

## Organization Management

**View team members:**

```bash
/team members
```

Shows each member's name, email, role, and join date.

**Invite new members:**

Admins can invite new members with `/team invite`:

```bash
/team invite user@example.com --role sre
```

![Team invitation](/files/siGmQKNIgVnwDglwvDAs)

You can invite multiple people at once:

```bash
/team invite user1@example.com user2@example.com user3@example.com --role developer
```

## Task Assignment

Team members can assign health check findings to each other and track resolution status.

**Core workflow:**

1. Run `/check health` to discover issues, then view them in the local web GUI that Oscar opens
2. Assign findings to teammates through the GUI - click on any finding to view details and select an assignee
3. Assignees receive notifications at startup
4. Resolve with `/tasks resolve` or block with `/tasks block`

**See the complete task assignment flow:**

* [Task Assignment Flow](/oscar/team-edition/team-assign/task-assignment.md)

## Command Reference

| Command                                | Description                                            |
| -------------------------------------- | ------------------------------------------------------ |
| `/team login`                          | Authenticate with OpsCanvas platform (email or Google) |
| `/team logout`                         | Log out and return to solo mode                        |
| `/team status`                         | Show current team membership and role                  |
| `/team members`                        | List all members in your organization                  |
| `/team invite <email> [--role <role>]` | Send team invitation (admin only)                      |
| `/team create <org-name> [emails...]`  | Create a new organization (you become admin)           |
| `/team join <code>`                    | Join an organization using an invite code              |

## Notes

* Team authentication opens your browser to the OpsCanvas platform where you can sign in with email or Google
* Your team session persists across Oscar restarts until you `/team logout` or the token expires
* Only admins can use `/team invite`
* All team commands require an active login - if your session expires, Oscar will prompt you to `/team login` again
* All team data is synchronized through Oscar's backend service