codeteleport list

Synopsis

codeteleport list [--local] [--cloud] [--push] [--json] [--machine <name>] [--tag <tag>] [--agent <id>] [--all] [--limit <n>]

Description

The list command shows your AI coding sessions. It operates in two modes:

• Local — scans your configured agent’s session store on disk for session data. No network required. (Claude Code: ~/.claude/projects/; Codex: ~/.codex/sessions/; Antigravity: ~/.gemini/antigravity-cli/conversations/.)
• Cloud — fetches sessions stored in CodeTeleport cloud. Requires authentication.

Both modes default to your configured agent (codeteleport config set agent <claude-code|codex|antigravity>, or interactively via codeteleport setup): local mode scans that agent’s on-disk store, and cloud mode shows only that agent’s synced sessions. Each cloud row is labelled with the agent that created it. Use --all to list every agent’s cloud sessions, or --agent <id> to view a specific one.

When no mode flag is given, an interactive prompt asks you to choose:

What do you want to list?
  1) Local sessions
  2) Cloud sessions
>

In local mode, you can combine --push to enter an interactive multi-select flow that lets you push one, several, or all local sessions to the cloud in a single operation.

Note

CodeTeleport supports three AI coding agents — Claude Code (id claude-code, the default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity). The agent setting scopes what you see by default in both local and cloud list (and the pull picker). It does not restrict what you can pull: pulling a specific session by ID always works regardless of agent, and the bundle restores into that agent’s native location.

Tip

For a deeper look at what sessions contain and how they’re stored, see Sessions.

Flags

Flag	Description
--local	List sessions found locally for your configured agent (e.g. ~/.claude/projects/ for Claude Code, ~/.codex/sessions/ for Codex, ~/.gemini/antigravity-cli/conversations/ for Antigravity).
--cloud	List sessions stored in CodeTeleport cloud.
--push	After listing local sessions, enter interactive push mode. Only valid with --local.
--json	Output as JSON. Works with both --local and --cloud.
--machine <name>	Filter cloud sessions by source machine name. Only valid with --cloud.
--tag <tag>	Filter cloud sessions by tag. Only valid with --cloud.
--agent <id>	Filter cloud sessions by agent (claude-code, codex, or antigravity). Defaults to your configured agent. Only valid with --cloud.
--all	Show cloud sessions from all agents, overriding the default per-agent scope. Only valid with --cloud.
--limit <n>	Maximum number of cloud sessions to return. Defaults to 20. Only valid with --cloud.

Examples

List local sessions

$ codeteleport list --local

Local sessions (4 found):

  1) api-service     a1b2c3d4  28 messages   15 min ago
  2) web-dashboard   f9e8d7c6  12 messages   2 hours ago
  3) shared-utils    b5a4c3d2   4 messages   1 day ago
  4) api-service     c7d8e9f0  45 messages   3 days ago

The example above shows Claude Code sessions. The same columns are shown for Codex and Antigravity sessions, except the project name falls back to (unknown) when the agent’s session data doesn’t record a working directory (Codex and Antigravity derive the project name from the session’s cwd basename).

List cloud sessions

$ codeteleport list --cloud

Cloud sessions (5 of 12):

  1) api-refactor   a1b2c3d4  work-laptop     847 KB   v3 (3)  10 min ago
  2) auth-bug-fix   f9e8d7c6  work-laptop    1203 KB   2 hours ago
  3) dashboard-ui   b5a4c3d2  home-desktop    512 KB   v2 (2)  1 day ago
  4) api-refactor   c7d8e9f0  work-laptop     934 KB   3 days ago
  5) docs-update    d1e2f3a4  home-desktop    289 KB   1 week ago

Sessions with multiple versions show v3 (3) — the current version number and total version count. Single-version sessions show no version indicator. Use codeteleport versions to see the full version history.

Filter cloud sessions by machine

$ codeteleport list --cloud --machine home-desktop

Cloud sessions (2 of 2):

  1) dashboard-ui   b5a4c3d2  home-desktop   512 KB   1 day ago
  2) docs-update    d1e2f3a4  home-desktop   289 KB   1 week ago

Filter cloud sessions by tag

$ codeteleport list --cloud --tag bugfix

Cloud sessions (1 of 1):

  1) auth-bug-fix   f9e8d7c6  work-laptop   1203 KB   2 hours ago

Interactive push mode

Combine --local and --push to select sessions and push them to the cloud in one step:

$ codeteleport list --local --push

Local sessions (4 found):

  1) api-service     a1b2c3d4  28 messages   15 min ago
  2) web-dashboard   f9e8d7c6  12 messages   2 hours ago
  3) shared-utils    b5a4c3d2   4 messages   1 day ago
  4) api-service     c7d8e9f0  45 messages   3 days ago

Enter session numbers to push (comma-separated), "all", or "q" to quit:
> 1,2
Pushing api-service (a1b2c3d4)... done  847 KB
Pushing web-dashboard (f9e8d7c6)... done  512 KB

2 sessions pushed to cloud.

You can also push everything at once:

> all
Pushing api-service (a1b2c3d4)... done  847 KB
Pushing web-dashboard (f9e8d7c6)... done  512 KB
Pushing shared-utils (b5a4c3d2)... done  289 KB
Pushing api-service (c7d8e9f0)... done  934 KB

4 sessions pushed to cloud.

JSON output for scripting

$ codeteleport list --local --json
[
  {
    "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "projectName": "api-service",
    "projectPath": "/Users/alice/workspace/api-service",
    "encodedProjectPath": "-Users-alice-workspace-api-service",
    "jsonlPath": "/Users/alice/.claude/projects/-Users-alice-workspace-api-service/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jsonl",
    "sizeBytes": 867328,
    "messageCount": 28,
    "firstMessageAt": "2026-03-31T09:42:00.000Z",
    "lastMessageAt": "2026-03-31T10:15:00.000Z"
  },
  {
    "sessionId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
    "projectName": "web-dashboard",
    "projectPath": "/Users/alice/workspace/web-dashboard",
    "encodedProjectPath": "-Users-alice-workspace-web-dashboard",
    "jsonlPath": "/Users/alice/.claude/projects/-Users-alice-workspace-web-dashboard/f9e8d7c6-b5a4-3210-fedc-ba9876543210.jsonl",
    "sizeBytes": 524288,
    "messageCount": 12,
    "firstMessageAt": "2026-03-31T08:05:00.000Z",
    "lastMessageAt": "2026-03-31T08:30:00.000Z"
  }
]

The example above shows Claude Code local sessions. Codex and Antigravity populate the same fields, with a few agent-specific differences:

• Codex — encodedProjectPath is empty and jsonlPath points at the rollout transcript file (~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<id>.jsonl).
• Antigravity — jsonlPath points at the conversation SQLite DB (~/.gemini/antigravity-cli/conversations/<id>.db), and firstMessageAt is null.

Note

The --json flag is useful for piping into jq or feeding into other tools. For example, to get just session IDs: codeteleport list --local --json | jq '.[].sessionId'. The sessionId works with codeteleport push and codeteleport pull regardless of which agent produced the session. To inspect on-disk locations instead, use jq '.[].jsonlPath'.

Interactive mode (no flags)

$ codeteleport list
What do you want to list?
  1) Local sessions
  2) Cloud sessions
> 1

Local sessions (4 found):

  1) api-service     a1b2c3d4  28 messages   15 min ago
  ...

Related commands

• codeteleport push — push a single session to the cloud
• codeteleport pull — download a cloud session to this machine
• codeteleport delete — remove a session from the cloud