config

Synopsis

codeteleport config                       # show current config
codeteleport config set <key> <value>     # update a setting

Description

The config command displays your current configuration with a redacted token. Use config set to update individual settings without going through the full setup wizard.

Settable keys

Key	Description	Example
`agent`	Coding agent ID	`claude-code`
`deviceName`	Name for this machine	`work-laptop`
`apiUrl`	API server URL	`https://api.codeteleport.com/v1`

CodeTeleport supports three AI coding agents — Claude Code (id claude-code, default), Codex (OpenAI, id codex), and Antigravity (Google, id antigravity). Choose interactively with codeteleport setup (lists all supported agents from the registry) or directly with codeteleport config set agent <claude-code|codex|antigravity>. Setting an unrecognized id fails with the exact error Unknown agent: <id>. Supported: claude-code, codex, antigravity.

The agent setting controls only what is bundled and scanned locally (push, local list) and which resume command CodeTeleport suggests. It does not affect pulling: a bundle restores using the agent recorded in the bundle itself, so you can pull a Codex bundle on a machine configured for Claude Code.

The token field is not settable via config. Use codeteleport auth login or codeteleport setup to authenticate.

Examples

View config

$ codeteleport config

CodeTeleport Configuration

  agent      : claude-code (Claude Code)
  deviceName : work-laptop
  apiUrl     : https://api.codeteleport.com/v1
  token      : ctk_live_...f456 (set)

With a different agent selected, the agent line renders as agent : codex (Codex) or agent : antigravity (Antigravity).

Switch coding agent

$ codeteleport config set agent codex
Set agent = codex

Unrecognized IDs are rejected:

$ codeteleport config set agent gpt
Unknown agent: gpt. Supported: claude-code, codex, antigravity

Update device name

$ codeteleport config set deviceName home-desktop
Set deviceName = home-desktop

Point to local dev server

$ codeteleport config set apiUrl http://localhost:8787/v1
Set apiUrl = http://localhost:8787/v1

Invalid key

$ codeteleport config set token my-token
Token is not settable via config. Use `codeteleport auth login` instead.

$ codeteleport config set unknown value
Unknown config key: unknown
Settable keys: agent, deviceName, apiUrl

codeteleport setup — full onboarding wizard
codeteleport auth — manage authentication
codeteleport status — verify your config is working