Skip to content

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.

Rename the harness to Machine Monitor (#163)

Dee94f62a63707d
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index 97194744d..004a70f6c 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -797,8 +797,8 @@ class _SwarmScreenState extends State<SwarmScreen> {
case 'linkMachine':
await _dialog(() => showSwarmLinkDialog(context, app));
case 'manageMachines':
- // The Machines harness: the fleet managed by talking to it, with the
- // live map beside the terminal. Wrapped like Open Grid because the
+ // Machine Monitor: the fleet managed by talking to it, with the live
+ // map beside the terminal. Wrapped like Open Grid because the
// notifier opens New Harness here and the tab it makes takes focus.
await _dialog(() => app.manageMachines(context));
// BRIDGE, until the Machines menu goes: the old list, so nothing is lost
diff --git a/desktop/lib/shortcuts/keymap_commands.dart b/desktop/lib/shortcuts/keymap_commands.dart
index 9f23a981a..917587164 100644
--- a/desktop/lib/shortcuts/keymap_commands.dart
+++ b/desktop/lib/shortcuts/keymap_commands.dart
@@ -300,9 +300,10 @@ final harnessCommands = <HarnessCommand>[
action: ShortcutAction.newTerminal,
nativeAction: 'newTerminal',
),
+ // The id is a user's keybinding and does not move; the label is the app's name.
const HarnessCommand(
'machines.manage',
- 'Manage Machines',
+ 'Open Machine Monitor',
ShortcutGroup.actions,
nativeAction: 'manageMachines',
),
diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dart
index ba3c86207..340a61f5b 100644
--- a/desktop/lib/state/app_state.dart
+++ b/desktop/lib/state/app_state.dart
@@ -3988,11 +3988,12 @@ class AppNotifier extends ChangeNotifier {
await openStoreAgent(context, this, gridHarness, machineId);
}
- /// The Store harness the Machines menu opens: the fleet itself, managed by
- /// talking to it, with the live map of every machine beside the terminal.
- static const machinesHarness = 'autonomous/machines';
+ /// The Store harness the Machines menu opens: Machine Monitor, the fleet
+ /// itself, managed by talking to it, with the live map of every machine
+ /// beside the terminal.
+ static const machinesHarness = 'autonomous/machine-monitor';
- /// Open Machines, the same way [runLocalModel] opens Grid.
+ /// Open Machine Monitor, the same way [runLocalModel] opens Grid.
///
/// It belongs on THIS computer and nowhere else: everything it reads — the
/// machine list, each machine's roster — it reads through the local daemon,
@@ -4002,7 +4003,7 @@ class AppNotifier extends ChangeNotifier {
Future<void> manageMachines(BuildContext context) async {
final machine = _localModelMachine();
if (machine == null) {
- _lastError = 'Connect a machine before opening Machines.';
+ _lastError = 'Connect a machine before opening Machine Monitor.';
_lastErrorRetryable = false;
notifyListeners();
return;
diff --git a/desktop/lib/state/command_bar_catalog.dart b/desktop/lib/state/command_bar_catalog.dart
index 45424e629..e19021468 100644
--- a/desktop/lib/state/command_bar_catalog.dart
+++ b/desktop/lib/state/command_bar_catalog.dart
@@ -12,7 +12,7 @@ const commandBarCommands = {
'app.settings':
'Change preferences, appearance, account or connection settings.',
'machines.manage':
- 'Open Machines, the harness that links, names and retires your computers.',
+ 'Open Machine Monitor, the harness that links, names and retires your computers.',
'machines.list': 'See connected computers and their link state.',
'machine.link': 'Open the setup dialog to connect another computer.',
'swarm.new': 'Open a fresh empty tab.',
@@ -40,7 +40,7 @@ const _commandPhrases = {
'show settings',
'open preferences',
],
- 'machines.manage': ['manage machines', 'open machines'],
+ 'machines.manage': ['manage machines', 'open machine monitor'],
'machines.list': [
'show machines',
'machine list',
diff --git a/desktop/macos/Runner/SwarmTitlebar.swift b/desktop/macos/Runner/SwarmTitlebar.swift
index d14f7c3f0..f3c1c76ce 100644
--- a/desktop/macos/Runner/SwarmTitlebar.swift
+++ b/desktop/macos/Runner/SwarmTitlebar.swift
@@ -324,10 +324,10 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
$0.count.isEmpty ? $0.status : $0.count)
})
let trailingEdge = ceil((compactEdge + 62) * 1.2) - 62
- // Two doors for one release: the Machines harness, which manages the fleet by conversation and
- // draws it, and the plain list beneath it. The second is a bridge — it goes when this menu does,
- // along with machines_manager.dart and the "machineList" action.
- let manage = NSMenuItem(title: "Manage Machines…", action: #selector(menuAction(_:)), keyEquivalent: "")
+ // Two doors for one release: Machine Monitor, the harness that manages the fleet by conversation
+ // and draws it, and the plain list beneath it. The second is a bridge — it goes when this menu
+ // does, along with machines_manager.dart and the "machineList" action.
+ let manage = NSMenuItem(title: "Open Machine Monitor…", action: #selector(menuAction(_:)), keyEquivalent: "")
manage.target = self
manage.representedObject = "manageMachines"
manage.identifier = NSUserInterfaceItemIdentifier(HarnessKeymapMenu.actionPrefix + "manageMachines")
diff --git a/store/agents/machines/.gitignore b/store/agents/machine-monitor/.gitignore
similarity index 100%
rename from store/agents/machines/.gitignore
rename to store/agents/machine-monitor/.gitignore
diff --git a/store/agents/machines/AGENTS.md b/store/agents/machine-monitor/AGENTS.md
similarity index 97%
rename from store/agents/machines/AGENTS.md
rename to store/agents/machine-monitor/AGENTS.md
index 5363a1fd0..eb7784590 100644
--- a/store/agents/machines/AGENTS.md
+++ b/store/agents/machine-monitor/AGENTS.md
@@ -1,6 +1,6 @@
-# Machines agent
+# Machine Monitor agent
-These instructions apply in a **materialized Machines workspace** containing `machines.json`.
+These instructions apply in a **materialized Machine Monitor workspace** containing `machines.json`.
You look after the computers the person works on — one laptop, or a desk of machines and a rack in
a cupboard. They say what they want; you find the machine, do the one thing, and leave the map
beside you true. Say **machine** for a computer, **harness** for one running session on it, and
diff --git a/store/agents/machines/LICENSE b/store/agents/machine-monitor/LICENSE
similarity index 100%
rename from store/agents/machines/LICENSE
rename to store/agents/machine-monitor/LICENSE
diff --git a/store/agents/machines/README.md b/store/agents/machine-monitor/README.md
similarity index 87%
rename from store/agents/machines/README.md
rename to store/agents/machine-monitor/README.md
index 06191eb9b..a12094b1e 100644
--- a/store/agents/machines/README.md
+++ b/store/agents/machine-monitor/README.md
@@ -1,4 +1,4 @@
-# Machines, as a Harness agent
+# Machine Monitor, as a Harness agent
Your computers, managed by talking. Ask for a machine to be linked, renamed, grouped, noted or
retired; ask what any of them is carrying; ask how to bring a new one in. Beside the conversation,
@@ -12,14 +12,14 @@ computer. This package never holds a token, a key or a password.
## Install and open
-Choose **Machines** in the Harness Store, or install this checkout:
+Choose **Machine Monitor** in the Harness Store, or install this checkout:
```sh
-harness dsh install "$PWD/store/agents/machines" --link
-harness dsh doctor autonomous/machines
+harness dsh install "$PWD/store/agents/machine-monitor" --link
+harness dsh doctor autonomous/machine-monitor
```
-Open Machines in a new workspace and ask: "Show me my machines, and link the one that needs it."
+Open Machine Monitor in a new workspace and ask: "Show me my machines, and link the one that needs it."
## What it can do
@@ -66,17 +66,17 @@ lives in a transcript, and this one never needs to.
## Develop and verify
```sh
-npm test --prefix store/agents/machines
-harness dsh check "$PWD/store/agents/machines"
+npm test --prefix store/agents/machine-monitor
+harness dsh check "$PWD/store/agents/machine-monitor"
node store/tools/catalog.mjs
# The pane against a workspace; the chosen port is printed.
-HARNESS_WORKSPACE=/path/to/workspace store/agents/machines/viewer.sh
+HARNESS_WORKSPACE=/path/to/workspace store/agents/machine-monitor/viewer.sh
```
The tests run without a daemon: the collector's reads and the machine bridge are both injectable,
so a whole fleet — linked, unlinked, offline, shared, failing — is exercised from fixtures. What
-they do not cover is a real relayed dial to another computer; `harness dsh doctor autonomous/machines`
+they do not cover is a real relayed dial to another computer; `harness dsh doctor autonomous/machine-monitor`
on a machine with peers is the check for that.
## Credit and stewardship
diff --git a/store/agents/machines/harness.json b/store/agents/machine-monitor/harness.json
similarity index 82%
rename from store/agents/machines/harness.json
rename to store/agents/machine-monitor/harness.json
index 3327ffe6d..08ae9387b 100644
--- a/store/agents/machines/harness.json
+++ b/store/agents/machine-monitor/harness.json
@@ -1,9 +1,12 @@
{
"spec": 1,
- "id": "autonomous/machines",
- "name": "Machines",
+ "id": "autonomous/machine-monitor",
+ "name": "Machine Monitor",
"category": "Compute",
"author": "Autonomous",
+ "formerly": [
+ "autonomous/machines"
+ ],
"description": "Talk to your fleet of computers. Link one, name it, retire it — and watch every machine, project and harness you own come alive on one map.",
"engine": "claude",
"workspace": {
@@ -13,7 +16,9 @@
},
"agent": {
"instructions": "AGENTS.md",
- "skills": ["skills"],
+ "skills": [
+ "skills"
+ ],
"env": {
"MACHINES_CLI": "${dsh}/toolchain/machines"
}
diff --git a/store/agents/machines/lib/daemon.mjs b/store/agents/machine-monitor/lib/daemon.mjs
similarity index 100%
rename from store/agents/machines/lib/daemon.mjs
rename to store/agents/machine-monitor/lib/daemon.mjs
diff --git a/store/agents/machines/lib/fleet.mjs b/store/agents/machine-monitor/lib/fleet.mjs
similarity index 100%
rename from store/agents/machines/lib/fleet.mjs
rename to store/agents/machine-monitor/lib/fleet.mjs
diff --git a/store/agents/machines/lib/ops.mjs b/store/agents/machine-monitor/lib/ops.mjs
similarity index 100%
rename from store/agents/machines/lib/ops.mjs
rename to store/agents/machine-monitor/lib/ops.mjs
diff --git a/store/agents/machines/lib/snapshot.mjs b/store/agents/machine-monitor/lib/snapshot.mjs
similarity index 100%
rename from store/agents/machines/lib/snapshot.mjs
rename to store/agents/machine-monitor/lib/snapshot.mjs
diff --git a/store/agents/machines/package.json b/store/agents/machine-monitor/package.json
similarity index 62%
rename from store/agents/machines/package.json
rename to store/agents/machine-monitor/package.json
index 679ceb787..abeda7c13 100644
--- a/store/agents/machines/package.json
+++ b/store/agents/machine-monitor/package.json
@@ -1,10 +1,12 @@
{
- "name": "@autonomous/machines-harness",
+ "name": "@autonomous/machine-monitor",
"private": true,
"type": "module",
"scripts": {
"test": "node --test test/*.test.mjs",
"start": "./viewer.sh"
},
- "engines": { "node": ">=22" }
+ "engines": {
+ "node": ">=22"
+ }
}
diff --git a/store/agents/machines/skills/fleet-operations/SKILL.md b/store/agents/machine-monitor/skills/fleet-operations/SKILL.md
similarity index 96%
rename from store/agents/machines/skills/fleet-operations/SKILL.md
rename to store/agents/machine-monitor/skills/fleet-operations/SKILL.md
index 0b6c15bd0..b5f187cb2 100644
--- a/store/agents/machines/skills/fleet-operations/SKILL.md
+++ b/store/agents/machine-monitor/skills/fleet-operations/SKILL.md
@@ -1,6 +1,6 @@
---
name: fleet-operations
-description: Manage the machines on a Harness account by conversation — read the fleet, link and unlink, rename, note and group, bring a new computer in, remove one. Use in a Machines workspace whenever the person asks about their computers, what is running on them, or wants one added, named, linked or retired.
+description: Manage the machines on a Harness account by conversation — read the fleet, link and unlink, rename, note and group, bring a new computer in, remove one. Use in a Machine Monitor workspace whenever the person asks about their computers, what is running on them, or wants one added, named, linked or retired.
---
# Fleet operations
diff --git a/store/agents/machines/skills/fleet-operations/references/reading-the-pane.md b/store/agents/machine-monitor/skills/fleet-operations/references/reading-the-pane.md
similarity index 100%
rename from store/agents/machines/skills/fleet-operations/references/reading-the-pane.md
rename to store/agents/machine-monitor/skills/fleet-operations/references/reading-the-pane.md
diff --git a/store/agents/machines/store.json b/store/agents/machine-monitor/store.json
similarity index 100%
rename from store/agents/machines/store.json
rename to store/agents/machine-monitor/store.json
diff --git a/store/agents/machines/template/machines.json b/store/agents/machine-monitor/template/machines.json
similarity index 100%
rename from store/agents/machines/template/machines.json
rename to store/agents/machine-monitor/template/machines.json
diff --git a/store/agents/machines/test/daemon.test.mjs b/store/agents/machine-monitor/test/daemon.test.mjs
similarity index 100%
rename from store/agents/machines/test/daemon.test.mjs
rename to store/agents/machine-monitor/test/daemon.test.mjs
diff --git a/store/agents/machines/test/fixtures.mjs b/store/agents/machine-monitor/test/fixtures.mjs
similarity index 100%
rename from store/agents/machines/test/fixtures.mjs
rename to store/agents/machine-monitor/test/fixtures.mjs
diff --git a/store/agents/machines/test/fleet.test.mjs b/store/agents/machine-monitor/test/fleet.test.mjs
similarity index 100%
rename from store/agents/machines/test/fleet.test.mjs
rename to store/agents/machine-monitor/test/fleet.test.mjs
diff --git a/store/agents/machines/test/ops.test.mjs b/store/agents/machine-monitor/test/ops.test.mjs
similarity index 100%
rename from store/agents/machines/test/ops.test.mjs
rename to store/agents/machine-monitor/test/ops.test.mjs
diff --git a/store/agents/machines/test/server.test.mjs b/store/agents/machine-monitor/test/server.test.mjs
similarity index 99%
rename from store/agents/machines/test/server.test.mjs
rename to store/agents/machine-monitor/test/server.test.mjs
index 43d49a6bc..872ffd3f9 100644
--- a/store/agents/machines/test/server.test.mjs
+++ b/store/agents/machine-monitor/test/server.test.mjs
@@ -33,7 +33,7 @@ test('the pane serves its own observation and its three files', async () => {
const page = await fetch(`${base}/`);
assert.equal(page.status, 200);
assert.match(page.headers.get('content-security-policy'), /default-src 'self'/);
- assert.match(await page.text(), /<title>Machines/);
+ assert.match(await page.text(), /<title>Machine Monitor/);
for (const path of ['/app.js', '/app.css']) assert.equal((await fetch(`${base}${path}`)).status, 200);
assert.equal((await fetch(`${base}/../lib/daemon.mjs`)).status, 404);
diff --git a/store/agents/machines/test/snapshot.test.mjs b/store/agents/machine-monitor/test/snapshot.test.mjs
similarity index 100%
rename from store/agents/machines/test/snapshot.test.mjs
rename to store/agents/machine-monitor/test/snapshot.test.mjs
diff --git a/store/agents/machines/toolchain/doctor.sh b/store/agents/machine-monitor/toolchain/doctor.sh
similarity index 100%
rename from store/agents/machines/toolchain/doctor.sh
rename to store/agents/machine-monitor/toolchain/doctor.sh
diff --git a/store/agents/machines/toolchain/init-workspace.sh b/store/agents/machine-monitor/toolchain/init-workspace.sh
similarity index 100%
rename from store/agents/machines/toolchain/init-workspace.sh
rename to store/agents/machine-monitor/toolchain/init-workspace.sh
diff --git a/store/agents/machines/toolchain/machines b/store/agents/machine-monitor/toolchain/machines
similarity index 100%
rename from store/agents/machines/toolchain/machines
rename to store/agents/machine-monitor/toolchain/machines
diff --git a/store/agents/machines/toolchain/machines.mjs b/store/agents/machine-monitor/toolchain/machines.mjs
similarity index 100%
rename from store/agents/machines/toolchain/machines.mjs
rename to store/agents/machine-monitor/toolchain/machines.mjs
diff --git a/store/agents/machines/toolchain/runtimes.sh b/store/agents/machine-monitor/toolchain/runtimes.sh
similarity index 100%
rename from store/agents/machines/toolchain/runtimes.sh
rename to store/agents/machine-monitor/toolchain/runtimes.sh
diff --git a/store/agents/machines/toolchain/setup.sh b/store/agents/machine-monitor/toolchain/setup.sh
similarity index 100%
rename from store/agents/machines/toolchain/setup.sh
rename to store/agents/machine-monitor/toolchain/setup.sh
diff --git a/store/agents/machines/viewer.mjs b/store/agents/machine-monitor/viewer.mjs
similarity index 98%
rename from store/agents/machines/viewer.mjs
rename to store/agents/machine-monitor/viewer.mjs
index bc999b7b2..55eab0d99 100644
--- a/store/agents/machines/viewer.mjs
+++ b/store/agents/machine-monitor/viewer.mjs
@@ -81,7 +81,7 @@ export function createViewer({ workspace, port = 0, intervalMs = 15_000, collect
}
if (!['GET', 'HEAD'].includes(req.method)) {
res.setHeader('allow', 'GET, HEAD, POST');
- json(res, 405, { error: 'This pane is read-only. Ask the Machines agent to change something.' });
+ json(res, 405, { error: 'This pane is read-only. Ask the Machine Monitor agent to change something.' });
return;
}
if (url.pathname === '/health') { json(res, 200, { ok: true }); return; }
@@ -173,7 +173,7 @@ if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1]
const port = Number(process.env.HARNESS_VIEWER_PORT || 0);
if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error('HARNESS_VIEWER_PORT must be a port number.');
const viewer = createViewer({ workspace, port });
- console.log(`[machines] http://127.0.0.1:${await viewer.start()}/`);
+ console.log(`[machine-monitor] http://127.0.0.1:${await viewer.start()}/`);
const close = () => viewer.close().then(() => process.exit(0));
process.once('SIGINT', close); process.once('SIGTERM', close);
}
diff --git a/store/agents/machines/viewer.sh b/store/agents/machine-monitor/viewer.sh
similarity index 100%
rename from store/agents/machines/viewer.sh
rename to store/agents/machine-monitor/viewer.sh
diff --git a/store/agents/machines/viewer/app.css b/store/agents/machine-monitor/viewer/app.css
similarity index 100%
rename from store/agents/machines/viewer/app.css
rename to store/agents/machine-monitor/viewer/app.css
diff --git a/store/agents/machines/viewer/app.js b/store/agents/machine-monitor/viewer/app.js
similarity index 100%
rename from store/agents/machines/viewer/app.js
rename to store/agents/machine-monitor/viewer/app.js
diff --git a/store/agents/machines/viewer/index.html b/store/agents/machine-monitor/viewer/index.html
similarity index 98%
rename from store/agents/machines/viewer/index.html
rename to store/agents/machine-monitor/viewer/index.html
index f4796e6c3..cc737376f 100644
--- a/store/agents/machines/viewer/index.html
+++ b/store/agents/machine-monitor/viewer/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="color-scheme" content="light dark">
- <title>Machines · Your computers</title>
+ <title>Machine Monitor · Your computers</title>
<link rel="stylesheet" href="app.css">
<script src="app.js" defer></script>
</head>