codeteleport pull

Synopsis

codeteleport pull [--session-id <id>] [--target-dir <path>] [--machine <name>]

Description

The pull command downloads a session from CodeTeleport cloud storage and installs it into the local Claude Code data directory (~/.claude/projects/). After installation, you can resume the session with claude --resume.

If no --session-id is provided, the command fetches your cloud sessions and presents an interactive picker. You always see a confirmation before any download starts.

During installation, all paths inside the session are automatically rewritten to match the current machine’s username and directory structure. A session pushed from /Users/alice/workspace/myapp on one machine will be correctly mapped to /Users/bob/projects/myapp on another. See Path Rewriting for how this works.

Flags

Flag	Description
--session-id <id>	Pull a specific session by ID instead of browsing the list.
--target-dir <path>	Anchor the session at this directory. Defaults to the current working directory. This is the project root that paths will be rewritten relative to.
--machine <name>	Filter the session list to only show sessions pushed from a specific machine.

Examples

Interactive pull (browse cloud sessions)

$ codeteleport pull

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

Pick a session (number): 1

Downloading...
Installing...

Session pulled
  id   : a1b2c3d4-e5f6-7890-abcd-ef1234567890
  from : work-laptop
  to   : /Users/bob/.claude/projects/-Users-bob-workspace-api

Resume with: claude --resume a1b2c3d4-e5f6-7890-abcd-ef1234567890

Pull a specific session

$ codeteleport pull --session-id a1b2c3d4-e5f6-7890-abcd-ef1234567890
Downloading...
Installing...

Session pulled
  id   : a1b2c3d4-e5f6-7890-abcd-ef1234567890
  from : work-laptop
  to   : /Users/bob/.claude/projects/-Users-bob-workspace-api

Resume with: claude --resume a1b2c3d4-e5f6-7890-abcd-ef1234567890

Pull into a specific directory

$ codeteleport pull --target-dir ~/projects/api-service
Downloading...
Installing...

Session pulled
  id   : a1b2c3d4-e5f6-7890-abcd-ef1234567890
  from : work-laptop
  to   : /Users/bob/.claude/projects/-Users-bob-projects-api-service

Resume with: claude --resume a1b2c3d4-e5f6-7890-abcd-ef1234567890

Filter by source machine

$ codeteleport pull --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

Pick a session (number):

Tip

After pulling, cd into your project directory and run the claude --resume command shown in the output. Claude Code will pick up the full conversation context — messages, tool calls, and file history — exactly where you left off.

What happens during pull

1. Download — the compressed session bundle is fetched from cloud storage to a temporary file.
2. Unbundle — the archive is extracted and session files are written into ~/.claude/projects/.
3. Path rewriting — all absolute paths in the session data (working directory, file references, tool call arguments) are rewritten from the source machine’s paths to the current machine’s paths. See Path Rewriting.
4. Cleanup — the temporary download file is removed.

Related commands

• codeteleport push — push a session to the cloud
• codeteleport list --cloud — browse cloud sessions without pulling
• codeteleport delete — remove a session from the cloud