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 { execFile } from 'node:child_process'
import { mkdir, mkdtemp, realpath, rm } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { promisify } from 'node:util'
import { resolveBinaryOnPath } from '../lib/binaryOnPath.js'
const exec = promisify(execFile)
/** Bare tmux calls in the backend under test must use the same private server as the fixture.
* TMUX outranks TMUX_TMPDIR, so changing only the latter still reaches the developer's server.
* Cleanup always names the captured socket, even after the caller restores its environment. */
export async function isolatedTmux(inherited: NodeJS.ProcessEnv = process.env) {
const binary = resolveBinaryOnPath('tmux')
if (!binary) throw new Error('tmux is required for this test')
const root = await realpath(await mkdtemp(join(tmpdir(), 'htmux-')))
const env: NodeJS.ProcessEnv = { ...inherited, TMUX_TMPDIR: root }
delete env.TMUX
delete env.TMUX_PANE
const socketDirectory = join(root, `tmux-${process.getuid!()}`)
await mkdir(socketDirectory, { mode: 0o700 })
const socket = join(socketDirectory, 'default')
const run = async (...args: string[]) =>
(await exec(binary, ['-S', socket, '-f', '/dev/null', ...args], { env, timeout: 5_000 })).stdout.trim()
return {
root,
socket,
env,
run,
async close() {
await run('kill-server').catch(() => { /* this disposable server may already have exited */ })
// kill-server returns before its panes have exited, and a zsh among them writes its history as
// it goes (macOS's /etc/zshrc sets HISTFILE): the folder filled up under the removal, and a
// passing tmuxmoves.e2e.ts test failed in its teardown with ENOTEMPTY. Asked again, it is empty.
await rm(root, { recursive: true, force: true, maxRetries: 10, retryDelay: 50 })
},
}
}
export type IsolatedTmux = Awaited<ReturnType<typeof isolatedTmux>>