# replicas-cli

> CLI for managing Replicas workspaces - SSH into cloud dev environments with automatic port forwarding

Latest version **0.2.711** (published 2026-09-20) · MIT license · 3.0K weekly downloads

## Install

```sh
npm install replicas-cli
pnpm add replicas-cli
yarn add replicas-cli
bun add replicas-cli
```

## Health

**Score 65/100 (B)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.2.711 |
| Published | 2026-09-20 |
| First published | 2025-10-19 |
| Weekly downloads | 3.0K |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Replicas |
| Maintainers | replicas |
| Keywords | cli, replicas, workspace, dev-environment, ssh, cloud, vm, remote-development |

## Links

- npm: https://www.npmjs.com/package/replicas-cli
- Repository: https://github.com/connortbot/replicas
- Homepage: https://replicas.dev
- Issues: https://github.com/connortbot/replicas/issues
- npm.io page: https://npm.io/package/replicas-cli

## Alternatives

- [env-contract](https://npm.io/package/env-contract.md) — 133 weekly downloads
- [@openveo/api](https://npm.io/package/@openveo/api.md) — 61 weekly downloads
- [@ryniaubenpm2/cumque-error-reiciendis](https://npm.io/package/@ryniaubenpm2/cumque-error-reiciendis.md) — 54 weekly downloads
- [ts-global-type-extra](https://npm.io/package/ts-global-type-extra.md) — 11 weekly downloads
- [zulip-cloud9](https://npm.io/package/zulip-cloud9.md) — 3 weekly downloads

## Recent versions

- 0.2.711 (latest) — 2026-09-20
- 0.2.710 — 2026-09-20
- 0.2.709 — 2026-09-19
- 0.2.708 — 2026-09-18
- 0.2.707 — 2026-09-18
- 0.2.706 — 2026-09-17
- 0.2.705 — 2026-09-17
- 0.2.704 — 2026-09-16
- 0.2.703 — 2026-09-16
- 0.2.702 — 2026-09-16
- 0.2.701 — 2026-09-16
- 0.2.700 — 2026-09-16
- 0.2.699 — 2026-09-16
- 0.2.698 — 2026-09-15
- 0.2.697 — 2026-09-15
- … 663 more at https://npm.io/package/replicas-cli/versions

## README

# Replicas CLI

Official CLI for [Replicas](https://replicas.dev) - 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

```bash
# 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.

### `replicas code [workspace-name...]`
Open a workspace in VS Code via Remote SSH. Omit the argument to pick a workspace with the arrow keys and Enter, or pass a name or ID. Names with spaces work with or without quotes.

### Coding agents
Use `replicas claude-auth` or `replicas codex-auth` to connect subscription credentials. Gemini CLI and Cursor use API keys configured in Coding Agents settings.

## Configuration

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

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

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

```yaml
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](https://replicas.dev)

## License

MIT

---
_Source: https://npm.io/package/replicas-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._