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 CodeTeleport is not configured yet, the command exits with a helpful message instead of failing:

CodeTeleport is not configured yet. Run `codeteleport setup` to get started.

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 or pro).
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.

Tip

For details on plan tiers and what each limit means, see Plans & Limits.

Note

status reports account, device, and plan info only. The active AI coding agent is a separate config setting. CodeTeleport supports three agents — Claude Code (id claude-code, the default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity). To see or change which one is active, use codeteleport config get agent / codeteleport config set agent <claude-code|codex|antigravity> — see config.

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 configured

$ codeteleport status
CodeTeleport is not configured yet. Run `codeteleport setup` to get started.

Related commands

• codeteleport setup — configure CodeTeleport and pick your agent
• codeteleport auth login — log in or register
• codeteleport list --cloud — see all your cloud sessions in detail