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 { mkdtempSync, rmSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { AGENT_ATTRIBUTION_LINE, agentLaunchArgs, HARNESS_INSTRUCTIONS, joinedInstructions } from './agentAttribution.js'
import { agentSettingsPath } from './agentSettings.js'
import { setAgentSettingsForTest, signedOutForTest } from '../testing/agentSettings.js'
// Harness's status line rides every Claude launch beside what these pin (engines/claude/statusLine.spec.ts).
vi.mock('../engines/kit/statusLine.js', async (original) => ({ ...await original<object>(), statusLineSetting: () => null }))
let dataDir = ''
beforeEach(() => {
dataDir = mkdtempSync(join(tmpdir(), 'agent-attribution-'))
// The account has turned both on: off by default (lib/agentSettings.ts). A test of the default removes the file.
setAgentSettingsForTest(dataDir, { agentsStartAgents: true, pullRequestLine: true })
})
afterEach(() => { rmSync(dataDir, { recursive: true, force: true }); signedOutForTest() })
/** A launch that reads no settings: nothing the person set. */
const place = { cwd: null, read: () => null }
const claudeTold = ['--append-system-prompt', HARNESS_INSTRUCTIONS]
/** Codex is told besides that its sandbox cannot reach Harness (engines/codex/launch.ts). */
const CODEX_TOLD = `${HARNESS_INSTRUCTIONS} Codex's sandbox cannot reach Harness: run each harness command outside it, with escalated permissions.`
const codexValue = (...texts: string[]) => ['-c', `developer_instructions=${JSON.stringify(texts.join('\n\n'))}`]
describe('what Harness tells an agent as it starts', () => {
it('is the line the owner chose, and the instructions every harness gets', () => {
expect(AGENT_ATTRIBUTION_LINE).toBe('🤝 Started by another agent in [Harness](https://harness.autonomous.ai) — agents that run agents.')
expect(HARNESS_INSTRUCTIONS).toBe('You are running in Harness, and the person can watch you. You can hand work to other agents (Claude Code, Codex) that run in their own harnesses: `harness new`, `harness wait`, `harness show`, `harness close` (see `harness --help`). Start one only for work that can run in parallel, needs another model, or takes long; do quick work yourself, and close each one once you have its answer. Only use or close harnesses you started.')
})
it('keeps legacy spawn instructions but never adds retired PR branding', () => {
for (const startedBy of ['agent', null, undefined] as const) {
expect(agentLaunchArgs('claude', startedBy, place, dataDir)).toEqual(claudeTold)
expect(agentLaunchArgs('codex', startedBy, place, dataDir)).toEqual(codexValue(CODEX_TOLD))
expect(agentLaunchArgs('opencode', startedBy, place, dataDir)).toEqual([])
}
})
it('tells an agent nothing of Harness, and adds no line, for an account that never turned either on, or signed out', () => {
rmSync(agentSettingsPath(dataDir))
for (const startedBy of ['agent', null] as const) {
expect(agentLaunchArgs('claude', startedBy, place, dataDir)).toEqual([])
expect(agentLaunchArgs('codex', startedBy, place, dataDir)).toEqual([])
}
setAgentSettingsForTest(dataDir, { agentsStartAgents: true, pullRequestLine: true })
signedOutForTest()
expect(agentLaunchArgs('claude', 'agent', place, dataDir)).toEqual([])
})
it('does not revive PR branding when the saved compatibility flag remains on', () => {
setAgentSettingsForTest(dataDir, { agentsStartAgents: false, pullRequestLine: true })
expect(agentLaunchArgs('claude', 'agent', place, dataDir)).toEqual([])
expect(agentLaunchArgs('codex', 'agent', place, dataDir)).toEqual([])
setAgentSettingsForTest(dataDir, { agentsStartAgents: true, pullRequestLine: false })
expect(agentLaunchArgs('claude', 'agent', place, dataDir)).toEqual(claudeTold)
setAgentSettingsForTest(dataDir, { agentsStartAgents: false })
expect(agentLaunchArgs('claude', 'agent', { cwd: '/w', read: () => { throw new Error('read nothing') } }, dataDir)).toEqual([])
})
it('tells Claude Code nothing of the line where the person hid its attribution', () => {
const hidden = { cwd: null, read: (path: string) => path.endsWith('settings.json') ? JSON.stringify({ attribution: false }) : null }
expect(agentLaunchArgs('claude', 'agent', hidden, dataDir)).toEqual(claudeTold)
})
it('keeps the person\'s own Codex instructions first, and says nothing they already say', () => {
const theirs = { cwd: null, read: (path: string) => path.endsWith('config.toml') ? 'developer_instructions = "Be brief."\n' : null }
expect(agentLaunchArgs('codex', null, theirs, dataDir)).toEqual(codexValue('Be brief.', CODEX_TOLD))
const said = { cwd: null, read: (path: string) => path.endsWith('config.toml') ? `developer_instructions = ${JSON.stringify(CODEX_TOLD)}\n` : null }
expect(agentLaunchArgs('codex', null, said, dataDir)).toEqual([])
})
it('keeps Swarm role instructions when generic agent spawning is enabled', () => {
setAgentSettingsForTest(dataDir, { agentsStartAgents: true })
for (const engine of ['claude', 'codex']) {
const args = agentLaunchArgs(engine, null, { cwd: '/w', read: () => null, swarmInstructions: 'Read the swarm-dev skill.' }, dataDir)
expect(args.join(' ')).toContain('Read the swarm-dev skill.')
expect(args.join(' ')).not.toContain(HARNESS_INSTRUCTIONS)
}
})
it('joins every appended system prompt into one, for Claude Code; leaves other engines\' arguments alone', () => {
expect(joinedInstructions('claude', ['--system-prompt-snapshot', 'off', '--append-system-prompt', 'grid', '--agent', 'x', '--append-system-prompt', 'ours']))
.toEqual(['--system-prompt-snapshot', 'off', '--agent', 'x', '--append-system-prompt', 'grid\n\nours'])
expect(joinedInstructions('claude', ['--agent', 'x'])).toEqual(['--agent', 'x'])
// A flag with no value after it is left as it is.
expect(joinedInstructions('claude', ['--append-system-prompt'])).toEqual(['--append-system-prompt'])
expect(joinedInstructions('codex', ['-c', 'a=1', '-c', 'a=2'])).toEqual(['-c', 'a=1', '-c', 'a=2'])
})
})