Installation

CodeTeleport is distributed as an npm package. Install it globally to get both the codeteleport CLI and the codeteleport-mcp server.

CodeTeleport supports three AI coding agents — Claude Code (id claude-code, the default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity). You choose your agent interactively during codeteleport setup, or directly with codeteleport config set agent <claude-code|codex|antigravity>.

1. Install the package

   npm install -g codeteleport

   Or with your preferred package manager:

   pnpm add -g codeteleport
   # or
   yarn global add codeteleport

2. Verify the installation

   codeteleport --version

   You should see output like:

   0.7.0

System requirements

Requirement	Minimum
Node.js	22.5.0 or later
OS	macOS, Linux, or Windows
Coding agent	Claude Code (~/.claude), Codex (~/.codex), or Antigravity (~/.gemini/antigravity-cli)

Node 22.5+ is required because CodeTeleport uses the built-in node:sqlite module to read and write Codex and Antigravity session state. This module is cross-platform, so it works the same on Windows as on macOS and Linux.

Note

Windows is fully supported. Sessions teleport across operating systems: CodeTeleport rewrites paths between Windows drive letters (e.g. C:\Users\alice) and POSIX home directories, so a session pushed from Windows restores correctly on macOS or Linux and vice versa. If you prefer to run your AI coding agent (Claude Code, Codex, or Antigravity) inside WSL, CodeTeleport also works in that Linux environment.

What gets installed

The package provides two executables:

• codeteleport — the CLI for pushing, pulling, and managing sessions from your terminal
• codeteleport-mcp — the MCP server that lets your AI coding agent (Claude Code, Codex, or Antigravity) call teleport tools directly during a conversation

The MCP server is agent-agnostic; registration differs per agent (claude mcp add, codex mcp add, or agy mcp add) and is handled for the selected agent by codeteleport setup.

Next step

You have CodeTeleport installed. Now set up authentication so you can push and pull sessions.