Skip to main content
Get started with Catty in three simple steps.

​
Prerequisites

  • Node.js 18 or later
  • npm or npx

​
Getting Started

1

Install

Install the CLI globally via npm:
npm install -g @diggerhq/catty
Or use npx without installing:
npx @diggerhq/catty new
2

Login

Authenticate with Catty (one-time setup):
catty login
This opens your browser for authentication. Once complete, your credentials are stored locally.
3

Start a Session

Navigate to your project directory and start a new session:
cd my-project
catty new
This creates a cloud machine, uploads your directory, and connects you to Claude Code.
You’re now connected to Claude Code running in the cloud. Work with it just like you would locally - all changes are synced back to your local directory in real-time.

​
Reconnecting to Sessions

Sessions persist until stopped. Reconnect using the session label: 
catty connect brave-tiger-1234
List your sessions: 
catty list

​
Next Steps

Sessions

Learn about managing sessions

Workspace Sync

Understand file synchronization

Commands

Full CLI reference

FAQ

Common questions answered