catty new

Creates a new cloud machine, uploads your workspace, and connects your terminal to Claude Code.

Synopsis

catty new [options]

Options

Option	Description
`--no-upload`	Don't upload current directory
`--no-git`	Don't upload `.git` directory
`--no-sync-back`	Disable real-time sync of remote changes to local
`--no-auto-reconnect`	Disable automatic reconnection on disconnect
`--no-secrets`	Don't pass stored secrets to session
`--enable-prompts`	Enable permission prompts (default: auto-approve all)
`--agent <name>`	Agent to use: `claude` (default) or `codex`
`--api <url>`	Override API URL

What Happens

Creates a new cloud machine
Uploads current directory to /workspace (unless --no-upload)
Passes your secrets as environment variables (unless --no-secrets)
Starts Claude Code with auto-approved permissions
Connects your terminal via WebSocket
Enables sync-back (unless --no-sync-back)
Starts cloud persistence (saves every 30s)

Examples

# Standard session - uploads current directory
catty new

# Start without uploading workspace
catty new --no-upload

# Start without sync-back
catty new --no-sync-back

# Enable permission prompts (instead of auto-approving)
catty new --enable-prompts

# Start without passing secrets
catty new --no-secrets

# Start without uploading .git directory
catty new --no-git

# Combine options
catty new --no-upload --no-sync-back

Output

Creating session...
Session created: brave-tiger-1234
  Reconnect with: catty connect brave-tiger-1234
  Sync-back: enabled (remote changes will sync to local)
Secrets: GITHUB_TOKEN, GH_TOKEN
Uploading workspace...
Workspace uploaded (2.3 MB)
Connecting...

Exiting

Press Ctrl+C to disconnect (session keeps running)
Type /exit in Claude Code to end the session
Run catty stop <label> from another terminal

After disconnecting, reconnect with catty connect <label>. The session persists until you explicitly stop it.