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 { mkdirSync, mkdtempSync, rmSync, symlinkSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it } from 'vitest'
import { buildHarnessSessionLabel, harnessPaneOwner, isHarnessSessionFor, ownedHere, ownerCommand, paneOwnerFormat, paneOwnerOf } from './harnessSessionLabel.js'
import { isolatedTmux } from '../testing/isolatedTmux.js'
const dirs: string[] = []
afterEach(() => { for (const dir of dirs.splice(0)) rmSync(dir, { recursive: true, force: true }) })
describe('panes created in the same millisecond', () => {
it('allocates distinct names for the same engine and keeps discovery recognition', () => {
const now = 1_700_000_000_000
const names = Array.from({ length: 128 }, () => buildHarnessSessionLabel('claude', now))
expect(new Set(names).size).toBe(names.length)
for (const name of names) {
expect(name).toMatch(/^harness-claude-1700000000000-/)
expect(name).toMatch(/^[A-Za-z0-9_-]+$/)
expect(isHarnessSessionFor(name, 'claude')).toBe(true)
expect(isHarnessSessionFor(name, 'codex')).toBe(false)
}
})
it('starts two real private panes concurrently with names allocated at the identical clock value', async () => {
const home = mkdtempSync(join(tmpdir(), 'pane-label-'))
dirs.push(home)
const tmux = await isolatedTmux({ ...process.env, HOME: home, ZDOTDIR: home, HISTFILE: join(home, 'history') })
try {
// Start the disposable server first: this tests name allocation, not a tmux startup race.
await tmux.run('new-session', '-d', '-s', 'fixture-bootstrap', '/bin/sh', '-c', 'sleep 60')
const names = Array.from({ length: 2 }, () => buildHarnessSessionLabel('codex', 1_700_000_000_000))
const panes = await Promise.all(names.map(name => tmux.run('new-session', '-d', '-P', '-F', '#{pane_id}',
'-s', name, '/bin/sh', '-c', 'sleep 60')))
expect(new Set(panes).size).toBe(2)
const sessions = (await tmux.run('list-sessions', '-F', '#{session_name}')).split('\n')
for (const name of names) expect(sessions).toContain(name)
} finally { await tmux.close() }
})
})
describe('which daemon a pane belongs to', () => {
it('is one tag per data folder: the same for one daemon every time, another for a daemon beside it', () => {
const root = mkdtempSync(join(tmpdir(), 'pane-owner-'))
dirs.push(root)
const release = join(root, 'release')
const dev = join(root, 'dev')
mkdirSync(release)
mkdirSync(dev)
expect(harnessPaneOwner(release)).toMatch(/^[0-9a-f]{16}$/)
expect(harnessPaneOwner(release)).toBe(harnessPaneOwner(`${release}/`))
expect(harnessPaneOwner(dev)).not.toBe(harnessPaneOwner(release))
})
it('is the same before the data folder exists as after, and through a symlink to it', () => {
// A first start computes it before anything creates the folder; macOS's temporary folders sit
// behind a symlink (`/var` is `/private/var`). A tag that changed between the two would hide a
// daemon's own panes from it after its first restart.
const root = mkdtempSync(join(tmpdir(), 'pane-owner-'))
dirs.push(root)
const data = join(root, 'later', 'data')
const before = harnessPaneOwner(data)
mkdirSync(data, { recursive: true })
expect(harnessPaneOwner(data)).toBe(before)
const link = join(root, 'link')
symlinkSync(join(root, 'later'), link)
expect(harnessPaneOwner(join(link, 'data'))).toBe(before)
expect(harnessPaneOwner(join(link, 'data', 'not-yet'))).toBe(harnessPaneOwner(join(data, 'not-yet')))
})
it('lets a daemon see the panes it tagged wherever they moved, untagged ones only in its sessions, never another daemon\'s', () => {
expect(ownedHere('aaaa', 'harness-claude-1', 'aaaa')).toBe(true)
// The person renamed its session, or joined the pane into a window of their own: still its pane.
expect(ownedHere('aaaa', 'my-claude-work', 'aaaa')).toBe(true)
// Created by a build from before the tag: in a session Harness named, as every pane used to be; never
// in a session the person opened by hand (autonomous-harness-desktop#6).
expect(ownedHere('', 'harness-codex-2', 'aaaa')).toBe(true)
expect(ownedHere('', 'my-shell', 'aaaa')).toBe(false)
// Another daemon's, in whatever session.
expect(ownedHere('bbbb', 'harness-claude-1', 'aaaa')).toBe(false)
expect(ownedHere('bbbb', 'my-claude-work', 'aaaa')).toBe(false)
})
})
// tmux before 3.0 (Debian 10's 2.8, RHEL 8's 2.7) has no pane options, and a window option stays behind
// with its window when the person moves the pane. The pane's start command goes with it.
describe('the tag on a tmux before 3.0', () => {
it('rides the start command through env, which execs the real command at once', () => {
expect(ownerCommand('0123456789abcdef', ['/bin/zsh', '-lic', 'exec "$@"', 'claude']))
.toEqual(['/usr/bin/env', 'HARNESS_DAEMON=0123456789abcdef', '/bin/zsh', '-lic', 'exec "$@"', 'claude'])
})
it('is read from the pane option where there is one, and from the start command then the window before', () => {
expect(paneOwnerFormat(true)).toBe('#{@harness_daemon}')
// tmux 2.x cannot cut a substring out of a format: the start command comes back cut to the prefix
// and a tag's length, never whole (it can hold the `|` and newlines a listing is split on).
expect(paneOwnerFormat(false))
.toBe('#{?#{m:/usr/bin/env HARNESS_DAEMON=*,#{pane_start_command}},#{=44:pane_start_command},#{?#{m:harness-*,#{session_name}},#{@harness_daemon},}}')
})
it('reads the window\'s tag only in a session Harness named, on a real tmux', async () => {
// A pane the person split into an agent's window, once they had moved that window into their own
// session, carries no tag of its own: the window's was taken for it, and it was styled as an agent.
const home = mkdtempSync(join(tmpdir(), 'pane-owner-home-'))
dirs.push(home)
const tmux = await isolatedTmux({ ...process.env, HOME: home, ZDOTDIR: home, HISTFILE: join(home, 'history') })
try {
const tag = '0123456789abcdef'
await tmux.run('new-session', '-d', '-s', 'harness-claude-1', '-x', '80', '-y', '24')
await tmux.run('set-option', '-w', '-t', 'harness-claude-1', '@harness_daemon', tag)
await tmux.run('new-session', '-d', '-s', 'mine', '-x', '80', '-y', '24')
await tmux.run('move-window', '-s', 'harness-claude-1:0', '-t', 'mine:5')
await tmux.run('new-session', '-d', '-s', 'harness-codex-2', '-x', '80', '-y', '24')
await tmux.run('set-option', '-w', '-t', 'harness-codex-2', '@harness_daemon', tag)
const owners = (await tmux.run('list-panes', '-a', '-F', `#{session_name}|${paneOwnerFormat(false)}`)).split('\n')
expect(owners.sort()).toEqual(['harness-codex-2|0123456789abcdef', 'mine|', 'mine|'])
} finally {
await tmux.close()
}
})
it('takes the tag out of a start command, and any other field as the tag itself', () => {
expect(paneOwnerOf('/usr/bin/env HARNESS_DAEMON=0123456789abcdef')).toBe('0123456789abcdef')
// The window's tag, a pane option, or nobody's.
expect(paneOwnerOf('0123456789abcdef')).toBe('0123456789abcdef')
expect(paneOwnerOf('')).toBe('')
})
})