The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
import 'terminal_pane.dart';
/// A named arrangement of agents. Membership never owns the agent process.
/// Shared agents reuse the same pane/session across swarms, so the daemon has
/// exactly one controller and switching tabs cannot take over our own stream.
class Swarm {
Swarm({required this.id, String name = defaultName})
: name = normalizeName(name);
static String normalizeName(String name) =>
const {
'New swarm',
'New tab',
'New Tab',
'New Harness',
'New Agent',
'Untitled Tab',
}.contains(name)
? defaultName
: name;
/// What an untouched swarm is called, matching the desktop
/// (`desktop/lib/state/swarm.dart`).
///
/// ⚠️ **"New Harness" is in the legacy set above, not here, and the two are
/// not the same thing.** A *harness* is one running agent session — what the
/// desktop's menus stop, fork and rename. A *swarm* groups harnesses. The
/// default was 'New Harness' until 2026-09-15, which read as though opening a
/// tab opened an agent; a layout saved then still carries the name, and it
/// has to come back as the same fresh tab.
static const defaultName = 'New Swarm';
final String id;
String name;
final List<TerminalPane> panes = [];
int? focusedPaneId;
int? zoomedPaneId;
int? previousPaneId;
final Map<int, int> pinnedSlots = {};
bool get isEmptyStarter => name == defaultName && panes.isEmpty;
void remove(TerminalPane pane) {
final index = panes.indexOf(pane);
if (index < 0) return;
panes.removeAt(index);
pinnedSlots.remove(pane.id);
if (focusedPaneId == pane.id) {
focusedPaneId = panes.isEmpty
? null
: panes[index.clamp(0, panes.length - 1)].id;
}
if (zoomedPaneId == pane.id) zoomedPaneId = null;
if (previousPaneId == pane.id) previousPaneId = null;
}
Map<String, Object?> toJson() {
// Warm tiles are the pager's guesses, not the person's layout — see
// [TerminalPane.warm]. Saved, a relaunch would open every one of them as a
// stream before the agent the person was actually reading.
final agents = panes
.where((p) => p.agentId != null && !p.warm)
.toList(growable: false);
return {
'id': id,
'name': name,
'focus': agents.indexWhere((p) => p.id == focusedPaneId),
'previousFocus': agents.indexWhere((p) => p.id == previousPaneId),
'zoom': agents.indexWhere((p) => p.id == zoomedPaneId),
'panes': [
for (final p in agents)
PaneLayoutEntry(
machineId: p.machineId,
agentId: p.agentId!,
pinnedSlot: pinnedSlots[p.id],
).toJson(),
],
};
}
}
/// Session-free history: closing a view never owns the agent's lifetime.
sealed class ClosedWork {
const ClosedWork({required this.historyId});
final String historyId;
}
class ClosedAgent extends ClosedWork {
ClosedAgent(
TerminalPane pane,
Swarm swarm, {
required super.historyId,
required this.name,
required this.machineName,
required this.engine,
}) : swarmId = swarm.id,
swarmName = swarm.name,
index = swarm.panes.indexOf(pane),
machineId = pane.machineId,
agentId = pane.agentId!,
pinnedSlot = swarm.pinnedSlots[pane.id],
zoomed = swarm.zoomedPaneId == pane.id;
final String swarmId, swarmName, machineId, machineName, agentId, name;
final String? engine;
final int index;
final bool zoomed;
final int? pinnedSlot;
}
/// Terminal buffers and controllers are released normally; a reopened view
/// reuses any live peer.
class ClosedSwarm extends ClosedWork {
ClosedSwarm(
Swarm swarm, {
required super.historyId,
required this.index,
Swarm? replacement,
this.engine,
}) : id = swarm.id,
name = swarm.name,
focus = swarm.panes.indexWhere((p) => p.id == swarm.focusedPaneId),
previousFocus = swarm.panes.indexWhere(
(p) => p.id == swarm.previousPaneId,
),
zoom = swarm.panes.indexWhere((p) => p.id == swarm.zoomedPaneId),
panes = List.unmodifiable([
for (final pane in swarm.panes)
(
machineId: pane.machineId,
agentId: pane.agentId,
pinnedSlot: swarm.pinnedSlots[pane.id],
),
]),
replacementId = replacement?.id;
final String id;
final String name;
final String? engine;
final int index;
final int focus;
final int previousFocus;
final int zoom;
final List<({String machineId, String? agentId, int? pinnedSlot})> panes;
final String? replacementId;
bool replacesUntouchedWelcome(Swarm swarm) =>
swarm.id == replacementId &&
swarm.name == Swarm.defaultName &&
swarm.panes.isEmpty;
}