Skip to content
CodeTeleport

setup

Synopsis

Section titled “Synopsis”
Terminal window
codeteleport setup

Description

Section titled “Description”

The setup command walks you through first-time configuration in four steps: agent selection, authentication, device naming, and MCP integration. If you’ve already configured CodeTeleport, it detects the existing config and offers to reconfigure.

This is the recommended starting point for new users. It replaces the need to run auth login, config set, and claude mcp add separately.

Steps

Section titled “Steps”

Step 1 — Agent

Section titled “Step 1 — Agent”

Select your coding agent. Currently only Claude Code is supported. When more agents are added, they’ll appear in this list automatically.

Step 2 — Authentication

Section titled “Step 2 — Authentication”

Choose GitHub OAuth or email/password. Same flow as codeteleport auth login.

Step 3 — Device Name

Section titled “Step 3 — Device Name”

Name this machine. Defaults to your hostname. This name appears in session metadata so you know which machine pushed each session.

Step 4 — MCP Integration

Section titled “Step 4 — MCP Integration”

Optionally register CodeTeleport as an MCP server with your coding agent. For Claude Code, this runs:

Terminal window
claude mcp add codeteleport -- codeteleport-mcp

If MCP setup fails, the command is shown so you can run it manually.

Example

Section titled “Example”
$ codeteleport setup


Welcome to CodeTeleport — teleport your AI coding sessions across machines.


Let's get you set up. This takes about 30 seconds.


Step 1 of 4 — Agent


Which coding agent do you use?


  1) Claude Code  (recommended)


Select [1]: 1


✓ Agent set to Claude Code


Step 2 of 4 — Authentication


How do you want to log in?
  1) GitHub
  2) Email & Password
> 1


Opening browser for GitHub login...


✓ Logged in as alice@example.com


Step 3 of 4 — Device Name


Device name [alices-laptop]: alices-laptop


✓ Device name set to alices-laptop


Step 4 of 4 — MCP Integration


Register CodeTeleport as an MCP server in Claude Code?
This lets you push and pull sessions directly from conversations.


  Run: claude mcp add codeteleport -- codeteleport-mcp


Set up MCP now? [Y/n]: Y


Running: claude mcp add codeteleport -- codeteleport-mcp


✓ MCP server registered


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Setup complete!


  Agent    : Claude Code
  Device   : alices-laptop
  MCP      : Available


You're ready to teleport. Try these:


  From Claude Code:  "Push this session to the cloud"
  From terminal:     codeteleport push


Docs:    https://docs.codeteleport.com
Support: https://discord.gg/c69JYPWS

Already configured

Section titled “Already configured”
$ codeteleport setup


Existing configuration found:
  Agent   : Claude Code
  Device  : alices-laptop
  API     : https://api.codeteleport.com/v1


Reconfigure? [y/N]: N
Setup cancelled. Your existing configuration is unchanged.
Section titled “Related commands”