Skip to main content
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 account
  • A supported coding-agent subscription or API key
1

Connect a coding agent

Open the Replicas app. Choose your coding agent, then select one of its connection methods. If it only supports one method, you’ll go straight to setup.
Install the Replicas CLI:
Log in:
Then connect your subscription:
The credential is saved to your personal account. Add --org to the authentication command to share it with your organization.
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.Replicas creates an environment 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; select X to dismiss it.
5

Create a workspace

Return to the app, 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.
Your setup is complete when the workspace opens and the agent begins processing your message.

​
Next steps

Configure the workspace

Add variables, files, skills, and setup hooks.

Connect an integration

Start work from GitHub, GitLab, Linear, Slack, or Sentry.

Choose a coding agent

Compare authentication and agent-specific features.

Invite your team

Add members and manage roles.