Skip to content

codeteleport status

Synopsis

codeteleport status

Description

The status command prints a summary of your CodeTeleport account and current device. It’s a quick way to verify that you’re logged in, check which API server you’re connected to, and see how much of your plan’s quota you’ve used.

If you’re not logged in, the command exits with a helpful message instead of failing:

Not logged in. Run `codeteleport auth login` first.

The status output pulls data from two API endpoints: your account profile and your usage stats. It also fetches the most recent cloud session to show the last push timestamp.

Flags

None. This command takes no flags or arguments.

Example output

$ codeteleport status
CodeTeleport Status
  user     : alice@example.com
  device   : work-laptop
  api      : https://api.codeteleport.com/v1
  plan     : free
  sessions : 7 / 25
  devices  : 2 / 3
  last push: 3/31/2026, 10:15:32 AM (work-laptop)

Status fields

Field	Description
`user`	The email address associated with your CodeTeleport account.
`device`	The name of this device, derived from your hostname at login time.
`api`	The API server URL this device is configured to talk to.
`plan`	Your current plan (`free`, `pro`, or `team`).
`sessions`	Number of cloud sessions used vs. your plan’s limit. Shows `(unlimited)` for plans with no cap.
`devices`	Number of registered devices vs. your plan’s limit. Shows `(unlimited)` for plans with no cap.
`last push`	Timestamp and source machine of the most recent session push. Omitted if no sessions exist.

Pro plan example

$ codeteleport status
CodeTeleport Status
  user     : bob@company.com
  device   : office-desktop
  api      : https://api.codeteleport.com/v1
  plan     : pro
  sessions : 42 (unlimited)
  devices  : 5 / 10
  last push: 3/30/2026, 4:22:08 PM (work-laptop)

Not logged in

$ codeteleport status
Not logged in. Run `codeteleport auth login` first.

codeteleport auth login — log in or register
codeteleport list --cloud — see all your cloud sessions in detail