Conductor uses the conductor.json file to configure scripts.

Shared configuration

The best way to use conductor.json is to create it in the root directory of your workspace and then check it into git. This will let you version your configuration along with your code, and let new developers get started quickly using Conductor in your repo.

Local configuration

Alternatively, you can create the conductor.json file in your repo root directory. This configuration will apply across all your workspaces. You can get to the repo root directory by clicking the repository name in the sidebar and then clicking the Open button.

Under the hood

Conductor looks for a conductor.json file in three places:
  1. The root of your workspace. In a workspace ~/my-repo/.conductor/tokyo, Conductor will look for ~/my-repo/.conductor/tokyo/conductor.json.
  2. The root of the default branch on remote. Typically this will be origin/main.
  3. The root of your repository. In a repository ~/my-repo, Conductor will look for ~/my-repo/conductor.json.