Migrate from Conductor

Conductor is joining Meta and is winding down. This guide moves your work to Paradev. Your branches, uncommitted changes, and agent subscriptions all come with you.

The local Conductor app keeps working until early 2027, so you can move at your own pace.

Both apps use the same model: one Git worktree and one branch per task, with an agent working inside it. Most of the move is pointing Paradev at the same repositories and translating one config file.

What Maps to What

1. Install Paradev and Add Your Repositories

Install Paradev, then add each repository you used in Conductor from its local folder. Add the same folder that Conductor used, not a new clone: Conductor's worktrees are attached to that checkout, and Paradev finds them through it.

2. Import Your Conductor Workspaces

Each Conductor workspace is an ordinary Git worktree, so Paradev can adopt it in place. Nothing is copied or moved.

1. Right-click the project in the sidebar and choose Import untracked worktrees. You can also use the Import tab in the New Workspace modal.
2. Check the list of branches and paths. Conductor's worktrees are usually under ~/conductor/workspaces/.
3. Leave Run setup script off. These worktrees are already set up.

Imported workspaces keep their paths, branches, and uncommitted changes. New workspaces you create in Paradev go under ~/.paradev/worktrees/.

If a worktree is missing from the list, run git worktree list in the repository. Paradev only imports worktrees that have a branch checked out. A worktree on a detached HEAD needs a branch first (git switch -c <name> inside it).

3. Convert Your Scripts

Move your scripts from conductor.json or .conductor/settings.toml into .paradev/config.json at the repository root.

A conductor.json like this:

{
  "scripts": {
    "setup": "bun install && cp \"$CONDUCTOR_ROOT_PATH/.env\" .env",
    "run": "bun dev --port $CONDUCTOR_PORT",
    "archive": "docker compose down"
  }
}

becomes:

{
  "setup": ["bun install", "cp \"$SUPERSET_ROOT_PATH/.env\" .env"],
  "run": ["bun dev"],
  "teardown": ["docker compose down"]
}

Differences to know:

• Commands are arrays. Each entry runs in order in the workspace directory.
• run is one command set. It starts from the Run button in its own restartable pane. Save other named actions as terminal scripts and launch them from the Scripts bar.
• teardown runs when you delete a workspace, before Paradev removes the worktree. If it fails, you can still Delete Anyway.
• There is no run_mode setting. Each workspace has its own Run pane.
• Personal overrides go in .paradev/config.local.json, not in the committed file. Add it to .gitignore before you commit .paradev/. See Local Config.

Keep Scripts That Read CONDUCTOR_*

If your setup is a shell script that reads CONDUCTOR_* variables, you can keep it unchanged at first. Pass the Paradev values under the old names:

{
  "setup": [
    "CONDUCTOR_ROOT_PATH=\"$SUPERSET_ROOT_PATH\" CONDUCTOR_WORKSPACE_PATH=\"$SUPERSET_WORKSPACE_PATH\" CONDUCTOR_WORKSPACE_NAME=\"$SUPERSET_WORKSPACE_NAME\" ./scripts/conductor-setup.sh"
  ]
}

Replace CONDUCTOR_PORT

Paradev does not reserve a port range for each workspace. It finds the ports that each workspace's processes listen on and shows them in the Ports panel, where you can open them in the browser or stop them.

Most dev servers pick a free port by themselves, so remove --port $CONDUCTOR_PORT. If your app needs a fixed port per workspace, reserve a range in setup and release it in teardown. The Ports page links to an example.

Let an Agent Do It

Create a workspace with this prompt:

Convert this repo's Conductor config (conductor.json or .conductor/settings.toml)
into .paradev/config.json. Read docs.paradev.com/setup-teardown-scripts and
docs.paradev.com/migrate-from-conductor first. Map CONDUCTOR_* variables to
SUPERSET_* variables, and replace CONDUCTOR_PORT as the migration guide describes.

Commit .paradev/ so your team gets the same scripts.

4. Pick Up Your Agents

Claude Code, Codex, Cursor Agent, and OpenCode all run in Paradev on your existing subscriptions and keys. See Supported Agents for the full list, or add any other CLI as a custom agent.

To try to continue a conversation from Conductor, open a terminal in the imported workspace and run the agent's resume command, for example claude --resume or codex resume. The picker shows sessions that the agent CLI saved for that folder. Conductor may not have saved its chats there, so this does not always work. If it doesn't, give the agent the context again, or keep a copy with Conductor's Settings → Account → Export data. After that, Paradev resumes the session by itself if its terminal dies.

Prefer a chat view to a terminal? Switch the agent pane to Chat.

5. Learn the Daily Loop

The first parallel session walks through this end to end. All keyboard shortcuts can be changed.

6. Remove Conductor

The local Conductor app keeps working until early 2027, but you cannot download it again. When your workspaces are in Paradev:

1. Quit Conductor and move it to the Trash.
2. Keep ~/conductor/workspaces/ while you still have workspaces imported from it. They are ordinary worktrees, and deleting the folder deletes your work.
3. Delete a workspace from Paradev when you finish it. Paradev runs teardown and removes the worktree, wherever it lives.
4. After the last old workspace is gone, run git worktree prune in each repository and delete ~/conductor/.

Get Help

Stuck on a step? Ask in the community or see Troubleshooting.