Resyncing with the server

Build Station resyncs automatically on launch. Most of the time you never need to think about it. But there's a manual Resync action for when you've changed something on the dashboard side and want it reflected here immediately.

What resync does

In order:

1. Fetches your project list

From the backend. Projects added on the dashboard since last sync appear; projects deleted disappear.

2. Fetches each project's agents

Per-project. New agents are added with enabled: true; agents removed server-side are dropped here. Platform agents that were stuck disabled get auto-corrected.

3. Fetches MDS environments

For projects that have MDS connections configured server-side. Proxy-mode envs are recorded but not written into .mcp.json — agents reach those through the backend's MDS tools instead.

4. Regenerates the project's .mcp.json

The file in the project's working directory that tells Claude Code which MCP servers to connect to. Updated to match the current server state.

5. Cleans orphaned credentials

Any keychain entry for an agent that no longer exists on the server gets removed. Keeps your keychain tidy.

When to manually resync

• You added a new project on the dashboard and want to enable it here without waiting for the next Build Station restart.
• You added or removed an agent from a project's agent list, and the change isn't visible yet.
• You added an MDS environment to a project and want the agents to see it.
• You marked an agent as Platform on the dashboard and want it auto-enabled across all your projects here.
• You rotated an agent's API key server-side and want Build Station to fetch the new one.

How to resync

Two scopes:

• Full resync: Refreshes every project and agent in one go. Tray menu → Settings → Resync now. Or from the command palette: ⌘K → 'Resync'.

• Per-project resync: Just the project you're looking at. Open the project detail panel → click Resync. Useful when you know exactly what changed.

What you see when it runs

A small notification in the corner of the main window summarizes what changed:

0 projects removed, 1 agent added, 0 removed, 2 platforms re-enabled, 0 keys cleaned, 16 MCP refreshed

If nothing changed (everything is already in sync), all counts are zero. No notification.

Safety notes

• Resync never deletes your local settings. Working directories, enable toggles, per-agent concurrency limits — all preserved. Resync only reconciles the server-driven parts.
• In-flight tasks are not interrupted. Resync only affects new spawns.
• Agent re-enabling is conservative. Platform agents that have enabled: false locally get flipped to true (because Platform means "everywhere"). Non-platform agents that you manually disabled stay disabled — your explicit choice is respected.

Auto-resync on launch

Every launch of Build Station runs a full resync before the dispatcher starts listening. Most of the time, the only manual resync you'll do is after a change on the dashboard you want to see immediately. The auto-resync handles the rest.