# ox team (https://sageox.ai/docs/cli/team)

# ox team

Work with your teams and coworkers. A bare `ox team` lists the teams you belong to (the same as `ox team list`), and each team owns a Team Context: its permanent conversation store of recordings, Discussions, Sessions, and shared memory (distinct from a Knowledge Bubble, those are listed by `ox kb list`).

## Usage

<Terminal>
  <TerminalCommand>ox team [command]</TerminalCommand>
</Terminal>

Most subcommands act on the team associated with the current repository (set during `ox init` and resolved from `.sageox/config.yaml`). Pass `--team <id-or-slug>` to target a different team.

## Subcommands

| Command | Description |
|---------|-------------|
| `ox team list` | List the teams you belong to |
| `ox team members` | List a team's coworkers (humans and AI coworkers) |
| `ox team show` | Show one team's details |
| `ox team open` | Open a team's dashboard in the browser |
| `ox team invite` | Invite people to a team by email |

## Examples

### List your teams

<Terminal>
  <TerminalCommand>ox team</TerminalCommand>
</Terminal>

Lists every team you belong to and its Team Context. Equivalent to `ox team list`.

### List a team's coworkers

<Terminal>
  <TerminalCommand>ox team members</TerminalCommand>
</Terminal>

Shows each coworker on the team (human and AI) with their display name, type, role, and known handles (such as a GitHub login). Add `--team <id-or-slug>` to inspect a team other than this repo's. This roster is gated by a server-side flag; when the flag is off or the server is older, the command reports the capability as unavailable rather than failing.

### Show one team's details

<Terminal>
  <TerminalCommand>ox team show acme</TerminalCommand>
</Terminal>

Prints a team's identity, where its Team Context lives on disk, how recently it synced, and its coworker count. With no argument, shows this repo's team.

### Invite people by email

<Terminal>
  <TerminalCommand>ox team invite alex@test.sageox.ai,sam@test.sageox.ai --role member</TerminalCommand>
</Terminal>

Invites one or more people (comma-, semicolon-, or space-separated), and emails each a join link. Use `--role member|admin|owner` to set the grant, `--list` to see outstanding invitations, and `--cancel <id>` to revoke one. Invitations expire after 7 days, and delivery is best-effort, a reported invitation is not proof the email arrived.

### Open a team's dashboard

<Terminal>
  <TerminalCommand>ox team open</TerminalCommand>
</Terminal>

Opens the SageOx web dashboard for this repo's team in your browser.

## Flags

| Flag | Description |
|------|-------------|
| `--json` | Output as JSON |

## What's next

- [ox init](/docs/cli/init) - initialize a repo and associate it with a team
- [ox export](/docs/cli/export) - find where your Team Context lives on disk
- [Team Context](/docs/features/team-context) - team-wide shared knowledge, versus the per-repo Ledger