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

Create a workspace connected to one repository and one coding agent.

## Prerequisites

* A [Replicas](https://replicas.dev) account
* A GitHub or GitLab repository you can access
* A supported coding-agent subscription or API key

<Steps>
  <Step title="Connect a repository">
    Open the [Replicas app](https://replicas.dev/home). In the onboarding guide:

    1. Select **GitHub** or **GitLab**.
    2. Authorize your account and choose which repositories Replicas can access.
    3. Search for and add one repository.

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

  <Step title="Connect a coding agent">
    Choose one authentication method.

    <Tabs>
      <Tab title="Claude Code or Codex 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
          ```
        </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 Bedrock">
        Open [Organization → Coding Agents](https://replicas.dev/dashboard/agents) and configure one provider.

        Replicas supports Anthropic, AWS Bedrock, Cursor, OpenCode Go, Aster, Vercel AI Gateway, and OpenRouter credentials. See [Credentials](/admin/credentials) for provider-specific setup.
      </Tab>
    </Tabs>
  </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>