Command Reference
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.
Team management commands require session login (inf auth login). A project API key cannot list, switch, create, or invite to teams.
inf team list
List every team you belong to. The active team is flagged with a green dot (●).
inf team listAlias: inf team ls
inf team current
Show the ID, name, and slug of the active team.
inf team currentIf 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.
inf team switch [id-or-slug]Alias: inf team use
Arguments
| Argument | Required | Description |
|---|---|---|
id-or-slug | No | The target team's ID, slug, or exact team name |
Examples
# Choose a team from an interactive list
inf team switch
inf team switch team_abc123
inf team switch acme
inf team switch "Acme Research"In a non-interactive shell or with --json, pass an ID or slug. The CLI cannot show an interactive selector in these modes.
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.
inf team create
Create a new team with a default project, and make both active.
inf team create <name>Arguments
| Argument | Required | Description |
|---|---|---|
name | Yes | Display name for the new team |
Example
inf team create "Acme Research"inf team invite
Invite a person to the active team by email.
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
inf team invite teammate@example.com
inf team invite teammate@example.com --role adminInvite to a specific team without switching your active team, using the global --team flag:
inf team invite teammate@example.com --team team_abc123