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
/**
* `harness tui` — Harness in a terminal. The TUI itself is a native binary (`tui/` at the repo root,
* Rust); this is only how the CLI finds it and hands it the terminal. It is a client of the same
* daemon the desktop app talks to, so there is nothing to configure: the machines, the relay and
* the desk are the daemon's.
*
* Where the binary comes from, first hit wins:
* 1. `HARNESS_TUI_BIN`
* 2. `~/.harness/bin/harness-tui` — what `harness tui --install` downloads (checksum-verified)
* 3. a dev checkout: `tui/target/{release,debug}/harness-tui` beside this CLI's source
* 4. `harness-tui` on PATH
*/
import { spawnSync } from 'node:child_process'
import { existsSync } from 'node:fs'
import { dirname, resolve } from 'node:path'
import { homedir } from 'node:os'
import { fileURLToPath } from 'node:url'
import { installedTuiPath, installTui } from './install.js'
import { installManagedTui } from './manage.js'
import { localDaemonStatus } from '../lib/daemonEndpoint.js'
import { payloadFile } from '../lib/windows/payloadFile.js'
export { installTui, platformKey, TUI_MANIFEST_URL } from './install.js'
export function findTuiBinary(platform: NodeJS.Platform = process.platform): string | null {
const fromEnv = process.env.HARNESS_TUI_BIN
if (fromEnv && existsSync(fromEnv)) return fromEnv
// On Windows hn is one of the signed programs in the payload, updated with it.
if (platform === 'win32') return payloadFile('harness-tui.exe')
if (existsSync(installedTuiPath())) return installedTuiPath()
try {
const here = dirname(fileURLToPath(import.meta.url))
for (const up of ['../../../tui', '../../tui', '../tui']) {
for (const profile of ['release', 'debug']) {
const candidate = resolve(here, up, 'target', profile, 'harness-tui')
if (existsSync(candidate)) return candidate
}
}
} catch { /* bundled without a file URL */ }
const which = spawnSync('sh', ['-c', 'command -v harness-tui'], { encoding: 'utf8' })
const onPath = which.stdout?.trim()
return which.status === 0 && onPath ? onPath : null
}
/** Read only the global flags needed for bootstrap; hn validates the full command line. */
function clientPort(argv: string[], fallback: number): number | null {
let port = fallback
for (let i = 0; i < argv.length; i++) {
const a = argv[i]
if (a === '--') return i + 1 >= argv.length ? port : null
if (!a.startsWith('-') || a === '-') return null
if (a === '--port') {
const value = argv[++i]
if (!value || !/^\+?\d+$/.test(value) || Number(value) > 65535 || Number(value) === 0) return null
port = Number(value)
continue
}
if (a.startsWith('--')) return null
const flags = a.slice(1)
for (let j = 0; j < flags.length; j++) {
// Help, shell commands, control mode and invalid flags need no daemon.
if ('hVCc'.includes(flags[j])) return null
if ('fLST'.includes(flags[j])) {
if (j + 1 === flags.length && argv[++i] === undefined) return null
break
}
if (!'2ulvND'.includes(flags[j])) return null
}
}
return port
}
/** Only opening the default client bootstraps Harness; scripts and information commands do not. */
export function opensClient(argv: string[]): boolean {
return clientPort(argv, 1) !== null
}
async function daemonUp(port: number, dataDir: string, identity?: () => string): Promise<boolean> {
const status = await localDaemonStatus(dataDir, port)
return typeof status?.machineId === 'string' && status.machineId.length > 0
&& (!identity || status.machineId === identity())
}
/** Start this user's local service. Signing in is a separate, explicit action. */
function runSelf(args: string[], port: number, dataDir: string): number {
const script = process.argv[1]
const result = spawnSync(process.execPath, [...process.execArgv, ...(script ? [script] : []), ...args], { stdio: 'inherit', env: { ...process.env, PORT: String(port), ADAPTER_DATA_DIR: dataDir, HARNESS_SELF: '1' } })
return result.status ?? 1
}
/**
* Local use requires no account. Start the local daemon if needed, whether signed in or out.
* Readiness is checked through this user's private socket; another user's TCP listener is irrelevant.
*/
async function ensureDaemon(port: number, dataDir: string, identity?: () => string): Promise<boolean> {
if (await daemonUp(port, dataDir, identity)) return true
console.log(' Starting the Harness daemon…')
if (runSelf(['start'], port, dataDir) !== 0) return false
for (let i = 0; i < 60; i++) {
if (await daemonUp(port, dataDir, identity)) return true
await new Promise((resolve) => setTimeout(resolve, 250))
}
console.error(' ✗ The Harness daemon did not come up. See `harness status`.')
return false
}
/** A Windows install whose payload predates hn. */
export const TUI_NOT_IN_PAYLOAD = 'This Harness has no terminal app (hn) yet. Update Harness with: harness update'
export async function tuiCommand(
argv: string[],
opts: { port: number; dataDir?: string; identity?: () => string; platform?: NodeJS.Platform; find?: () => string | null },
): Promise<number> {
const windows = (opts.platform ?? process.platform) === 'win32'
const find = opts.find ?? (() => findTuiBinary(opts.platform))
if (argv[0] === '--where') { console.log(find() ?? (windows ? `(${TUI_NOT_IN_PAYLOAD})` : '(not installed)')); return 0 }
if (windows && !find()) { console.error(` ✗ ${TUI_NOT_IN_PAYLOAD}`); return 1 }
// It came with the payload: there is nothing to install, and nothing else to run on Windows.
if (windows && (argv[0] === '--install' || argv[0] === 'install')) { console.log(` ✓ ${find()}`); return 0 }
if (argv[0] === '--install' || argv[0] === 'install') {
try { await installManagedTui(process.argv[1] ?? '', (line) => console.log(line)); return 0 } catch (error) { console.error(` ✗ ${(error as Error).message}`); return 1 }
}
const port = clientPort(argv, opts.port)
const dataDir = opts.dataDir ?? process.env.ADAPTER_DATA_DIR ?? resolve(homedir(), '.harness', 'cli', 'data')
if (port !== null && !(await ensureDaemon(port, dataDir, opts.identity))) {
console.log(' Opening a local shell; Harness will reconnect when available.')
}
let binary = find()
if (!binary) {
try { binary = await installTui((line) => console.log(line)) } catch (error) {
console.error(` ✗ ${(error as Error).message}`)
return 1
}
}
const result = spawnSync(binary, argv, {
stdio: 'inherit',
// How the TUI runs this CLI back (`harness link connect` for a machine it has to link).
env: { ...process.env, PORT: String(port ?? opts.port), ADAPTER_DATA_DIR: dataDir, HARNESS_CLI: process.execPath, HARNESS_SELF: '1', HARNESS_CLI_ARGS: JSON.stringify([...process.execArgv, process.argv[1] ?? '']) },
})
if (result.error) { console.error(` ✗ Could not start ${binary}: ${result.error.message}`); return 1 }
return result.status ?? 0
}