v42 CLI

Teams, sessions, notifications, and usage

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

View as Markdown

The team, invite, session, notify, and usage command groups manage your Team, account sessions, notifications, and billing 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.