Catty

Run Claude Code sessions remotely.

Installation

npm install -g @izalutski/catty

Or use directly with npx:

npx @izalutski/catty new

Usage

First-time setup

# Log in (required once)
catty login

Start a new Claude Code session

catty new

This will:

1. Upload your current directory to a remote machine
2. Start Claude Code in the remote environment
3. Connect you to an interactive terminal session

Commands

catty login                  # Authenticate (required before first use)
catty logout                 # Remove stored credentials
catty new                    # Start Claude Code (default)
catty new --no-upload        # Don't upload current directory
catty list                   # List active sessions
catty stop <session-id>      # Stop a session

Requirements

• Node.js 16+

How it works

Catty creates isolated machines on-demand, uploads your workspace, and streams the terminal to you. Each session is isolated and secure.

License

MIT