# Teams, sessions, notifications, and usage

> Manage Teams, members, invitations, sign-in sessions, Telegram and per-Computer notifications, plan usage, and promo codes with v42.

The `team`, `invite`, `session`, `notify`, and `usage` command groups manage your [Team](/docs/account/teams), account [sessions](/docs/account/account-and-login), [notifications](/docs/agents/notifications), and [billing usage](/docs/account/credits-and-usage).

## Teams, members, and outgoing invitations (`v42 team`)

```sh
v42 team list
v42 team use <team_id>
v42 team show
v42 team create <name>
v42 team rename <name>
v42 team leave --yes
```

- `team list`: List the Teams your account belongs to and mark the one this profile uses.
- `team use <team_id>`: Save `<team_id>` as the default Team for this CLI profile (use the global `--team <uuid>` flag or `V42_TEAM` to override the Team for a single command).
- `team show`: Show the current Team, including your role in it.
- `team create <name>`: Create a new organization Team (`1` to `100` characters) owned by you. The active Team does not change automatically; switch to it with `v42 team use <team-id>`.
- `team rename <name>`: Rename the current Team (`1` to `100` characters; owner only).
- `team leave --yes`: Leave the current Team (requires `--yes`; the Team owner cannot leave).

### Team members (`v42 team members` / `v42 team member`)

```sh
v42 team members
v42 team member set <--role <admin|member> | --can-register <on|off>> <seat>
v42 team member remove <seat> --yes
```

- `team members`: List all member seats of the current Team.
- `team member set <seat>`: Change a member's `--role` (`admin` or `member`) or `--can-register` (`on` or `off`, whether the member may register Computers). `<seat>` is a seat ID, user ID, or email from `v42 team members` (owner or admin only; the owner's seat cannot be changed).
- `team member remove <seat> --yes`: Remove a member from the current Team (owner or admin only; the owner cannot be removed; requires `--yes`).

### Sending and managing Team invitations (`v42 team invite`)

```sh
v42 team invite create <email> [--role <admin|member>]
v42 team invite list
v42 team invite revoke <id>
```

- `team invite create <email>`: Invite `<email>` to the current Team with `--role` (`member` by default, or `admin`; owner or admin only). Prints the one-time invitation token and link (shown only once) and sends an invitation email.
- `team invite list`: List invitations of the current Team that have not been withdrawn.
- `team invite revoke <id>`: Withdraw a pending invitation by ID (owner or admin only).

## Answering invitations sent to you (`v42 invite`)

```sh
v42 invite list
v42 invite show --token <token>
v42 invite accept [<id>] [--token <token>]
v42 invite decline <id>
```

- `invite list`: List pending invitations sent to your verified email address.
- `invite show --token <token>`: Inspect the invitation behind an invitation link token (pass the part after `#token=` or the full link) without accepting it.
- `invite accept [<id>] [--token <token>]`: Accept an invitation by `<id>` (from `v42 invite list`) or `--token <token>` and join that Team. Your active Team does not change until you run `v42 team use <team-id>`.
- `invite decline <id>`: Decline an invitation by ID.

## Sign-in sessions (`v42 session`)

```sh
v42 session list
v42 session revoke <id> [--yes]
```

- `session list`: List the active sign-in sessions of your account across the web, desktop and mobile apps, and CLIs. `current: true` marks the session this CLI profile uses.
- `session revoke <id>`: Sign out one session so the device using it must sign in again. Revoking the session this CLI profile itself uses requires `--yes` (and signs this profile out; when a local Vibe42 desktop app is installed, the CLI signs in again from it on the next command).

## Notifications (`v42 notify`)

```sh
v42 notify status
v42 notify bind [--wait]
v42 notify unbind
v42 notify prefs <computer> [options]
v42 notify events [--limit <limit>]
```

- `notify status`: Show whether Telegram notifications are bound to your account.
- `notify bind [--wait]`: Generate a one-time link (valid for 10 minutes) to open in Telegram. Pass `--wait` to poll every 3 seconds until the binding completes or expires. Fails with `notify_already_bound` if a Telegram account is already bound—run `v42 notify unbind` first.
- `notify unbind`: Remove the Telegram notification binding from your account.
- `notify prefs <computer>`: Without options, show the notification preferences of `<computer>`. Team owners, admins, or the Computer's owner can update preferences with:
  - `--enable <types>` / `--disable <types>`: Comma-separated event types or `all`. Event types: `terminal_bell`, `terminal_notification`, `agent_confirmation_pending`, `agent_turn_finished`, `agent_error`, `tmux_window_close`, `tmux_pane_close`, `device_tmux_missing`, `device_disconnect`, `session_created`, `session_closed`.
  - `--targets <channels>`: Comma-separated delivery channels (`apns`, `fcm`, `telegram`, `webapp`) or `all`.
  - `--bell-throttle <seconds>`: Minimum seconds between two bell notifications from the same terminal.
  - `--notification-throttle <seconds>`: Minimum seconds between two terminal notifications from the same terminal.
- `notify events [--limit <limit>]`: List the most recently delivered notifications, newest first (`1` to `100`).

## Plan usage and promotion codes (`v42 usage`)

```sh
v42 usage [--devices]
v42 usage redeem <code> [--preview]
```

- `usage`: Show how much of the current Team's plan has been used in the current billing period (Team owners and admins). Pass `--devices` to list traffic and Credits per device for the current usage window instead.
- `usage redeem <code> [--preview]`: Redeem a promotion code for the current Team (Team owner only). Pass `--preview` to check what the code would grant without redeeming it. Discount codes apply at checkout in the Console and cannot be redeemed here.
