> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replicas.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Set up Replicas and create your first workspace in 5 minutes.

Connect a coding agent, add any repositories you need, and create your first workspace.

Organizations with an existing workspace skip initial setup, including when you join or switch to them. During setup, use the **Organization** selector to switch to another organization you belong to.

## Prerequisites

* A [Replicas](https://replicas.dev) account
* A supported coding-agent subscription or API key

**1. Connect a coding agent**

Open the [Replicas app](https://app.replicas.dev). Choose your coding agent, then select one of its connection methods. If it only supports one method, you'll go straight to setup.

> [tab] Coding-agent subscription
>
> Install the [Replicas CLI](https://docs.replicas.dev/features/cli.md):
>
> ```bash npm theme={null}
> npm install -g replicas-cli
> ```
>
> ```bash pnpm theme={null}
> pnpm add -g replicas-cli
> ```
>
> ```bash yarn theme={null}
> yarn global add replicas-cli
> ```
>
> ```bash bun theme={null}
> bun add -g replicas-cli
> ```
>
> Log in:
>
> ```bash theme={null}
> replicas login
> ```
>
> Then connect your subscription:
>
> ```bash Claude Code theme={null}
> replicas claude-auth
> ```
>
> ```bash Codex theme={null}
> replicas codex-auth
> ```
>
> ```bash Muse Code theme={null}
> replicas muse-auth
> ```
>
> The credential is saved to your personal account. Add `--org` to the authentication command to share it with your organization.

> [tab] API key or cloud provider
>
> Select an API-key, Bedrock, or Foundry option in the **Agent** step and configure one provider.
>
> Replicas supports Anthropic, AWS Bedrock, Cursor, OpenCode Go, Aster, and OpenRouter credentials. See [Credentials](https://docs.replicas.dev/admin/credentials.md) for provider-specific setup.

**2. Connect source control**

Select **Connect GitHub** or **Connect GitLab** and authorize your account. You'll continue to **Repositories** after connecting.

**3. Add repositories**

Search for and add the repositories you want to work on.

If repositories fail to load, select **Retry** or reconnect your source-control account.

Each repository can belong to one Replicas organization. Setup shows existing organizations connected to your GitHub or GitLab account or repository owners. You can continue setup, or open an organization you already belong to; opening it dismisses setup for the current organization permanently.

Verified owners of the connected GitHub account and members of a matching GitHub organization can select **Join**, then continue setup or open that organization. Repository access alone still requires a [Replicas invitation](https://docs.replicas.dev/admin/team.md#inviting-members).

Replicas creates an [environment](https://docs.replicas.dev/features/environments.md) for the repository automatically.

**4. Complete setup**

On **Integrations**, connect Slack or Linear, then select **Continue**. Select **Skip** to finish without an integration.

The sidebar checklist tracks integrations, workspace creation, and [team invitations](https://docs.replicas.dev/admin/team.md); select **X** to dismiss it.

**5. Create a workspace**

Return to the [app](https://app.replicas.dev), then:

1. Describe a small task.
2. Select the environment created for your repository.
3. Send the message.

Replicas creates an isolated workspace, starts the agent, and streams its progress. The agent can edit code, run commands, and open a pull request or merge request.

> [!TIP]
>
> Your setup is complete when the workspace opens and the agent begins processing your message.

## Next steps

> [card] [Configure the workspace](https://docs.replicas.dev/features/environments.md)
>
> Add variables, files, skills, and setup hooks.

> [card] [Connect an integration](https://docs.replicas.dev/features/github.md)
>
> Start work from GitHub, GitLab, Linear, Slack, or Sentry.

> [card] [Choose a coding agent](https://docs.replicas.dev/features/coding-agents/claude-code.md)
>
> Compare authentication and agent-specific features.

> [card] [Invite your team](https://docs.replicas.dev/admin/team.md)
>
> Add members and manage roles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.