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
// The pane. One self-contained page, rewritten after every turn, served by the shared Web Viewer —
// which reloads it the moment the file changes, so the room fills in front of the user.
//
// The layout is the argument for this harness: columns are seats, rows are rounds. Read ACROSS a row
// to compare four minds on one beat; read DOWN a column to watch one mind hold or move. A chat log
// cannot do either, which is why this is not a chat log.
import { writeFileSync } from 'node:fs'
import { join } from 'node:path'
import { ADAPTERS } from './engines.mjs'
import { trimToShape } from './prompts.mjs'
import { PROTOCOL, WORKSPACE, decision, motion, readClaims, readRoom, readTurn } from './room.mjs'
const ENGINE_HUE = { claude: 18, codex: 220, opencode: 268, grok: 0, pi: 150, hermes: 44 }
/**
* Seats cite files by the absolute path they were given, because that is what they were given. In
* the pane that is noise — and on a page anyone might share, it is the reader's home directory. The
* evidence root is stripped back to the repo-relative path the reader recognises.
*/
export function relativise(text, evidence = []) {
let out = String(text ?? '')
for (const root of [...evidence].sort((a, b) => b.length - a.length)) {
if (!root) continue
out = out.split(`${root}/`).join('').split(root).join(root.split('/').pop())
}
return out
}
const esc = (s) => String(s ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&', '<': '<', '>': '>', '"': '"' }[c]))
/** Just enough markdown for a turn: headings, bold, code, bullets, paragraphs. No dependencies. */
function md(text) {
// Seats cite differently: Codex writes markdown links to files, others write bare paths. A link to
// the web is a link; a link to a file is the path, which is the part a reader can act on.
const inline = (s) => esc(s)
.replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer">$1</a>')
.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, '<code>$2</code>')
.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
.replace(/(^|[\s(])\*([^*\n]+)\*/g, '$1<em>$2</em>')
.replace(/`([^`]+)`/g, '<code>$1</code>')
// Turns arrive hard-wrapped, so a paragraph is a run of lines and a bullet continues until the
// next one. Formatting line by line splits `**a bold phrase**` across two lines and it renders as
// asterisks — which is exactly what the first draft of this did to the decision card.
const out = []
let list = null
let para = []
const flushPara = () => { if (para.length) { out.push(`<p>${inline(para.join(' '))}</p>`); para = [] } }
const flushList = () => { if (list) { out.push(`<ul>${list.map((i) => `<li>${inline(i)}</li>`).join('')}</ul>`); list = null } }
for (const raw of String(text ?? '').split('\n')) {
const line = raw.trim()
const bullet = /^[-*]\s+(.*)$/.exec(line)
const heading = /^(#{1,6})\s+(.*)$/.exec(line)
if (!line) { flushPara(); flushList(); continue }
if (heading) { flushPara(); flushList(); out.push(`<h4>${inline(heading[2])}</h4>`); continue }
if (bullet) { flushPara(); list ??= []; list.push(bullet[1]); continue }
if (list) { list[list.length - 1] += ` ${line}`; continue }
para.push(line)
}
flushPara(); flushList()
return out.join('\n')
}
const seconds = (ms) => (!ms ? '' : ms < 1000 ? `${ms}ms` : ms < 60_000 ? `${(ms / 1000).toFixed(0)}s` : `${Math.floor(ms / 60_000)}m ${Math.round((ms % 60_000) / 1000)}s`)
function seatHead(seat) {
const adapter = ADAPTERS[seat.engine] ?? { label: seat.engine, vendor: '' }
const hue = ENGINE_HUE[seat.engine] ?? 210
return `<div class="seat" style="--hue:${hue}">
<div class="seat-top"><span class="chip">${esc(seat.engine.slice(0, 2).toUpperCase())}</span>
<div><div class="seat-name">${esc(seat.id)}</div>
<div class="seat-engine">${esc(adapter.label)}${adapter.vendor ? ` · ${esc(adapter.vendor)}` : ''}</div></div></div>
${seat.stance ? `<div class="stance">${esc(seat.stance)}</div>` : '<div class="stance none">no assigned stance</div>'}
</div>`
}
function cell(roundId, seat, evidence) {
const turn = readTurn(roundId, seat.id)
if (!turn) return '<div class="cell empty"><span>—</span></div>'
const state = turn.front.state ?? 'answered'
if (state === 'thinking') {
return `<div class="cell thinking"><div class="bar"></div><div class="bar"></div><div class="bar short"></div>
<div class="cell-foot">thinking…</div></div>`
}
if (state === 'absent') {
return `<div class="cell absent"><p class="why">No answer.</p><p class="why dim">${esc(turn.front.error ?? '')}</p></div>`
}
return `<div class="cell" tabindex="0" role="button" aria-expanded="false"><div class="turn">${md(relativise(trimToShape(turn.body, roundId), evidence))}</div>
<div class="fade"></div>
<div class="cell-foot"><span class="more">more</span>${esc(seconds(Number(turn.front.elapsed_ms)))}${turn.front.model && turn.front.model !== 'default' ? ` · ${esc(turn.front.model)}` : ''}</div></div>`
}
function claimsTable(room, claims) {
if (!claims.length) return ''
const mark = { agree: '<span class="m yes">✓</span>', disagree: '<span class="m no">✗</span>', silent: '<span class="m dim">—</span>' }
const rows = claims.map((claim) => {
const votes = room.seats.map((s) => claim.by?.[s.id] ?? 'silent')
const settled = votes.every((v) => v === 'agree')
const split = votes.includes('agree') && votes.includes('disagree')
return `<tr class="${settled ? 'settled' : split ? 'split' : ''}">
<td class="claim">${esc(claim.text)}</td>
${votes.map((v) => `<td>${mark[v] ?? mark.silent}</td>`).join('')}
<td class="verdictcol">${settled ? 'settled' : split ? 'split' : 'open'}</td></tr>`
}).join('')
return `<section class="claims"><h2>Where they agree, and where they don't</h2>
<div class="scroller"><table><thead><tr><th>Claim</th>${room.seats.map((s) => `<th class="seatcol">${esc(s.id)}</th>`).join('')}<th></th></tr></thead>
<tbody>${rows}</tbody></table></div></section>`
}
function phaseStrip(room) {
const phases = [...room.rounds, { id: 'decision', name: 'Decision', state: room.status === 'decided' ? 'done' : 'pending' }]
return `<div class="phases">${phases.map((p) => `<span class="phase ${p.state}">${esc(p.name)}</span>`).join('<i></i>')}</div>`
}
function readView(room) {
const blocks = []
for (const round of PROTOCOL) {
const turns = room.seats.map((s) => ({ seat: s, turn: readTurn(round.id, s.id) })).filter((t) => t.turn?.body?.trim())
if (!turns.length) continue
blocks.push(`<h2 class="readround">${esc(round.name)}</h2>`)
for (const { seat, turn } of turns) {
blocks.push(`<article class="readturn" style="--hue:${ENGINE_HUE[seat.engine] ?? 210}">
<header><span class="chip">${esc(seat.engine.slice(0, 2).toUpperCase())}</span><b>${esc(seat.id)}</b>
<span class="dim">${esc(ADAPTERS[seat.engine]?.label ?? seat.engine)}</span></header>${md(relativise(trimToShape(turn.body, round.id), room.evidence))}</article>`)
}
}
return blocks.join('\n')
}
export function renderHtml() {
const room = readRoom()
const { claims } = readClaims()
const motionText = motion().replace(/^#.*\n/, '').trim()
const call = decision()
const answered = PROTOCOL.flatMap((r) => room.seats.map((s) => readTurn(r.id, s.id))).filter((t) => t?.front?.state === 'answered').length
const cols = `160px repeat(${Math.max(room.seats.length, 1)}, minmax(220px, 1fr))`
return `<!doctype html>
<html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>${esc(room.motion || 'Roundtable')}</title>
<style>
:root{color-scheme:light dark;--bg:light-dark(#fbfbfa,#161615);--fg:light-dark(#1b1b19,#eceae4);--dim:light-dark(#6b6a65,#9a9892);
--line:light-dark(#e2e0da,#2e2e2b);--card:light-dark(#fff,#1e1e1c);--accent:light-dark(#b8552a,#e08a5a);
--yes:light-dark(#2f7d4f,#63c48c);--no:light-dark(#b23b3b,#e8756f);font-family:ui-sans-serif,-apple-system,"SF Pro Text",system-ui,sans-serif}
*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--fg);font-size:13.5px;line-height:1.5}
header.top{position:sticky;top:0;z-index:5;background:var(--bg);border-bottom:1px solid var(--line);padding:14px 20px 10px}
.label{font-size:10px;letter-spacing:.14em;text-transform:uppercase;color:var(--accent);font-weight:600}
h1{font-size:19px;line-height:1.3;margin:4px 0 10px;font-weight:600;max-width:70ch}
.meta{display:flex;align-items:center;gap:14px;flex-wrap:wrap}
.phases{display:flex;align-items:center;gap:7px;font-size:11px}
.phases i{width:14px;height:1px;background:var(--line)}
.phase{color:var(--dim)}.phase.done{color:var(--fg)}.phase.done::before{content:"● "}
.phase.active{color:var(--accent);font-weight:600}.phase.active::before{content:"◐ "}.phase.pending::before{content:"○ "}
.count{margin-left:auto;font-size:11px;color:var(--dim)}
.views{display:flex;gap:2px;background:light-dark(#efeee9,#232321);border-radius:7px;padding:2px}
.views button{font:inherit;font-size:11.5px;border:0;background:transparent;color:var(--dim);padding:3px 11px;border-radius:5px;cursor:pointer}
.views button[aria-pressed=true]{background:var(--card);color:var(--fg);box-shadow:0 1px 2px #0002}
main{padding:16px 20px 60px}
.call{background:var(--card);border:1px solid var(--line);border-left:3px solid var(--accent);border-radius:8px;padding:14px 18px;margin-bottom:18px}
.call h2{font-size:11px;letter-spacing:.12em;text-transform:uppercase;color:var(--accent);margin:0 0 6px}
.claims{margin-bottom:22px}
.claims table{min-width:min-content}
.claims .scroller{margin-top:2px}
.claims h2,.grid-title{font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--dim);margin:0 0 8px;font-weight:600}
table{border-collapse:collapse;width:100%;font-size:12.5px}
th,td{text-align:left;padding:7px 10px;border-bottom:1px solid var(--line);vertical-align:top}
th{font-size:10.5px;text-transform:uppercase;letter-spacing:.06em;color:var(--dim);font-weight:600}
th.seatcol,td:not(.claim):not(.verdictcol){text-align:center;width:74px}
td.claim,th:first-child{min-width:260px}
tr.settled td.claim{color:var(--dim)}tr.split{background:light-dark(#fff8f0,#26211c)}
.verdictcol{font-size:10.5px;color:var(--dim);text-transform:uppercase;letter-spacing:.06em;width:60px}
.m.yes{color:var(--yes)}.m.no{color:var(--no)}.m.dim{color:var(--dim)}
.scroller{overflow-x:auto;border:1px solid var(--line);border-radius:8px}
.grid{display:grid;grid-template-columns:${cols};gap:1px;background:var(--line);min-width:min-content}
.grid>*{background:var(--bg)}
.seat{padding:10px 12px;background:var(--card)}
.seat-top{display:flex;gap:8px;align-items:center}
.chip{display:grid;place-items:center;width:20px;height:20px;border-radius:5px;font-size:9.5px;font-weight:700;letter-spacing:.02em;
background:oklch(.72 .13 var(--hue));color:#111;flex:none}
.seat-name{font-weight:600;font-size:12.5px}.seat-engine{font-size:10.5px;color:var(--dim)}
.stance{margin-top:7px;font-size:11px;color:var(--dim);line-height:1.35}.stance.none{font-style:italic;opacity:.7}
.rowhead{padding:12px;background:var(--card);font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--dim);font-weight:600;
position:sticky;left:0;z-index:2;box-shadow:1px 0 0 var(--line)}
.corner{position:sticky;left:0;z-index:3}
.cell{position:relative;padding:11px 13px 30px;max-height:340px;overflow:hidden;font-size:12.5px;cursor:pointer}
.cell.open{max-height:none;cursor:default}
.cell:focus-visible{outline:2px solid var(--accent);outline-offset:-2px}
.cell .fade{position:absolute;left:0;right:0;bottom:26px;height:46px;pointer-events:none;
background:linear-gradient(transparent,var(--bg))}
.cell.open .fade{display:none}
.cell:not(.clipped) .fade,.cell:not(.clipped) .more{display:none}
.more{border:1px solid var(--line);border-radius:4px;padding:0 5px;margin-right:7px;color:var(--accent)}
.cell.open .more::after{content:"less"}.cell.open .more{font-size:0}.cell.open .more::after{font-size:10px}
.cell.empty{display:grid;place-items:center;color:var(--line);min-height:70px}
.cell.absent .why{color:var(--dim);font-size:11.5px}.cell.absent .why.dim{opacity:.7;font-size:10.5px}
.turn h4{font-size:10.5px;letter-spacing:.06em;text-transform:uppercase;color:var(--accent);margin:12px 0 3px}
.turn p,.readturn p{margin:0 0 7px}.turn strong,.readturn strong{font-weight:650}
.turn ul,.readturn ul{margin:0 0 8px;padding-left:16px}.turn li,.readturn li{margin:0 0 3px}
.turn p strong:first-child{color:var(--accent)}
.cell-foot{position:absolute;left:0;right:0;bottom:0;background:var(--bg);display:flex;align-items:center;
font-size:10px;color:var(--dim);border-top:1px solid var(--line);padding:5px 13px 6px}
.cell.thinking{display:flex;flex-direction:column;gap:7px;justify-content:center;min-height:90px}
.bar{height:7px;border-radius:4px;background:var(--line);animation:pulse 1.4s ease-in-out infinite}
.bar.short{width:55%}@keyframes pulse{0%,100%{opacity:.35}50%{opacity:.9}}
code{font-family:ui-monospace,SFMono-Regular,monospace;font-size:.92em;background:light-dark(#f0efe9,#262623);padding:1px 4px;border-radius:4px}
#read{display:none;max-width:74ch}#read.on{display:block}.grid.off,.claims.off{display:none}
.readround{font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--dim);margin:26px 0 10px}
.readturn{border-left:2px solid oklch(.72 .13 var(--hue));padding:2px 0 2px 14px;margin-bottom:18px}
.readturn header{display:flex;gap:8px;align-items:center;margin-bottom:6px;font-size:12px}
.dim{color:var(--dim)}
.empty-room{color:var(--dim);padding:40px 0;text-align:center}
</style>
<header class="top">
<div class="label">Roundtable${room.status === 'decided' ? ' · decided' : ''}</div>
<h1>${esc(room.motion || 'No motion yet')}</h1>
<div class="meta">${phaseStrip(room)}
<div class="views"><button id="b-matrix" aria-pressed="true">Matrix</button><button id="b-read" aria-pressed="false">Read</button></div>
<span class="count">${room.seats.length} seats · ${answered} turns${room.evidence?.length ? ` · evidence: ${esc(room.evidence.map((e) => e.split('/').pop()).join(', '))}` : ''}</span>
</div>
</header>
<main>
${call ? `<section class="call"><h2>The call</h2>${md(call.replace(/^#\s+.*\n/, ''))}</section>` : ''}
${claimsTable(room, claims)}
${room.seats.length ? `<div class="grid-title">The room</div>
<div class="scroller"><div class="grid">
<div class="corner"></div>
${room.seats.map(seatHead).join('')}
${PROTOCOL.map((round) => `<div class="rowhead">${esc(round.name)}</div>${room.seats.map((s) => cell(round.id, s, room.evidence)).join('')}`).join('')}
</div></div>` : '<div class="empty-room">No seats yet. The moderator is still setting the room.</div>'}
${motionText ? `<details style="margin-top:22px"><summary class="grid-title" style="cursor:pointer">The motion in full</summary><div style="max-width:74ch;margin-top:8px">${md(motionText)}</div></details>` : ''}
<div id="read">${readView(room)}</div>
</main>
<script>
for(const cell of document.querySelectorAll('.cell[role=button]')){
const turn=cell.querySelector('.turn');
if(turn.scrollHeight>cell.clientHeight-30)cell.classList.add('clipped');
cell.addEventListener('click',()=>{const open=cell.classList.toggle('open');cell.setAttribute('aria-expanded',open)});
}
const grid=document.querySelector('.grid'),claims=document.querySelector('.claims'),read=document.getElementById('read');
const set=(mode)=>{document.getElementById('b-matrix').setAttribute('aria-pressed',mode==='matrix');
document.getElementById('b-read').setAttribute('aria-pressed',mode==='read');
grid&&grid.classList.toggle('off',mode==='read');claims&&claims.classList.toggle('off',mode==='read');
read.classList.toggle('on',mode==='read');try{localStorage.setItem('rt-view',mode)}catch{}};
document.getElementById('b-matrix').onclick=()=>set('matrix');document.getElementById('b-read').onclick=()=>set('read');
try{set(localStorage.getItem('rt-view')||'matrix')}catch{set('matrix')}
</script>
</html>`
}
export function writeIndex() {
const html = renderHtml()
writeFileSync(join(WORKSPACE, 'index.html'), html)
return html.length
}