Skip to main content

​
Prerequisites

​
Step-by-step walkthrough

​
1. Create an SSH key

Go to SSH Keys settings and create a new SSH key. You’ll use this to authenticate with workspaces.

​
2. Connect GitHub

Go to Integrations settings, authorize your GitHub account, and grant Replicas access to your repositories.

​
3. Add repositories

Still in Integrations settings, add the repositories where Replicas should create pull requests.

​
4. Configure coding agents

Go to Agents settings and connect Claude Code and/or Codex. This determines which agent(s) can work on your tasks.
All credentials are encrypted and only accessed when provisioning workspaces and creating pull requests.

​
5. Connect Linear

Go back to Integrations settings and connect your Linear workspace. This lets Replicas receive task assignments.

​
6. Assign your first issue

In Linear, create or select an issue and assign it to Replicas just like you would assign it to a team member.
  • A thread appears asking which agent you want to use
  • Replicas spawns a workspace and starts working on the issue
  • Streamed output posts in the thread as the agent works
  • When done, a PR link appears in the comments
Review the PR and merge when ready!

​
Triggering from GitHub

You can also trigger Replicas directly from any pull request by mentioning @tryreplicas in a comment. See GitHub integration for setup.

​
Customizing workspace setup

Create a replicas.json file in your repository root to customize how workspaces initialize: 
{
  "startHook": {
    "commands": ["npm install", "npm run build"]
  },
  "systemPrompt": "Custom instructions for agents."
}
Learn more.

​
Where to go next

Workspaces

How workspaces run and manage themselves

Linear

Learn more about the Linear integration