setup

Synopsis

codeteleport setup

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 the agent’s mcp add command separately.

Steps

Step 1 — Agent

Select your coding agent. CodeTeleport supports three AI coding agents — Claude Code (id claude-code, the default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity). The wizard lists every supported agent from the registry, so new agents appear automatically.

You can change the agent later without re-running the full wizard via 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, which uses each bundle’s recorded agent.

Step 2 — Authentication

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

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

Optionally register CodeTeleport as an MCP server with your coding agent. The wizard runs the correct command for the agent you selected in Step 1:

# Claude Code
claude mcp add codeteleport -- codeteleport-mcp

# Codex
codex mcp add codeteleport -- codeteleport-mcp

# Antigravity
agy mcp add codeteleport -- codeteleport-mcp

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

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)
  2) Codex
  3) Antigravity

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

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

The Agent line here shows the previously configured agent recorded in your config — it may be Claude Code, Codex, or Antigravity.

codeteleport config — view or update individual settings, including switching agent with codeteleport config set agent <claude-code|codex|antigravity> (setting an unrecognized id fails with Unknown agent: <id>. Supported: claude-code, codex, antigravity)
codeteleport auth — manage authentication separately
codeteleport status — verify your setup is working