Usage Examples

You do not need to memorize tool names. Just describe what you want in plain English and your AI coding agent (Claude Code, Codex, or Antigravity) will call the right MCP tool.

The examples below use Claude Code (the default agent), so the assistant replies are labelled Claude:. Codex and Antigravity work identically through the same MCP tools — the only thing that differs is the resume command shown after a push or pull:

Claude Code: claude --resume <id>
Codex: codex resume <id>
Antigravity: agy --conversation <id>

The resume command is derived from the agent that created the bundle (its recorded agentId), not the agent configured on the machine doing the pull. So a Codex bundle still prints codex resume <id> even when pulled on a Claude Code machine. CodeTeleport supports three agents — Claude Code (id claude-code, default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity); choose yours with codeteleport setup or codeteleport config set agent <claude-code|codex|antigravity>. The agent setting controls only what is bundled and scanned locally (push, local list); it does not affect pull.

Push a session to the cloud

You: Save this conversation so I can continue on my laptop. Call it “billing API” and tag it “backend”.

Your agent calls teleport_push with label: "billing API" and tags: ["backend"].

Claude: Session teleported to CodeTeleport
  id      : c3a05473
  size    : 284 KB
  machine : Alices-Desktop.local
  messages: 47
You can pull this on your laptop and resume with claude --resume c3a05473 (Codex: codex resume c3a05473, Antigravity: agy --conversation c3a05473).

The resume command matches the agent that created the bundle, not the one configured on the puller’s machine.

List cloud sessions

You: What sessions do I have?

Your agent calls teleport_list.

Claude: You have 3 sessions stored in CodeTeleport:

# ID Machine Project Date Size
1 c3a05473 Alices-Desktop ~/projects/billing-api Mar 28, 2026 284 KB
2 7f2b1e90 Alices-Laptop ~/work/frontend Mar 27, 2026 512 KB
3 a91d44c2 Alices-Desktop ~/projects/auth-service Mar 25, 2026 198 KB

Want me to pull one of these?

#	ID	Machine	Project	Date	Size
1	c3a05473	Alices-Desktop	~/projects/billing-api	Mar 28, 2026	284 KB
2	7f2b1e90	Alices-Laptop	~/work/frontend	Mar 27, 2026	512 KB
3	a91d44c2	Alices-Desktop	~/projects/auth-service	Mar 25, 2026	198 KB

Pull a session

You: Pull my latest session.

Your agent calls teleport_pull with the most recent session ID.

Claude: Session installed.
  id: c3a05473
  Resume with: claude --resume c3a05473
All paths have been rewritten from /Users/alice to /Users/bob automatically.

The Resume with: line is teleport_pull’s literal output and matches the agent that created the bundle — a Codex bundle prints codex resume c3a05473 and an Antigravity bundle prints agy --conversation c3a05473, regardless of which agent is configured on this machine.

Path rewriting is a two-pass rewrite (source home dir → target home dir, then source cwd → target cwd). For Claude Code and Codex JSONL transcripts (and memory/brain text files) this is plain text replacement; for an Antigravity bundle the same paths are rewritten inside the binary protobuf payloads of the SQLite conversation DB, with field-length prefixes recomputed so message framing stays valid. See path rewriting for details.

Pull to a specific directory

You: Pull session 7f2b1e90 to /home/bob/repos/frontend.

Your agent calls teleport_pull with sessionId: "7f2b1e90..." and targetDir: "/home/bob/repos/frontend".

Claude: Session installed and anchored at /home/bob/repos/frontend. Resume with claude --resume 7f2b1e90.

As above, the resume command is bundle-derived — a Codex bundle would say codex resume 7f2b1e90 and an Antigravity bundle agy --conversation 7f2b1e90. See path rewriting for details on how directory anchoring works.

Browse local sessions

You: Show me my local sessions.

Your agent calls teleport_local_list. This scans the local store of your configured agent — Claude Code (~/.claude/projects/), Codex (~/.codex/sessions/), or Antigravity (~/.gemini/antigravity-cli/conversations/).

Claude: You have 5 local AI coding sessions:

ID Project Messages Last active Size
c3a05473… billing-api 47 Mar 28, 14:32 284 KB
e8f21a03… billing-api 12 Mar 28, 09:15 91 KB
7f2b1e90… frontend 83 Mar 27, 17:44 512 KB
d4419bc1… docs-site 29 Mar 26, 11:02 156 KB
a91d44c2… auth-service 61 Mar 25, 16:30 198 KB

These are on your local machine. Want me to push any of them to the cloud?

ID	Project	Messages	Last active	Size
c3a05473…	billing-api	47	Mar 28, 14:32	284 KB
e8f21a03…	billing-api	12	Mar 28, 09:15	91 KB
7f2b1e90…	frontend	83	Mar 27, 17:44	512 KB
d4419bc1…	docs-site	29	Mar 26, 11:02	156 KB
a91d44c2…	auth-service	61	Mar 25, 16:30	198 KB

Check account status

You: How’s my CodeTeleport account looking?

Your agent calls teleport_status.

Claude: Here is your CodeTeleport status:

CodeTeleport Status
  user     : alice@example.com
  device   : Bobs-Laptop.local
  api      : https://api.codeteleport.com
  plan     : free
  sessions : 3 / 25
  devices  : 2 / 3
  last push: 3/28/2026, 2:32:14 PM (Alices-Desktop.local)

You are on the free plan with 22 sessions remaining.

Delete a session

You: Delete that old auth-service session.

Your agent calls teleport_delete with the session ID.

Claude: Session a91d44c2-… deleted from CodeTeleport. This cannot be undone.

Tool reference

For the full list of inputs and parameters, see the MCP Tools reference.