Replicas CLI

Official CLI for Replicas - manage cloud development workspaces with automatic SSH tunneling.

Installation

| Package manager | Command | | --- | --- | | npm | npm install -g replicas-cli | | pnpm | pnpm add -g replicas-cli | | yarn | yarn global add replicas-cli | | bun | bun add -g replicas-cli |

Quick Start

# Login to your Replicas account
replicas login

# Connect to a workspace
replicas connect my-workspace

Commands

replicas login

Authenticate with your Replicas account via browser-based OAuth.

replicas logout

Clear stored credentials.

replicas whoami

Display current authenticated user.

replicas org

Display current organization.

replicas org switch

Choose the organization used by organization-scoped commands. The selection persists across sessions.

replicas connect <workspace-name>

Connect to a workspace via SSH.

Coding agents

Use replicas claude-auth or replicas codex-auth to connect Claude Code or Codex credentials. Cursor uses a Cursor API key configured in Coding Agents settings.

Configuration

Create a replicas.json or replicas.yaml file in your repository root:

{
  "systemPrompt": "Custom instructions for coding agents.",
  "startHook": {
    "commands": ["npm install", "npm run build"]
  }
}

Or use YAML for better readability (especially for multiline system prompts):

systemPrompt: |
  Custom instructions for coding agents.
  Supports multiline text.

startHook:
  commands:
    - npm install
    - npm run build

Features

• Secure Authentication: OAuth-based login with token refresh
• Quick SSH Access: Connect to workspaces with a single command
• SSH Key Caching: Reuse SSH keys across sessions
• Multi-Organization: Switch between different organizations

How it Works

1. SSH Key Management: The CLI securely caches SSH keys in ~/.replicas/keys/

Requirements

• Node.js 18+
• SSH client (openssh)

Support

For issues or questions, visit https://replicas.dev

License

MIT