npm - coxpit - Versions diffs - 2.2.1 → 2.4.0 - Mend

coxpit 2.2.1 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -42,7 +42,22 @@ npm run dev
 Open the board, register a repo (absolute path), write a task, hit **Run fleet**.
-By default agents run in **dry-run mode** (a mock that exercises the whole pipeline without spending credits). Flip the "real agent" toggle per launch, or set `COXPIT_AGENT_REAL=1` to default to real.
+By default agents run in **dry-run mode** (a mock that exercises the whole pipeline without spending credits). Flip the Dry/Real toggle per launch, or set `COXPIT_AGENT_REAL=1` to default to real.
+## First run
+Coxpit has no accounts of its own — it drives the agent CLI already on your machine, with that CLI's own login:
+1. **Install & sign in to the agent CLI once** (Claude Code by default):
+   ```bash
+   npm i -g @anthropic-ai/claude-code
+   claude        # first run opens browser login
+   ```
+   Prefer another CLI? Set `COXPIT_AGENT_BIN`.
+2. **Open the board** — the first-run panel checks this machine (git · tmux · agent CLI) and tells you what's missing.
+3. **Rehearse with Dry run**, then flip to Real agent. Real runs spend your CLI account's credits — nothing is billed through coxpit.
+Your keys and login never touch coxpit's config or database.
 ## Configuration

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "coxpit",
-  "version": "2.2.1",
+  "version": "2.4.0",
   "description": "Self-hosted cockpit for running a fleet of AI coding agents across your own machines — parallel worktree runs, live board, compare & merge, web terminal, design capture.",
   "type": "module",
   "license": "MIT",

package/src/board.ts CHANGED Viewed

@@ -71,6 +71,26 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   .row .narrow{flex:0 0 64px}
   .check{display:flex;align-items:center;gap:8px;font-size:12px;color:var(--muted);cursor:pointer;user-select:none}
   .check input{width:auto;accent-color:var(--brand)}
+  /* ── custom dropdown (native select 대체) ── */
+  .dd{position:relative}
+  .dd-btn{width:100%;display:flex;align-items:center;gap:8px;background:#0e1118;color:var(--ink);
+    border:1px solid var(--line);border-radius:var(--r-ctl);padding:8px 10px;font-family:var(--mono);
+    font-size:12px;cursor:pointer;transition:border-color .15s;text-align:left}
+  .dd-btn:hover{border-color:var(--line-hi)}
+  .dd.open .dd-btn{border-color:rgba(78,201,176,.55)}
+  .dd-lbl{flex:1;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}
+  .dd-car{color:var(--faint);font-size:10px;transition:transform .15s}
+  .dd.open .dd-car{transform:rotate(180deg)}
+  .dd-panel{position:absolute;top:calc(100% + 5px);left:0;right:0;z-index:40;background:var(--surface2);
+    border:1px solid var(--line-hi);border-radius:9px;box-shadow:var(--shadow);max-height:230px;
+    overflow:auto;padding:4px;display:none}
+  .dd.open .dd-panel{display:block}
+  .dd-opt{padding:7px 10px;border-radius:6px;font-family:var(--mono);font-size:12px;color:var(--muted);
+    cursor:pointer;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .dd-opt:hover{background:var(--surface);color:var(--ink)}
+  .dd-opt.on{color:var(--brand)}
+  .dd-opt.on::before{content:'✓ ';font-size:10px}
   .seg{display:flex;gap:3px;padding:3px;border:1px solid var(--line);border-radius:var(--r-ctl);background:#0e1118}
   .seg-opt{flex:1;display:flex;flex-direction:column;align-items:center;gap:1px;padding:6px 8px;border:none;
     background:transparent;color:var(--muted);font-size:12px;font-weight:600;cursor:pointer;
@@ -120,6 +140,48 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   .empty{color:var(--faint);font-family:var(--mono);font-size:12px;padding:64px 24px;text-align:center;
     display:flex;flex-direction:column;gap:10px;align-items:center}
   .empty .glyph{font-size:22px;color:#2c3444;letter-spacing:4px}
+  /* ── onboarding (first run) ─────────────── */
+  .setup{max-width:560px;margin:40px auto;border:1px solid var(--line);border-radius:14px;
+    background:var(--surface);overflow:hidden;text-align:left}
+  .setup-h{padding:18px 22px 14px;border-bottom:1px solid var(--line)}
+  .setup-h .t{font-weight:700;font-size:16px}
+  .setup-h .d{color:var(--muted);font-size:13px;margin-top:3px}
+  .setup-sec{padding:14px 22px;border-bottom:1px solid var(--line)}
+  .setup-sec:last-child{border-bottom:none}
+  .setup-label{font-family:var(--mono);font-size:10px;text-transform:uppercase;letter-spacing:.14em;
+    color:var(--faint);margin:0 0 9px}
+  .chk{display:flex;align-items:center;gap:10px;padding:6px 0;font-size:13px}
+  .chk .st{font-family:var(--mono);font-size:12px;width:18px;text-align:center;flex:none}
+  .chk.ok .st{color:var(--s-done)} .chk.bad .st{color:var(--s-failed)} .chk.wait .st{color:var(--faint)}
+  .chk .nm{color:var(--ink);min-width:88px;font-weight:500}
+  .chk .v{color:var(--faint);font-family:var(--mono);font-size:11.5px;overflow:hidden;
+    white-space:nowrap;text-overflow:ellipsis}
+  .setup-fix{margin:8px 0 2px;padding:10px 13px;background:#0e1118;border:1px solid var(--line);
+    border-radius:8px;font-family:var(--mono);font-size:11.5px;color:var(--muted);overflow-x:auto;white-space:pre}
+  .setup-steps{margin:0;padding-left:20px;color:var(--muted);font-size:13px}
+  .setup-steps li{margin-bottom:7px}
+  .setup-steps b{color:var(--ink)}
+  /* ── toasts ─────────────────────────────── */
+  .toasts{position:fixed;top:66px;right:18px;z-index:60;display:flex;flex-direction:column;gap:8px;
+    max-width:380px}
+  .toast{border:1px solid var(--line);border-radius:9px;background:var(--surface);color:var(--ink);
+    padding:10px 14px;font-size:13px;box-shadow:var(--shadow);display:flex;gap:9px;align-items:baseline;
+    animation:tin .18s ease}
+  .toast .tk{font-family:var(--mono);font-size:11px;flex:none}
+  .toast.err{border-color:rgba(226,91,103,.5)} .toast.err .tk{color:var(--s-failed)}
+  .toast.ok{border-color:rgba(78,201,176,.5)} .toast.ok .tk{color:var(--brand)}
+  @keyframes tin{from{opacity:0;transform:translateY(-6px)}to{opacity:1;transform:none}}
+  @media (prefers-reduced-motion:reduce){.toast{animation:none}}
+  /* ── confirm dialog ─────────────────────── */
+  .cfm{width:min(440px,92vw);background:var(--surface);border:1px solid var(--line);border-radius:14px;
+    box-shadow:var(--shadow);overflow:hidden}
+  .cfm-b{padding:20px 22px 14px}
+  .cfm-b .m{font-size:14px;color:var(--ink);line-height:1.6}
+  .cfm-b .s{font-size:12.5px;color:var(--faint);margin-top:6px}
+  .cfm-f{display:flex;gap:8px;justify-content:flex-end;padding:12px 18px;border-top:1px solid var(--line)}
   .flash{animation:flash .5s ease}
   @keyframes flash{from{border-color:rgba(78,201,176,.6)}to{border-color:var(--line)}}
@@ -290,6 +352,18 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   </div>
 </div>
+<div class="toasts" id="toasts"></div>
+<div class="overlay" id="cfmOverlay">
+  <div class="cfm">
+    <div class="cfm-b"><div class="m" id="cfmMsg"></div><div class="s" id="cfmSub"></div></div>
+    <div class="cfm-f">
+      <button class="btn-ghost sm" id="cfmCancel">Cancel</button>
+      <button class="btn sm" id="cfmOk">Confirm</button>
+    </div>
+  </div>
+</div>
 <script src="/vendor/xterm.js"></script>
 <script src="/vendor/addon-fit.js"></script>
 <script>
@@ -301,6 +375,65 @@ const $ = (id) => document.getElementById(id);
 const esc = (s) => String(s).replace(/[&<>]/g, (c) => ({'&':'&amp;','<':'&lt;','>':'&gt;'}[c]));
 const statusColor = (s) => 'var(--s-' + (s||'pending') + ', var(--muted))';
+/* ── custom toast / confirm (시스템 alert·confirm 대체) ── */
+function toast(msg, kind){
+  const el = document.createElement('div');
+  el.className = 'toast ' + (kind==='error'?'err':kind==='ok'?'ok':'');
+  el.innerHTML = '<span class="tk">'+(kind==='error'?'✕':kind==='ok'?'✓':'·')+'</span><span>'+esc(msg)+'</span>';
+  $('toasts').appendChild(el);
+  setTimeout(()=>{ el.style.opacity='0'; el.style.transition='opacity .25s'; setTimeout(()=>el.remove(),260); }, 4200);
+}
+/* ── custom dropdown — 숨긴 native select 를 상태 보관용으로 감싼다 ── */
+function dressSelect(id){
+  const sel = $(id); if(!sel || sel.dataset.dd) return;
+  sel.dataset.dd = '1';
+  const dd = document.createElement('div'); dd.className = 'dd';
+  dd.innerHTML = '<button type="button" class="dd-btn"><span class="dd-lbl"></span><span class="dd-car">▾</span></button><div class="dd-panel"></div>';
+  sel.parentNode.insertBefore(dd, sel);
+  sel.style.display = 'none';
+  dd.querySelector('.dd-btn').addEventListener('click', (e)=>{
+    e.stopPropagation();
+    const wasOpen = dd.classList.contains('open');
+    closeDropdowns();
+    if (!wasOpen) dd.classList.add('open');
+  });
+  dd.querySelector('.dd-panel').addEventListener('click', (e)=>{
+    const o = e.target.closest('.dd-opt'); if(!o) return;
+    sel.value = o.dataset.v;
+    dd.classList.remove('open');
+    syncSelect(id);
+  });
+  syncSelect(id);
+}
+function syncSelect(id){
+  const sel = $(id); if(!sel) return;
+  const dd = sel.previousElementSibling;
+  if (!dd || !dd.classList || !dd.classList.contains('dd')) return;
+  const cur = sel.options[sel.selectedIndex];
+  dd.querySelector('.dd-lbl').textContent = cur ? cur.textContent : '—';
+  dd.querySelector('.dd-panel').innerHTML = [...sel.options].map(o =>
+    '<div class="dd-opt'+(o.value===sel.value?' on':'')+'" data-v="'+esc(o.value)+'">'+esc(o.textContent)+'</div>').join('');
+}
+function closeDropdowns(){ document.querySelectorAll('.dd.open').forEach(d=>d.classList.remove('open')); }
+document.addEventListener('click', closeDropdowns);
+let cfmResolve = null;
+function confirmUI(message, opts){
+  opts = opts || {};
+  $('cfmMsg').textContent = message;
+  $('cfmSub').textContent = opts.sub || '';
+  $('cfmSub').style.display = opts.sub ? '' : 'none';
+  const ok = $('cfmOk');
+  ok.textContent = opts.okLabel || 'Confirm';
+  ok.className = (opts.danger ? 'btn-danger sm' : 'btn sm');
+  $('cfmOverlay').classList.add('open');
+  return new Promise((resolve)=>{ cfmResolve = resolve; });
+}
+function cfmClose(v){ $('cfmOverlay').classList.remove('open'); if(cfmResolve){ cfmResolve(v); cfmResolve=null; } }
+$('cfmOk').addEventListener('click', ()=>cfmClose(true));
+$('cfmCancel').addEventListener('click', ()=>cfmClose(false));
+$('cfmOverlay').addEventListener('click',(e)=>{ if(e.target===$('cfmOverlay')) cfmClose(false); });
 function summarize(kind, payload){
   try{
     const o = JSON.parse(payload);
@@ -336,8 +469,55 @@ function chipHTML(status){
 function render(){
   const list = [...runs.values()].sort((a,b)=>b.id-a.id);
   $('empty').style.display = list.length ? 'none' : 'flex';
+  if (!list.length) paintOnboarding();
   $('grid').innerHTML = list.map(cardHTML).join('');
 }
+/* ── first-run onboarding (빈 보드 = 준비 상태 점검 + 시작 안내) ── */
+let readiness = null, probing = false;
+async function probeFirstMachine(){
+  if (probing || !machines.length) return;
+  probing = true;
+  try{
+    readiness = await fetch('/api/machines/'+encodeURIComponent(machines[0].slug)+'/probe',{method:'POST'}).then(x=>x.json());
+  }catch{ readiness = { reachable:false }; }
+  probing = false;
+  if (![...runs.values()].length) paintOnboarding();
+}
+function chkRow(name, ok, val){
+  const cls = ok===null ? 'wait' : ok ? 'ok' : 'bad';
+  const st = ok===null ? '…' : ok ? '✓' : '✕';
+  return '<div class="chk '+cls+'"><span class="st">'+st+'</span><span class="nm">'+esc(name)+'</span>'
+    + '<span class="v">'+esc(val||'')+'</span></div>';
+}
+function paintOnboarding(){
+  const r = readiness;
+  const agentBin = r && r.agent ? r.agent.bin : 'claude';
+  let checks;
+  if (!r){
+    checks = chkRow('machine', null, 'checking…') ;
+    probeFirstMachine();
+  } else {
+    checks = chkRow('connection', !!r.reachable, machines.length ? machines[0].slug : '')
+      + chkRow('git', r.git ? r.git.ok : false, r.git ? r.git.version : '')
+      + chkRow('tmux', r.tmux ? r.tmux.ok : false, r.tmux ? r.tmux.version : '')
+      + chkRow('agent', r.agent ? r.agent.ok : false, r.agent ? (r.agent.ok ? agentBin+' '+r.agent.version : 'not found on PATH') : '');
+  }
+  const agentMissing = r && r.agent && !r.agent.ok;
+  $('empty').innerHTML = '<div class="setup">'
+    + '<div class="setup-h"><div class="t">Welcome to coxpit</div>'
+    + '<div class="d">Run a fleet of coding agents on this machine — each in its own git worktree.</div></div>'
+    + '<div class="setup-sec"><p class="setup-label">This machine</p>' + checks
+    + (agentMissing
+        ? '<div class="setup-fix"># install the agent CLI, then sign in once:\\nnpm i -g @anthropic-ai/claude-code\\n'+esc(agentBin)+'   # first run opens browser login</div>'
+        : '<div class="setup-fix" style="white-space:normal">Agent CLI found. If real runs fail with an auth error, run <b>'+esc(agentBin)+'</b> once in a terminal to sign in.</div>')
+    + '</div>'
+    + '<div class="setup-sec"><p class="setup-label">Get started</p><ol class="setup-steps">'
+    + '<li><b>Register a repo</b> — absolute path, in the left sidebar</li>'
+    + '<li><b>Write a task</b> — title + a prompt that names the target files</li>'
+    + '<li><b>Run fleet</b> — try <b>Dry run</b> first (free rehearsal), then <b>Real agent</b></li>'
+    + '</ol></div></div>';
+}
 function cardHTML(r){
   const task = tasks.get(r.taskId);
   const closed = task && task.status==='closed';
@@ -385,6 +565,7 @@ function paintSidebar(){
   capSel.innerHTML = '<option value="">no design capture</option>' + captures.map(c=>
     '<option value="'+c.id+'">#'+c.id+' '+esc((c.selector||'').slice(0,40))+'</option>').join('');
   capSel.value = cur;
+  ['repoMachine','taskRepo','taskCapture'].forEach(id => { dressSelect(id); syncSelect(id); });
   $('captures').innerHTML = captures.map(c=>
     '<div class="repo"><span class="nm">'+esc((c.selector||'?').slice(0,46))+'</span>'
     + '<button class="x" data-delcap="'+c.id+'" style="float:right;background:none;border:none;color:var(--faint);cursor:pointer">×</button>'
@@ -465,15 +646,15 @@ $('grid').addEventListener('click',(e)=>{
 });
 $('mClose').addEventListener('click', closeModal);
 $('overlay').addEventListener('click',(e)=>{ if(e.target===$('overlay')) closeModal(); });
-document.addEventListener('keydown',(e)=>{ if(e.key==='Escape'){ closeTerm(); closeModal(); cmpTaskId=null; $('cmpOverlay').classList.remove('open'); } });
+document.addEventListener('keydown',(e)=>{ if(e.key==='Escape'){ closeDropdowns(); cfmClose(false); closeTerm(); closeModal(); cmpTaskId=null; $('cmpOverlay').classList.remove('open'); } });
 $('mRefreshDiff').addEventListener('click', loadDiff);
 async function sendSteer(){
   if (openRunId==null) return;
   const msg = $('steerInput').value.trim(); if(!msg) return;
   const res = await fetch('/api/runs/'+openRunId+'/steer',{method:'POST',
     headers:{'content-type':'application/json'}, body:JSON.stringify({message:msg})});
-  if (res.ok){ $('steerInput').value=''; }
-  else { const j = await res.json().catch(()=>({})); alert('steer: '+(j.detail||res.status)); }
+  if (res.ok){ $('steerInput').value=''; toast('steering — the agent resumes in its worktree', 'ok'); }
+  else { const j = await res.json().catch(()=>({})); toast('steer: '+(j.detail||res.status), 'error'); }
 }
 $('steerSend').addEventListener('click', sendSteer);
 $('steerInput').addEventListener('keydown',(e)=>{ if(e.key==='Enter') sendSteer(); });
@@ -483,15 +664,21 @@ $('mStop').addEventListener('click', async ()=>{
 });
 $('mCleanup').addEventListener('click', async ()=>{
   if (openRunId==null) return;
-  if (!confirm('Remove worktree + branch for r'+openRunId+'?')) return;
+  const yes = await confirmUI('Remove the worktree and branch for r'+openRunId+'?',
+    { sub: 'Unmerged changes in this run will be lost. This cannot be undone.', danger: true, okLabel: 'Cleanup' });
+  if (!yes) return;
   await fetch('/api/runs/'+openRunId+'/cleanup',{method:'POST'});
+  toast('r'+openRunId+' cleaned up', 'ok');
   closeModal(); hydrate();
 });
 $('mCloseTask').addEventListener('click', async ()=>{
   if (openRunId==null) return;
   const r = runs.get(openRunId); if(!r) return;
-  if (!confirm('Close task — stop + cleanup ALL its runs?')) return;
+  const yes = await confirmUI('Close this task?',
+    { sub: 'Stops any live runs and removes every worktree and branch of the task.', danger: true, okLabel: 'Close task' });
+  if (!yes) return;
   await fetch('/api/tasks/'+r.taskId+'/close',{method:'POST'});
+  toast('task closed — all runs cleaned', 'ok');
   closeModal(); hydrate();
 });
@@ -530,13 +717,16 @@ async function paintCompare(){
 $('cmpBody').addEventListener('click', async (e)=>{
   const btn = e.target.closest('button[data-merge]'); if(!btn) return;
   const rid = Number(btn.dataset.merge);
-  if (!confirm('Merge r'+rid+' into the base branch?')) return;
+  const yes = await confirmUI('Merge r'+rid+' into the base branch?',
+    { sub: 'Uncommitted worktree changes are committed first. Conflicts abort automatically.', okLabel: 'Merge' });
+  if (!yes) return;
   btn.disabled = true;
   const res = await fetch('/api/runs/'+rid+'/merge',{method:'POST'});
   const j = await res.json().catch(()=>({detail:'merge failed'}));
   const msg = $('cmpMsg-'+rid);
   if (msg) msg.textContent = j.detail || (res.ok?'merged':'failed');
-  if (res.ok){ await paintCompare(); hydrate(); } else { btn.disabled = false; }
+  if (res.ok){ toast('r'+rid+' merged to base', 'ok'); await paintCompare(); hydrate(); }
+  else { toast('merge: '+(j.detail||res.status), 'error'); btn.disabled = false; }
 });
 $('cmpClose').addEventListener('click', ()=>{ cmpTaskId=null; $('cmpOverlay').classList.remove('open'); });
 $('cmpOverlay').addEventListener('click',(e)=>{ if(e.target===$('cmpOverlay')){ cmpTaskId=null; $('cmpOverlay').classList.remove('open'); } });
@@ -607,7 +797,8 @@ $('repoForm').addEventListener('submit', async (e)=>{
   const body = { machineSlug: $('repoMachine').value, path: $('repoPath').value.trim() };
   if (!body.path) return;
   const res = await fetch('/api/repos',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify(body)});
-  if (res.ok){ $('repoPath').value=''; await hydrate(); } else { alert('repo: '+(await res.text())); }
+  if (res.ok){ $('repoPath').value=''; toast('repo registered', 'ok'); await hydrate(); }
+  else { const j = await res.json().catch(()=>({})); toast('repo: '+(j.detail||j.error||res.status), 'error'); }
 });
 $('taskForm').addEventListener('submit', async (e)=>{
   e.preventDefault();
@@ -617,7 +808,7 @@ $('taskForm').addEventListener('submit', async (e)=>{
   const capId = Number($('taskCapture').value) || undefined;
   const t = await fetch('/api/tasks',{method:'POST',headers:{'content-type':'application/json'},
     body:JSON.stringify({repoId,title,prompt:$('taskPrompt').value,designCaptureId:capId})}).then(x=>x.json());
-  if (!t.ok){ alert('task failed'); return; }
+  if (!t.ok){ toast('task create failed', 'error'); return; }
   tasks.set(t.task.id, t.task);
   await fetch('/api/tasks/'+t.task.id+'/run',{method:'POST',headers:{'content-type':'application/json'},
     body:JSON.stringify({count:Number($('taskCount').value)||1, real: $('taskReal').checked})});

package/src/config.ts CHANGED Viewed

@@ -1,5 +1,19 @@
 import 'dotenv/config';
+// GUI 앱(Finder/데스크톱)에서 뜨면 PATH 가 최소(/usr/bin:/bin...)라 brew 로 설치한
+// 도구(claude·tmux·git)를 못 찾는다 — 표준 설치 경로를 부팅 시 1회 보강한다.
+{
+  const extra = [
+    '/opt/homebrew/bin',
+    '/usr/local/bin',
+    `${process.env.HOME ?? ''}/.local/bin`,
+    `${process.env.HOME ?? ''}/.npm-global/bin`,
+  ];
+  const cur = (process.env.PATH ?? '').split(':').filter(Boolean);
+  for (const p of extra) if (p && !p.startsWith('/.') && !cur.includes(p)) cur.push(p);
+  process.env.PATH = cur.join(':');
+}
 /** 런타임 설정. 시크릿은 전부 env 주입(번들 0). */
 export const config = {
   host: process.env.COXPIT_HOST ?? '127.0.0.1',

package/src/server.ts CHANGED Viewed

@@ -29,7 +29,7 @@ export async function buildServer(): Promise<FastifyInstance> {
   app.addHook('onRequest', authGate);
   // 무인증 헬스(외부 감시용)
-  app.get('/api/health', async () => ({ ok: true, name: 'coxpit', version: '2.2.1' }));
+  app.get('/api/health', async () => ({ ok: true, name: 'coxpit', version: '2.4.0' }));
   // 플릿 보드(단일 페이지). 인증 게이트 적용됨.
   app.get('/', async (_req, reply) => reply.type('text/html').send(BOARD_HTML));
@@ -96,12 +96,14 @@ export async function buildServer(): Promise<FastifyInstance> {
     const m = rows[0];
     if (!m) return reply.code(404).send({ error: 'not found' });
+    const agentBin = config.agent.bin;
     const cmd = [
       'echo GIT:$(git --version 2>&1)',
       'echo TMUX:$(tmux -V 2>&1)',
+      `echo AGENT:$(command -v ${shq(agentBin)} >/dev/null 2>&1 && ${shq(agentBin)} --version 2>/dev/null | head -1 || echo missing)`,
       'echo OS:$(uname -sr 2>&1)',
     ].join('; ');
-    const r = await runShellOn(m, cmd);
+    const r = await runShellOn(m, cmd, 20000);
     const pick = (key: string): string => {
       const line = r.stdout.split('\n').find((l) => l.startsWith(`${key}:`));
@@ -109,9 +111,12 @@ export async function buildServer(): Promise<FastifyInstance> {
     };
     const gitStr = pick('GIT');
     const tmuxStr = pick('TMUX');
+    const agentStr = pick('AGENT');
     const reachable = r.ok;
     const git = { ok: /git version/i.test(gitStr), version: gitStr };
     const tmux = { ok: /tmux \d/i.test(tmuxStr), version: tmuxStr };
+    // 에이전트 CLI 존재 여부(인증까지는 여기서 알 수 없음 — 첫 real run 이 판정)
+    const agent = { ok: agentStr !== '' && agentStr !== 'missing', version: agentStr, bin: agentBin };
     await db.update(machines)
       .set({ online: reachable, lastSeen: new Date() })
@@ -119,7 +124,7 @@ export async function buildServer(): Promise<FastifyInstance> {
     return {
       slug, reachable,
-      git, tmux, os: pick('OS'),
+      git, tmux, agent, os: pick('OS'),
       ready: reachable && git.ok && tmux.ok,
       error: reachable ? undefined : (r.stderr.trim() || `ssh exit ${r.code}`),
     };
@@ -367,7 +372,7 @@ export async function buildServer(): Promise<FastifyInstance> {
   // 라이브 스트림 좌석 — 오케스트레이터가 run/event 를 여기로 broadcast.
   app.get('/ws', { websocket: true }, (socket) => {
     addSink(socket);
-    socket.send(JSON.stringify({ type: 'hello', name: 'coxpit-fleet', version: '2.2.1' }));
+    socket.send(JSON.stringify({ type: 'hello', name: 'coxpit-fleet', version: '2.4.0' }));
     socket.on('close', () => removeSink(socket));
   });