Migrate from Conductor

​

How the two fit together

​

1. Install Nuphos and add a local runtime

​

2. Keep working in your existing worktrees

git worktree list

“Work in ~/conductor/workspaces/web/warsaw. It is on branch fix-login-redirect. Read the diff against main and continue the task.”

​

3. Convert your scripts

{
  "scripts": {
    "setup": "pnpm install && cp \"$CONDUCTOR_ROOT_PATH/.env\" .env",
    "run": "pnpm dev --port $CONDUCTOR_PORT",
    "archive": "./scripts/archive.sh"
  },
  "runScriptMode": "nonconcurrent"
}

#!/usr/bin/env bash
set -euo pipefail
pnpm install
# The main checkout is the first entry in `git worktree list`.
root="$(git worktree list --porcelain | sed -n 's/^worktree //p' | head -n 1)"
[ -f .env ] || cp "$root/.env" .env

## Working in a new worktree
- Run `scripts/setup.sh` once before anything else.
- Start the dev server with `pnpm dev --port <port>`. Pick a free port and
  tell me which one you used.
- Before deleting a worktree, run `scripts/archive.sh`.

• CONDUCTOR_ROOT_PATH — use the first entry of git worktree list, as above, or an absolute path.
• CONDUCTOR_WORKSPACE_PATH — the current directory, or git rev-parse --show-toplevel.
• CONDUCTOR_WORKSPACE_NAME — the folder name, basename "$PWD", or the branch name, git branch --show-current.
• CONDUCTOR_PORT — Nuphos does not assign ports. Pass a port explicitly, or let the dev server choose a free one.
• Run button and run_mode — there is no Run button. Ask the agent to start the server; to avoid two servers fighting for one port, say so in CLAUDE.md.
• Archive script — runs only when you or the agent run it.

​

Let an agent convert them

“This repo has Conductor config in conductor.json or .conductor/settings.toml. Move the setup, run, and archive scripts into scripts/, replace every CONDUCTOR_* variable with git or plain shell equivalents, and add a short section to CLAUDE.md (and AGENTS.md if it exists) telling an agent when to run each script. Leave the Conductor files in place and show me the diff before committing.”

​

4. Bring over your agent sessions

​

5. Day-to-day in Nuphos

​

6. Remove Conductor

1. Run git worktree list in each repository and confirm the worktrees you still need are outside ~/conductor, or that their branches are pushed.
2. Quit Conductor and delete the app.
3. Remove leftover worktrees with git worktree remove <path>, then run git worktree prune in each repository.
4. Delete ~/conductor once it is empty.
5. Remove conductor.json or .conductor/ from repositories where you no longer need them.

​

What’s different

• No automatic worktrees. Conductor creates a branch and worktree for every workspace. In Nuphos the agent creates one when you ask, using git.
• No setup or run script hooks. Scripts run when you or the agent run them, guided by CLAUDE.md, AGENTS.md, or a team skill.
• No built-in port allocation. Choose ports explicitly.
• More places to run. The same conversation can move between your Mac, your own server, and a cloud computer.
• Explicit sharing. Team skills and team memory can be reused across the team. Conversation access, computer access and personal credentials have separate controls; belonging to a team does not make all private work public.

​

FAQ