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

## Prerequisites

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

<Steps>
  <Step title="Connect a coding agent">
    Open the [Replicas app](https://replicas.dev/home). Choose your coding agent, then select one of its connection methods. If it only supports one method, you'll go straight to setup.

    <Tabs>
      <Tab title="Coding-agent subscription">
        Install the [Replicas CLI](/features/cli):

        <CodeGroup>
          ```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
          ```
        </CodeGroup>

        Log in:

        ```bash theme={null}
        replicas login
        ```

        Then connect your subscription:

        <CodeGroup>
          ```bash Claude Code theme={null}
          replicas claude-auth
          ```

          ```bash Codex theme={null}
          replicas codex-auth
          ```

          ```bash Muse Code theme={null}
          replicas muse-auth
          ```
        </CodeGroup>

        The credential is saved to your personal account. Add `--org` to the authentication command to share it with your organization.
      </Tab>

      <Tab title="API key or cloud provider">
        Select an API-key, Bedrock, or Foundry option in the **Agent** step and configure one provider.

        See [Credentials](/admin/credentials) for provider-specific setup.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Connect source control">
    Select **Connect GitHub** or **Connect GitLab** and authorize your account. You'll continue to **Repositories** after connecting.
  </Step>

  <Step title="Add repositories">
    Search for and add the repositories you want to work on.

    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](/admin/team#inviting-members).

    Replicas creates an [environment](/features/environments) for the repository automatically.
  </Step>

  <Step title="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](/admin/team); select **X** to dismiss it.
  </Step>

  <Step title="Create a workspace">
    Return to the [app](https://replicas.dev/home), 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.
  </Step>
</Steps>

<Check>
  Your setup is complete when the workspace opens and the agent begins processing your message.
</Check>

## Next steps

<CardGroup cols={2}>
  <Card title="Configure the workspace" icon="sliders" href="/features/environments">
    Add variables, files, skills, and setup hooks.
  </Card>

  <Card title="Connect an integration" icon="puzzle-piece" href="/features/github">
    Start work from GitHub, GitLab, Linear, Slack, or Sentry.
  </Card>

  <Card title="Choose a coding agent" icon="robot" href="/features/coding-agents/claude-code">
    Compare authentication and agent-specific features.
  </Card>

  <Card title="Invite your team" icon="users" href="/admin/team">
    Add members and manage roles.
  </Card>
</CardGroup>