Create a Manager
- Click + next to Managers in the left sidebar and pick an environment. The Manager is created right away and opens. Before your first one, + explains what a Manager is and asks you to confirm, with Use a workspace if you meant to start a workspace.
- In its first chat, rename it and describe what it’s for, like “Owns the mobile app: Expo, TestFlight releases, mobile bugs”. It reads the description in every chat. Click Skip or just send a message to leave it out. To change either later, click its name in the header, or press and hold it in the mobile app. If you don’t rename it, its description names it, or else your first message.
- Send it work in any of its chats. It replies right away with what it delegated, then acts on each result as it arrives.
create_replica MCP tool, set kind to manager and use a personal API key.
Convert a workspace
To turn one of your own workspaces into a Manager, right-click it in the sidebar and choose More → Make Manager, or press and hold it in the mobile app and tap Make Manager. You can also use the API or themake_manager MCP tool.
- It keeps its chats, sandbox and history. Its next turn in every chat runs as the Manager; a turn already running finishes as it started.
- Ships, archived workspaces and environment setup workspaces can’t be converted.
- A
delete_when_doneorarchive_when_doneworkspace switches to the default lifecycle so it isn’t removed after its next turn. - It can’t be turned back into a regular workspace.
Ship updates
After delegating, the Manager replies and ends its turn. News from its ships starts a new turn, or reaches it mid-turn if it’s still working: a finished turn, or pull requests that are ready or need attention.Board
The Ships tab opens on the board: one ticket per task, grouped under Needs you, Ready to review, Working and Done. Replicas files each ticket from its ship and pull requests, so the groups stay current on their own. Once every pull request on a ticket has merged and deployed, the ticket moves to Done, unless it still has a question for you. It shows under Working while the deploy runs, and under Needs you if the deploy fails or waits on an approval. Each ship writes its own ticket: a short summary of what it did, the screenshots and recordings that show it, and any question only you can answer. The Manager keeps the board in order, leaves a short note on a ticket when it adds something, and writes one overview line at the top. Click a ticket to open it. Answer a question with one of its options or your own words: the answer goes straight to that ship, or to the Manager for its own questions. When a ship stops on a question in its chat, the ticket shows the whole question with its options, and your answer goes to that chat as your own message. The ship’s reply comes back on the ticket under Activity, with a box to keep the conversation going, and a row in the Manager chat links to it. The derived list of ships and pull requests stays under All ships and pull requests, below the board.Chat
The chat shows your messages, the Manager’s replies to them, and what it sends withsend_to_chat after a ship event: work you asked for, or a blocker that needs you. While it works on your message, it posts short updates and a live status line saying what it’s doing. Status like merges and deploys goes to the board. To see its tool calls and ship updates, turn on Show activity in the new chat menu, or in the chat menu in the mobile app.
A Manager doesn’t write code itself, so it has no Files or Terminal pane, diffs or editor and branch actions. Open a ship for those. It keeps the Desktop tab and previews, so you can run a dev server or sign into a site from it.
Sidebar
The Managers section lists your Managers with their status: needs attention, working (the Manager or any of its ships is working or following up pull requests), ready, or idle. Drag a Manager to reorder the section, the same way as Pinned; the order syncs across your devices, and new Managers join at the bottom. Managers always stay in this section, so they can’t be pinned or moved to another one.Avatar
Each Manager gets a Pixel Crew avatar when it’s created. Click it in the Manager’s header to pick another preset, an emoji, an uploaded image, or one you added from the gallery. To share yours, open the Avatars tab in Appearance.Slack
Give a Manager its own Slack channel from the Slack button in its header, or by asking it, like “link #team-alerts” or “create a Slack channel for yourself”. It uses its Slack tools; from outside, use theadd_manager_slack_channel MCP tool. Mention @Replicas in that channel to message it, and it replies under its own name and icon. See Manager channels.
Texting
Text a Manager from your phone, and it texts you back when work is done or it needs you. See Texting a Manager.Linear
Send Linear tickets to a Manager by telling it which ones you want, like “send me support-labeled tickets in the current REP cycle”, or from the Linear button in its header. Pick a team and, optionally, the current cycle, labels, a project and an assignee; a ticket must match all of them, and have at least one of the labels. New tickets that match, and tickets that start matching later (moved into the cycle, labeled, assigned), arrive once each with their description. Finished tickets and tickets already delegated to an agent are skipped. The rule is an automation that runs in the Manager: choose Open automation in the Linear menu to change its prompt, pause it, or see its runs.Sharing
Share a Manager to run it together. Teammates you share it with see it in their Managers section with its ships, get its notifications, and can reach its ships from the API and CLI. To share it with your whole organization, including people who join later, turn on Everyone in your organization in its Share dialog. Anyone can then message it, from the app or its Slack channel. A ship runs as the person who asked for it: for a task from Slack, whoever started the thread; otherwise, the last person who wrote in the chat that started it. It gets that person’s coding agent login, GitHub account, and environments, so their pull requests open from their own account. Ships started from a chat with no one in it, such as one fed only by a Linear rule, run as the Manager’s creator.Notes
A Manager keeps notes on its domain and its decisions in~/.replicas/canvas/manager-notes.md. It reads them when a chat starts and before it delegates work, and updates them when it learns something lasting. The status of ships and pull requests lives on the board. The file survives the workspace sleeping, and you can read it in the Canvas.
Ships
Each ship is its own workspace with its own sandbox, built from its Manager’s environment. To change that environment, open the Manager’s info panel and click Change next to Environment. Ships you spawn afterwards use the new environment; existing ships keep theirs, and the Manager’s own sandbox keeps the repositories it started with. A Manager can also start a ship in another environment the person who asked can use, their personal ones included, such as a backend-only one for a backend task: ask it to, or it picks one whose repositories and services fit the task. To send a kind of work to the same environment every time, add the rule to the system prompt of the Manager’s environment, like “Start ships for mobile work in the mobile-ios environment.” Set it before you create the Manager: an existing Manager keeps the system prompt it started with. The Ships pane shows a ship’s environment on hover when it isn’t the Manager’s. It receives only the task the Manager writes for it, and it does not see uncommitted changes in the Manager. Ships are not listed in the sidebar: find them in the Ships tab. A ship’s question shows on its ticket on the board; the Manager’s sidebar row only needs you when the Manager itself asks you something. Under All ships and pull requests, below the board, ships and their pull requests are grouped under Open PRs, Working, and Shipping (merged and deploying), followed by the other Ships and the ones that are done. A pull request is ready for review once its ship finishes its turn, even while CI runs; hover it to see its checks, and click it to review it. Click a ship’s name to open it in the right pane, where you can follow its work, message it directly, or open its full workspace. On smaller screens, use the Ships button in the header. Replies to your own messages stay in the ship’s workspace, and so does what the ship reports on its own afterwards, until the Manager messages it again. A Manager can hold up to 20 ships that are not archived. The Manager archives a ship once its pull requests are merged or closed, and messaging an archived ship restores it. Ships cannot spawn their own ships.Pull request follow-through
A ship that opens a pull request is not done until the pull request is ready. CI failures and review comments are still fixed automatically in the ship’s workspace, and the Manager tracks them instead of calling the work finished. Once activity settles, the Manager gets one report per ship:- Ready: CI passes, automatic fixes are done, and nothing but a human review or branch protection blocks the merge. The report summarizes what was fixed along the way.
- Needs attention: CI still fails with no fix running, the pull request is a draft, has conflicts or another merge blocker such as requested changes, or fixes have not settled within an hour. The Manager messages the ship or asks you.
- Merged or closed: the ship’s task is done, and Replicas archives it. The archive notice reaches the Manager with its next update rather than waking it. The Manager acts on it only when other work waits on it, such as starting the next task once a pull request merges.