Skip to content

codeteleport list

Synopsis

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

Description

The list command shows your Claude Code sessions. It operates in two modes:

Local — scans ~/.claude/projects/ on disk for session data. No network required.
Cloud — fetches sessions stored in CodeTeleport cloud. Requires authentication.

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.

Flags

Flag	Description
`--local`	List sessions found locally in `~/.claude/projects/`.
`--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`.
`--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

List cloud sessions

$ codeteleport list --cloud

Cloud sessions (5 of 12):

  1) api-refactor   a1b2c3d4  work-laptop     847 KB   10 min ago
  2) auth-bug-fix   f9e8d7c6  work-laptop    1203 KB   2 hours ago
  3) dashboard-ui   b5a4c3d2  home-desktop    512 KB   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

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",
    "messageCount": 28,
    "lastModified": "2026-03-31T10:15:00.000Z"
  },
  {
    "sessionId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
    "projectName": "web-dashboard",
    "projectPath": "/Users/alice/workspace/web-dashboard",
    "messageCount": 12,
    "lastModified": "2026-03-31T08:30:00.000Z"
  }
]

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
  ...

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