> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inference.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> List, switch, create teams, and invite members from the CLI.

A team maps 1:1 to an organization on Inference.net. Every command that talks to the API scopes its request to a team, using a request header, so switching teams is instant and does not require signing in again.

<Note>
  Team management commands require session login (`inf auth login`). A project API key cannot list, switch, create, or invite to teams.
</Note>

## `inf team list`

List every team you belong to. The active team is flagged with a green dot (`●`).

<Metadata text="cli/team/list" />

```bash theme={"system"}
inf team list
```

**Alias:** `inf team ls`

## `inf team current`

Show the ID, name, and slug of the active team.

<Metadata text="cli/team/current" />

```bash theme={"system"}
inf team current
```

If no team is active, the command errors and points you at `inf team switch <id>`.

## `inf team switch`

Set a different team as the active team for later commands. The CLI looks up your teams to resolve the ID, slug, or name you pass, then stores the resolved team ID in local config. It does not call `organization/set-active`, so it never touches your session's stored active team on the server.

<Metadata text="cli/team/switch" />

```bash theme={"system"}
inf team switch <id-or-slug>
```

**Alias:** `inf team use`

### Arguments

| Argument     | Required | Description                                    |
| ------------ | -------- | ---------------------------------------------- |
| `id-or-slug` | Yes      | The target team's ID, slug, or exact team name |

### Examples

<Metadata text="cli/team/switch-examples" />

```bash theme={"system"}
inf team switch team_abc123
inf team switch acme
inf team switch "Acme Research"
```

<Note>
  Switching teams does not change your active project. Run `inf project list` after switching to see the new team's projects, then `inf project switch <id>` to pick one.
</Note>

## `inf team create`

Create a new team with a default project, and make both active.

<Metadata text="cli/team/create" />

```bash theme={"system"}
inf team create <name>
```

### Arguments

| Argument | Required | Description                   |
| -------- | -------- | ----------------------------- |
| `name`   | Yes      | Display name for the new team |

### Example

<Metadata text="cli/team/create-examples" />

```bash theme={"system"}
inf team create "Acme Research"
```

## `inf team invite`

Invite a person to the active team by email.

<Metadata text="cli/team/invite" />

```bash theme={"system"}
inf team invite <email>
```

### Arguments

| Argument | Required | Description                           |
| -------- | -------- | ------------------------------------- |
| `email`  | Yes      | Email address of the person to invite |

### Options

| Option          | Required | Description                         | Default  |
| --------------- | -------- | ----------------------------------- | -------- |
| `--role <role>` | No       | Role to assign: `member` or `admin` | `member` |

### Examples

<Metadata text="cli/team/invite-examples" />

```bash theme={"system"}
inf team invite teammate@example.com
inf team invite teammate@example.com --role admin
```

<Tip>
  Invite to a specific team without switching your active team, using the global `--team` flag:

  <Metadata text="cli/team/invite-with-team" />

  ```bash theme={"system"}
  inf team invite teammate@example.com --team team_abc123
  ```
</Tip>