The catty command-line interface lets you create, manage, and connect to remote Claude Code sessions.
Installation
npm install -g @diggerhq/catty
Commands
| Command | Description |
|---|
| catty new | Start a new session |
| catty connect | Reconnect to an existing session |
| catty list | List all your sessions |
| catty stop | Stop a session |
| catty download | Download workspace from a session |
| catty sync | Sync remote workspace to current directory |
| catty secrets | Manage secrets for sessions |
| catty login | Authenticate with Catty |
| catty logout | Remove stored credentials |
| catty update | Update CLI to latest version |
| catty version | Print version number |
Common Workflows
Start a new session
Reconnect after disconnect
catty list # Find your session
catty connect brave-tiger-1234 # Reconnect
Download work after session ends
catty download brave-tiger-1234
Set up GitHub access
catty secrets add github # One-time setup
catty new # Sessions now have GitHub access
Global Options
| Option | Description |
|---|
--api <url> | Override API URL (for development) |
-h, --help | Show help |
-V, --version | Show version |
Environment Variables
| Variable | Description | Default |
|---|
CATTY_API_ADDR | Override API URL | https://api.catty.dev |
CATTY_DEBUG | Enable debug logging | - |
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 1 | General error |
| 2 | Authentication required |
| Platform | Architecture |
|---|
| macOS | Intel (x64), Apple Silicon (arm64) |
| Linux | x64, ARM64 |
Windows is not yet supported.
Authentication
All commands except login, logout, and version require authentication. Credentials are stored at ~/.catty/credentials.json and automatically refreshed when expired.
# First-time setup
catty login
# Check if logged in
cat ~/.catty/credentials.json
