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
A harness answers to the ids it went by: formerly
deecf2d7d4011cf
diff --git a/cli/src/dsh/installed.ts b/cli/src/dsh/installed.tsindex 08b8ebcf3..8831f11f8 100644--- a/cli/src/dsh/installed.ts+++ b/cli/src/dsh/installed.ts@@ -147,6 +147,13 @@ export function listDshState(): { installed: InstalledDsh[]; broken: BrokenDsh[]return stateNow()}+/**+ * The installed harness for an id — by its own id first, then by a name it went by before+ * (`formerly` in the manifest): an agent created under the old name keeps its harness, its viewer+ * and its verdict across a rename instead of falling back to a plain engine.+ */export function installedDsh(id: string): InstalledDsh | undefined {- return stateNow().installed.find((entry) => entry.id === id)+ const { installed } = stateNow()+ return installed.find((entry) => entry.id === id)+ ?? installed.find((entry) => entry.manifest.formerly?.includes(id))}diff --git a/cli/src/dsh/manifest.spec.ts b/cli/src/dsh/manifest.spec.tsindex dc68aed26..a98c29fd9 100644--- a/cli/src/dsh/manifest.spec.ts+++ b/cli/src/dsh/manifest.spec.ts@@ -1,7 +1,7 @@import { describe, expect, it } from 'vitest'import { readFileSync } from 'node:fs'import { fileURLToPath } from 'node:url'-import { dshSkillsDirFor, dshTier, dshVerdictPath, expandDshValue, parseDshManifest, readDshManifest } from './manifest.js'+import { DshManifestSchema, dshSkillsDirFor, dshTier, dshVerdictPath, expandDshValue, parseDshManifest, readDshManifest } from './manifest.js'const STARTER = fileURLToPath(new URL('../../../dsh/starter-dsh', import.meta.url))@@ -67,4 +67,11 @@ describe('dshSkillsDirFor', () => {expect(dshSkillsDirFor('codex')).toBe('.agents/skills')expect(dshSkillsDirFor('cursor')).toBe('.agents/skills')})+ it('accepts the ids a harness went by before, and only well-formed ones', () => {+ const base = { spec: 1, id: 'acme/solid', name: 'Solid', engine: 'codex' }+ expect(DshManifestSchema.safeParse({ ...base, formerly: ['acme/workshop'] }).success).toBe(true)+ expect(DshManifestSchema.safeParse({ ...base, formerly: ['Not An Id'] }).success).toBe(false)+ expect(DshManifestSchema.safeParse({ ...base, formerly: Array(9).fill('acme/x') }).success).toBe(false)+ })+})diff --git a/cli/src/dsh/manifest.ts b/cli/src/dsh/manifest.tsindex 3fad5416e..7c3eb9c6c 100644--- a/cli/src/dsh/manifest.ts+++ b/cli/src/dsh/manifest.ts@@ -36,6 +36,8 @@ export const DshManifestSchema = z.strictObject({description: z.string().max(300).optional(),/** The one- or two-word kind of thing it makes — "PCB", "3D design", "Slides" — the picker's second line. */category: z.string().min(1).max(24).optional(),+ /** Ids this harness answered to before: an agent created under one keeps its harness across a rename. */+ formerly: z.array(z.string().regex(DSH_ID_RE)).max(8).optional(),engine: z.enum(ENGINES),workspace: z.strictObject({template: relativePath.optional(),diff --git a/dsh/spec/CHANGES.md b/dsh/spec/CHANGES.mdindex 968322117..e663e07ae 100644--- a/dsh/spec/CHANGES.md+++ b/dsh/spec/CHANGES.md@@ -20,6 +20,7 @@ Initial contract. Lifted from the `.board.json` (Circuit) and `.episode.json` (Tin a word or two — "PCB", "3D design", "Slides". `dsh_list` forwards it; the picker shows it underthe name, the way every engine now shows "Code". The first-party ids are `autonomous/copper`(Circuit's pipeline) and `autonomous/solid` (Workshop's Make stage); `autonomous/marp` is unchanged.-- **Backward compatible:** `category` is optional. The old ids are not aliased: an agent created as- `autonomous/circuit` or `autonomous/workshop` before this change draws by its name and loses its- viewer on the next daemon start.+- **Backward compatible:** `category` is optional. Manifests may list the ids they went by in+ `formerly` (≤ 8); the daemon resolves an agent's `HARNESS_DSH` through it, so an agent created as+ `autonomous/circuit` or `autonomous/workshop` keeps its harness, viewer and verdict after the+ rename. Without it, such an agent draws by its name and runs as its plain engine.diff --git a/dsh/spec/schema/harness.schema.json b/dsh/spec/schema/harness.schema.jsonindex 22ada8c0b..bbcbb1495 100644--- a/dsh/spec/schema/harness.schema.json+++ b/dsh/spec/schema/harness.schema.json@@ -35,6 +35,15 @@"maxLength": 24,"description": "The kind of thing it makes, in a word or two \u2014 PCB, 3D design, Slides. The picker's second line under the name."},+ "formerly": {+ "type": "array",+ "maxItems": 8,+ "items": {+ "type": "string",+ "pattern": "^[a-z0-9-]+/[a-z0-9-]+$"+ },+ "description": "Ids this harness answered to before. An agent created under one keeps its harness across a rename."+ },"engine": {"type": "string","description": "The base engine this harness runs on: claude, codex, cursor, \u2026 (one of the CLI's ENGINES)."