We've raised a $22m Series A →Skip to docs content
Conductor

Reference

Cities

How Conductor names workspaces after cities

Every Conductor workspace gets a city name.

Cities make workspace names memorable and distinct. They also give each workspace a stable directory base, so agents, shells, editors, and other tools can keep finding the same files on disk.

Conductor still uses the branch name or pull request title as the main way to identify active work. In the sidebar, the work item is primary; the city name is the place where that work lives.

Why cities exist

Conductor creates isolated workspaces so you can run agents in parallel without making them fight over one checkout. Each workspace gets its own branch, working tree, files, running processes, and .context folder.

The city name is the friendly, durable part of that workspace location. For example, a workspace might live in a directory like san-antonio-v3 while the branch explains what the workspace is doing.

For the underlying workspace model, see Isolated workspaces.

Passport

You can see the cities you have visited in Passport. Open it from Command K and search for Passport.

Passport is mostly for fun. It turns your workspace history into a little travel log, including the rare cities you have found along the way.

Finding every city

Conductor currently has 295 cities.

If you keep every spawned workspace active, Conductor avoids city bases that are already active. In that case, finding all cities is deterministic: it is impossible before 295 active workspaces and guaranteed at 295 active workspaces.

The probabilities below describe a different situation: visiting cities over time, where archived or deleted workspaces no longer prevent repeats. In that model, repeats are possible, and the last few cities take much longer to find.

Probability of finding all 295 cities

Workspace spawns vs. chance of complete discovery.

Probability curve
Quantile thresholds
Probability of finding all 295 citiesA line chart showing the chance of seeing all 295 cities after between 5,000 and 30,000 workspace spawns.0%25%50%75%100%5k10k15k20k25k30k50%75%90%95%99%Workspaces spawnedProbability of seeing all 295 cities20,000 spawns93.27% chance
20,000 workspaces: 93.27% chance of seeing all citiesEach legendary city: ~1 in 3,600 spawnsn = 295 cities
The probability reaches about 50% after 11,815 workspace spawns, 75% after 14,923, 90% after 18,516, 95% after 21,101, and 99% after 26,964.

Chance of seeing all cities

Approximate likelihood of having seen all 295 cities after n workspace spawns:

Workspaces spawnedChance all cities seen
5,0000.29%
6,0001.68%
7,0005.34%
8,00011.81%
9,00020.69%
10,00030.99%
11,00041.65%
12,00051.83%
13,00060.98%
14,00068.87%
15,00075.47%
16,00080.84%
18,00088.55%
20,00093.27%
22,00096.08%
24,00097.74%
26,00098.70%
28,00099.25%
30,00099.57%

Confidence milestones

ConfidenceWorkspaces needed
50%~11,815
75%~14,923
90%~18,516
95%~21,101
99%~26,964

On this page