@leftoff/cli 0.9.17 → 0.9.18-beta.2

package/ui/semdiff.js

@@ -83,8 +83,11 @@ export function readingOrder(steps, data) {
   return (steps || []).slice().sort((a, b) => ri(a) - ri(b) || tagRank(a) - tagRank(b) || (a.n || 0) - (b.n || 0))
 }
 // A repo the session changed that couldn't be read here: one quiet line each, never dropped silently
+// 2026-11-03 and what it left out because it was already changed before the session (baseNotes)
 export function unreadableLines(data) {
-  return data && Array.isArray(data.unreadable) ? data.unreadable.map((u) => (u && (u.line || (u.repo ? u.repo + ': not readable from here' + (u.why ? ' (' + u.why + ')' : '') : ''))) || '').filter(Boolean) : []
+  const un = data && Array.isArray(data.unreadable) ? data.unreadable.map((u) => (u && (u.line || (u.repo ? u.repo + ': not readable from here' + (u.why ? ' (' + u.why + ')' : '') : ''))) || '').filter(Boolean) : []
+  const bn = data && Array.isArray(data.baseNotes) ? data.baseNotes.map((n) => (n && typeof n.line === 'string' ? n.line : '')).filter(Boolean) : []
+  return un.concat(bn)
 }
 function unreadableHtml(data, { esc, icon }) {
   const ls = unreadableLines(data)
@@ -371,13 +374,14 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
     exportsHtml(ok, ui, { icon }) + '</div>' +
     '<button type="button" class="wt-x" data-action="wt-close" data-id="' + esc(sid) + '" aria-label="Close the walkthrough">' + icon('x') + '</button></div>'
   // 2026-10-30 the reading tools, a slim second row of the toolbar (the first stays one row): Next spot, Unified / Split
-  const tools = spotBtnHtml(ok && view === 'story' ? spotsFor(data, readingOrder(data.steps, data)).length : 0, ui.spot, { icon }) +
+  // 2026-11-03 This session · Whole folder, at the top of the story and the Files list alike
+  const tools = fileScopeSegHtml(data && data.fileScope, { esc, icon, action: 'wt-files', busy: !!ui.loading }) + spotBtnHtml(ok && view === 'story' ? spotsFor(data, readingOrder(data.steps, data)).length : 0, ui.spot, { icon }) +
     modeSegHtml(ok || (data && Array.isArray(data.files) && data.files.length), ui.split)
-  if (tools) h += '<div class="wt-r2" role="toolbar" aria-label="Reading tools">' + tools + '</div>'
+  if (tools) h += '<div class="wt-r2" role="toolbar" aria-label="Which changes and reading tools">' + tools + '</div>'
   // which model wrote it (Settings → Models → Walk me through it picks it)
   // the session's own agent couldn't (a Codex session, no transcript here, it didn't answer): said quietly, the reason in the tip
-  if (ok) h += '<p class="faint wt-by">Written by ' + (data.modelLabel ? esc(data.modelLabel) : 'your summarizer') + (when ? ' · ' + esc(when) : '') +
-    (data.path === 'fallback' ? ' · <span class="wt-path" tabindex="0" data-tip="' + esc('Not the session’s agent: ' + (data.pathWhy || 'it couldn’t be forked here')) + '">not the session’s agent</span>' : '') + '</p>'
+  if (ok) h += '<p class="faint wt-by">Written by ' + (data.modelLabel ? esc(data.modelLabel) : 'your summarizer') + (data.unavailable ? ' (Claude unavailable: ' + esc(data.unavailable) + ')' : '') + (when ? ' · ' + esc(when) : '') +
+    (data.path === 'fallback' && !data.unavailable ? ' · <span class="wt-path" tabindex="0" data-tip="' + esc('Not the session’s agent: ' + (data.pathWhy || 'it couldn’t be forked here')) + '">not the session’s agent</span>' : '') + '</p>'
   // 2026-10-30 a kept walkthrough for a diff that has moved on: said so, with Update (never shown as current)
   if (ok && data.stale) h += staleBarHtml(data.stale, { esc, icon, sid, loading: ui.loading })
   // nothing new since the last checkpoint: the whole session instead, and a quiet word saying so
@@ -394,6 +398,8 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
     // a small local model (under 7B) is the likely reason: one quiet line pointing at a better one
     if (data.status === 'fallback' && data.small) h += '<p class="faint wt-small">' + icon('info') + '<span>Small local models struggle here. Try Claude or qwen2.5-coder 7B in <a href="#/settings/models">Settings</a>.</span></p>'
   }
+  // 2026-11-03 switched to the other scope with nothing written for it: never a model run on its own; Write it is one tap
+  if (data && !ui.loading && data.status === 'none' && view === 'story') h += '<p class="wt-stale" role="status"><i class="wt-chg-g" aria-hidden="true"></i><span>' + (data.fileScope && data.fileScope.key === 'folder' ? 'No walkthrough of the whole folder yet.' : 'No walkthrough of this session’s changes yet.') + ' The files are under Files.</span><button type="button" class="linkish wt-upd" data-action="wt-update" data-id="' + esc(sid) + '">' + icon('refresh-cw') + 'Write it</button></p>'
   const deck = ok && view === 'story' && ui.deck !== false && (data.steps || []).length > 0 // 0.9.18 the slideshow
   if (ok && view === 'story' && !deck) {
     const steps = data.steps || []
@@ -444,6 +450,7 @@ export function walkthroughHtml({ s, data, ui, reviewed = new Set(), esc, icon,
   }
   let fl = ''
   if (!(ok && view === 'story') && data && Array.isArray(data.files) && data.files.length && !ui.loading) {
+    if (ok || !data.message) body += unreadableHtml(data, { esc, icon }) // 2026-11-03 what the scope left out, or the no-snapshot note
     if (data.files.length > 1) { fl = filesListHtml(data, { esc, icon }); body += filesListHtml(data, { esc, icon, mobile: true }) }
     body += filesHtml(data.files, { esc, icon })
   }
@@ -557,18 +564,63 @@ export function filesHtml(files, { esc, icon }) {
   const open = files.length <= 10
   return '<div class="wt-files-v">' + files.map((f, i) => {
     const what = f.hidden ? 'not shown (keys and env files never are)' : f.binary ? 'binary file' : f.generated ? 'generated or lockfile · ' + plural(f.add + f.del, 'line') : !f.lines ? (f.status === 'renamed' ? 'renamed, nothing changed inside' : 'no lines changed') : ''
-    return '<details class="wt-file" id="wt-f-' + i + '" data-file-i="' + i + '"' + (open && !what ? ' open' : '') + '><summary>' + icon('chevron-right', 'ic wt-g-chev') + statusHtml(f, { esc, icon }) + '<span class="mono wt-file-p">' + esc(f.repo && String(f.path).startsWith(f.repo + '/') ? f.repo + ' · ' + f.path.slice(f.repo.length + 1) : f.path) + '</span>' + (f.oldPath ? '<span class="faint wt-file-o">from ' + esc(f.oldPath) + '</span>' : '') +
+    return '<details class="wt-file' + (f.notSession ? ' nots' : '') + '" id="wt-f-' + i + '" data-file-i="' + i + '"' + (open && !what ? ' open' : '') + '><summary>' + icon('chevron-right', 'ic wt-g-chev') + statusHtml(f, { esc, icon }) + '<span class="mono wt-file-p">' + esc(f.repo && String(f.path).startsWith(f.repo + '/') ? f.repo + ' · ' + f.path.slice(f.repo.length + 1) : f.path) + '</span>' + (f.oldPath ? '<span class="faint wt-file-o">from ' + esc(f.oldPath) + '</span>' : '') + scopeTagHtml(f, { esc }) +
       '<span class="wt-file-n"><span class="wt-add">+' + n0(f.add) + '</span> <span class="wt-del">−' + n0(f.del) + '</span></span></summary>' +
       (what ? '<p class="faint wt-g-p">' + esc(what) + '</p>' : '<div class="wt-snip-d" data-file="' + i + '"></div>' + (f.clipped ? '<p class="faint wt-g-p">… too big to show all of it here</p>' : '')) + '</details>'
   }).join('') + '</div>'
 }
+// 2026-11-03 (asked: "should Files/Ask be scoped too? Or should it be a toggle?") Which files the
+// walkthrough, its Files view, What it did and Ask cover: This session (the default, only what the
+// session changed) or Whole folder (everything uncommitted, the rest marked "not from this
+// session"). The daemon cuts both the same way (Engine#scopeDiff); the choice is kept on this device.
+export const FILE_SCOPE_KEY = 'lo-file-scope'
+export function fileScopeStore(storage) {
+  return {
+    get() { try { return storage && storage.getItem(FILE_SCOPE_KEY) === 'folder' ? 'folder' : 'session' } catch { return 'session' } },
+    set(v) { try { if (!storage) return; if (v === 'folder') storage.setItem(FILE_SCOPE_KEY, 'folder'); else storage.removeItem(FILE_SCOPE_KEY) } catch {} },
+  }
+}
+// "This session 4 · Whole folder 24": a segmented toggle with each side's count. fs: the daemon's
+// { key, session, folder } (none from an older Mac, or with the snapshot rule off: no toggle).
+export function fileScopeSegHtml(fs, { esc, icon, action = 'wt-files', busy = false } = {}) {
+  if (!fs || typeof fs !== 'object' || fs.session == null || fs.folder == null) return ''
+  const key = fs.key === 'folder' ? 'folder' : 'session'
+  const n = (v) => '<span class="fsc-n" aria-hidden="true">' + esc(Number(v) || 0) + '</span>'
+  const one = (k, label, cnt, tip) => '<button type="button" data-action="' + esc(action) + '" data-files="' + k + '" aria-pressed="' + (key === k) + '" aria-label="' + esc(label + ', ' + (Number(cnt) || 0) + ' file' + (Number(cnt) === 1 ? '' : 's')) + '" data-tip="' + esc(tip) + '"' + (busy ? ' disabled' : '') + '>' + label + ' ' + n(cnt) + '</button>'
+  return '<div class="wt-seg wt-seg-sm fsc-seg" role="group" aria-label="Which changes">' +
+    one('session', 'This session', fs.session, 'Only what this session changed') +
+    one('folder', 'Whole folder', fs.folder, 'Everything uncommitted in the folder, other sessions’ changes too') + '</div>'
+}
+// The context line Ask puts above a question: "This session’s changes (4 files)" / "Whole folder (24 files)"
+export function scopeAskLine(data) {
+  const fs = data && data.fileScope
+  if (!fs || fs.session == null || fs.folder == null) return ''
+  const folder = fs.key === 'folder'
+  const k = Number(folder ? fs.folder : fs.session) || 0
+  const files = k + ' file' + (k === 1 ? '' : 's')
+  return folder ? 'Whole folder (' + files + ')' : 'This session’s changes (' + files + ')'
+}
+// the quiet per-file words: not from this session (Whole folder), or changed before it too
+export function scopeTagWords(f) {
+  if (!f) return ''
+  if (f.notSession) return 'not from this session'
+  if (f.preDirty === 'start') return 'only this session’s change'
+  if (f.preDirty === 'whole') return 'changed before this session too'
+  if (f.preDirty === 'before') return 'has changes from before this session'
+  return ''
+}
+export function scopeTagHtml(f, { esc }) {
+  const w = scopeTagWords(f)
+  if (!w) return ''
+  return f.notSession ? '<span class="wt-nots" data-tip="Changed in this folder, but not by this session"><i class="nots-g" aria-hidden="true"></i>not from this session</span>' : '<span class="wt-pre faint">' + esc(w) + '</span>'
+}
 // 0.9.18 (Joel): the Files view's list of files, beside the diff on a wide screen (each
 // scrolls on its own) and folded above it on a phone. Folders like the file map;
 // each file with its status by shape and its +/− count; a click opens that file's diff.
 function flFileHtml(it, { esc, icon, depth }) {
   const f = it.f
-  return '<a class="wt-fm-i wt-fl-i" href="#" data-action="wt-file" data-i="' + it.i + '"' + (depth ? ' data-d="' + Math.min(depth, 6) + '"' : '') + ' aria-label="' + esc(f.path + ', ' + statusWord(f).toLowerCase() + ', ' + f.add + ' added, ' + f.del + ' removed') + '">' +
-    statusHtml(f, { esc, icon }) + '<span class="wt-fm-f">' + esc(it.base) + '</span><span class="wt-fl-n" aria-hidden="true"><span class="wt-add">+' + n0(f.add) + '</span><span class="wt-del">−' + n0(f.del) + '</span></span></a>'
+  return '<a class="wt-fm-i wt-fl-i' + (f.notSession ? ' nots' : '') + '" href="#" data-action="wt-file" data-i="' + it.i + '"' + (depth ? ' data-d="' + Math.min(depth, 6) + '"' : '') + ' aria-label="' + esc(f.path + ', ' + statusWord(f).toLowerCase() + ', ' + f.add + ' added, ' + f.del + ' removed' + (scopeTagWords(f) ? ', ' + scopeTagWords(f) : '')) + '"' + (f.notSession ? ' data-tip="Not from this session"' : '') + '>' +
+    statusHtml(f, { esc, icon }) + '<span class="wt-fm-f">' + esc(it.base) + '</span>' + (f.notSession ? '<i class="nots-g" aria-hidden="true"></i>' : '') + '<span class="wt-fl-n" aria-hidden="true"><span class="wt-add">+' + n0(f.add) + '</span><span class="wt-del">−' + n0(f.del) + '</span></span></a>'
 }
 export function filesListHtml(data, { esc, icon, mobile = false }) {
   const files = (data && data.files) || []

package/ui/start.js

@@ -51,8 +51,36 @@ export function startPick(data, ui = {}) {
   const where = ui.where === 'worktree' && !(repo && repo.git === false) ? 'worktree' : 'repo'
   // Permissions: what you picked, else what this board last used for that Mac (kept on the Mac you're connected to), else Ask me
   const mode = START_MODES.some((x) => x.v === ui.mode) ? ui.mode : m && START_MODES.some((x) => x.v === m.lastMode) ? m.lastMode : 'default'
-  return { m, repo, where, mode, project, also, dropped, missing }
-}
+  // 0.9.17 Claude Code or Codex: what you picked (when that Mac has both), else what it used last, else the one it has
+  const ag = m && m.agents ? m.agents : null
+  const agent = !ag ? 'claude' : ag.choice && (ui.agent === 'claude' || ui.agent === 'codex') ? ui.agent : ag.last || (ag.claude ? 'claude' : ag.codex ? 'codex' : 'claude')
+  // 1.0 Mode: what you picked (when it's possible for that agent there), else what that Mac used last for the agent, else how Start ran it before
+  const rs = m && m.runs ? m.runs : null
+  const okRun = (r) => !!(rs && rs.options && rs.options[agent] && rs.options[agent][r] && rs.options[agent][r].ok)
+  const dflt = agent === 'codex' ? 'board' : 'headless'
+  const lastRun = rs && rs.last ? rs.last[agent] : null
+  const run = !rs ? dflt : START_RUNS.some((x) => x.v === ui.run) && okRun(ui.run) ? ui.run : okRun(lastRun) ? lastRun : okRun(dflt) ? dflt : (START_RUNS.find((x) => okRun(x.v)) || { v: dflt }).v
+  return { m, repo, where, mode, project, also, dropped, missing, agent, agents: ag, run, runs: rs }
+}
+// 1.0 where the agent runs (src/start-run.js)
+export const START_RUNS = Object.freeze([
+  { v: 'headless', label: 'Headless', sub: 'chat in Live, from any device', glyph: '◇' },
+  { v: 'board', label: 'Board terminal', sub: 'a terminal here and on your phone', glyph: '▭' },
+  { v: 'app', label: 'My terminal app', sub: 'Ghostty, iTerm or Terminal', glyph: '▣' },
+])
+export function startRunIntro(agent, run) {
+  const AG = agent === 'codex' ? 'Codex' : 'Claude Code'
+  if (run === 'board') return 'Leftoff starts ' + AG + ' in a terminal it keeps on the Mac you pick. It shows in the board and on your phone, and it keeps running when you close the tab.'
+  if (run === 'app') return 'Leftoff starts ' + AG + ' in a terminal it keeps on the Mac you pick, and opens it in your terminal app. Closing that window doesn’t stop it: Open in Terminal (or leftoff attach) brings it back.'
+  return 'Leftoff starts ' + AG + ' on the Mac you pick, with no terminal. It shows on every board right away: talk to it in Live, and approve its edits and commands in Needs you, from any device.'
+}
+export const AGENT_NAMES = Object.freeze({ claude: 'Claude Code', codex: 'Codex' })
+// 0.9.17 the Permissions cards in Codex's words (src/codex-start.js CODEX_MODES_TEXT)
+export const CODEX_MODE_SUBS = Object.freeze({
+  default: { sub: 'Codex’s own settings', text: 'Codex runs with your own Codex settings: it asks before anything its sandbox doesn’t allow. You answer in its terminal.' },
+  acceptEdits: { sub: 'edits in the folder, asks for the rest', text: 'Codex may edit files and run commands inside the folder (its workspace-write sandbox); anything outside it asks first, in its terminal.' },
+  auto: { sub: 'no asks, sandboxed to the folder', text: 'Codex never stops to ask: commands run inside the folder’s sandbox, and anything the sandbox blocks fails back to Codex instead of asking you.' },
+})
 export const ADD_DIRS_MAX = 8 // src/claude-headless.js
 
 // The body New session posts (src/session-start.js): a project start carries
@@ -60,6 +88,8 @@ export const ADD_DIRS_MAX = 8 // src/claude-headless.js
 // added (0.9.16) carries just those folders.
 export function startBody(pick, prompt, { draft = null, atts = [] } = {}) {
   const b = { machine: pick.m.machine, cwd: pick.repo.path, prompt, where: pick.where, mode: pick.mode }
+  if (pick.agents) b.agent = pick.agent // 0.9.17 (a Mac that didn't say which it has gets none: Claude Code, as before)
+  if (pick.runs) b.run = pick.run // 1.0 (an older Mac gets none: the way it always started)
   if (pick.project) Object.assign(b, { project: pick.project.id, addDirs: pick.also.map((r) => r.path) })
   else if (pick.also && pick.also.length) b.addDirs = pick.also.map((r) => r.path) // 0.9.16 + Add another repo
   const ids = (atts || []).filter((a) => a && a.id && a.status === 'done').map((a) => a.id) // 0.9.13
@@ -127,6 +157,17 @@ export function modePillHtml(s, { esc, seen = null }) {
   return ' <span class="mode-pill m-' + esc(m) + '" data-tip="' + esc('Permissions: ' + modeLabel(m) + (h.state === 'running' ? '' : ' (when it runs again)')) + '">' + esc(modeLabel(m)) + '</span>'
 }
 
+// 1.0 A session in one of Leftoff's terminals: where it runs, by shape and
+// words. ▣ a terminal app is attached; ◌ running · detached (nobody looking;
+// it keeps running, Go or Open in Terminal brings it back); nothing otherwise.
+export function termPillHtml(s, { esc }) {
+  const t = s && s.terminal
+  if (!t || t.kind !== 'leftoff' || !t.termId || s.endedAt) return ''
+  if (t.apps > 0) return ' <span class="term-pill t-app" data-tip="' + esc('Open in a terminal app (leftoff attach). Closing that window leaves it running.') + '"><span aria-hidden="true">▣</span> in a terminal app</span>'
+  if (t.detached) return ' <span class="term-pill t-detached" data-tip="' + esc('Its terminal is running with no window on it. Go shows it here; Open in Terminal attaches a window. Only Stop or Exit ends it.') + '"><span aria-hidden="true">◌</span> running · detached</span>'
+  return ''
+}
+
 // Is a path inside one of a Mac's approved folders (its real paths)?
 export function underApproved(p, approved) {
   const x = String(p || '')
@@ -160,8 +201,8 @@ const ago = (iso, now) => {
   return Math.round(s / 86400) + 'd ago'
 }
 
-function opt({ k, v, label, sub = '', on = false, disabled = false, esc }) {
-  return '<button type="button" class="start-opt" role="radio" aria-checked="' + on + '" data-action="start-pick" data-k="' + esc(k) + '" data-v="' + esc(v) + '"' + (disabled ? ' disabled' : '') + '>' +
+function opt({ k, v, label, sub = '', on = false, disabled = false, tip = '', esc }) {
+  return '<button type="button" class="start-opt" role="radio" aria-checked="' + on + '" data-action="start-pick" data-k="' + esc(k) + '" data-v="' + esc(v) + '"' + (disabled ? ' disabled' : '') + (tip ? ' data-tip="' + esc(tip) + '"' : '') + '>' +
     '<span class="start-opt-main">' + label + '</span>' + (sub ? '<span class="start-opt-sub">' + sub + '</span>' : '') + '</button>'
 }
 
@@ -169,6 +210,7 @@ function opt({ k, v, label, sub = '', on = false, disabled = false, esc }) {
 export function startAskLine(ask, { clock = (x) => x } = {}) {
   if (!ask) return null
   if (ask.state === 'pending') return { tone: 'wait', text: 'Waiting for a yes on ' + ask.machine + ' (until ' + clock(ask.expiresAt) + '). It shows on that Mac’s board and as a notification.' + (ask.firstTime ? ' A first time in a folder asks there, unless it’s inside a folder approved there.' : '') }
+  if (ask.state === 'starting' && ask.agent === 'codex') return { tone: 'wait', text: 'Codex is running in a terminal on ' + ask.machine + '. Its session opens here as soon as Codex writes it (after its first message).' }
   if (ask.state === 'starting') return { tone: 'wait', text: 'Starting on ' + ask.machine + '…' }
   if (ask.state === 'declined') return { tone: 'bad', text: 'Declined on ' + ask.machine + '.' }
   if (ask.state === 'expired') return { tone: 'bad', text: 'Nobody confirmed it on ' + ask.machine + ' in time.' }
@@ -179,8 +221,10 @@ export function startAskLine(ask, { clock = (x) => x } = {}) {
 export function startPageHtml(data, ui = {}, { esc, icon, emoji = () => '', local = true, now = Date.now(), clock = (x) => x, draft = '', busy = false, atts = null, chipHtml = null, mayProject = true } = {}) {
   const pick = startPick(data, ui)
   const rule = startRule(data, pick, { local })
+  const codex = pick.agent === 'codex'
+  const AG = AGENT_NAMES[pick.agent] || 'Claude Code'
   let h = '<a class="back" href="#/">← All sessions</a>' +
-    '<div class="pagehead"><div><h1>New session</h1><div class="sub">Leftoff starts Claude Code on the Mac you pick. It shows on every board right away: talk to it in Live, approve its edits and commands in Needs you.</div></div></div>'
+    '<div class="pagehead"><div><h1>New session</h1><div class="sub">' + esc(startRunIntro(pick.agent, pick.run)) + '</div></div></div>'
   h += '<div class="start" data-start>'
   // Mac
   const ms = (data && data.machines) || []
@@ -188,6 +232,20 @@ export function startPageHtml(data, ui = {}, { esc, icon, emoji = () => '', loca
     ms.map((x) => opt({ k: 'machine', v: x.machine, on: !!pick.m && x.machine === pick.m.machine, disabled: !x.online, esc,
       label: esc((emoji(x.machine) ? emoji(x.machine) + ' ' : '') + x.machine), sub: esc(x.here ? (local ? 'this Mac' : 'the Mac you’re connected to') : x.online ? 'online' : 'offline') })).join('') +
     '</div></section>'
+  // Agent (0.9.17): only when that Mac has both
+  if (pick.agents && pick.agents.choice) {
+    h += '<section class="start-sec start-agent"><h2 class="start-h">Agent</h2><div class="start-opts" role="radiogroup" aria-label="Agent">' +
+      opt({ k: 'agent', v: 'claude', on: !codex, esc, label: 'Claude Code', sub: 'Anthropic' }) +
+      opt({ k: 'agent', v: 'codex', on: codex, esc, label: 'Codex', sub: 'OpenAI' }) +
+      '</div></section>'
+  }
+  // Mode (1.0): headless, the board's terminal, or your terminal app; the ones that Mac can't do say why
+  if (pick.runs && pick.runs.options) {
+    const o = pick.runs.options[pick.agent] || {}
+    h += '<section class="start-sec start-run"><h2 class="start-h">Mode</h2><div class="start-opts" role="radiogroup" aria-label="Mode">' +
+      START_RUNS.map((x) => { const can = o[x.v] || { ok: true }; return opt({ k: 'run', v: x.v, on: x.v === pick.run, disabled: !can.ok, tip: can.ok ? '' : can.why || '', esc, label: '<span class="run-glyph" aria-hidden="true">' + x.glyph + '</span> ' + esc(x.label), sub: esc(can.ok ? x.sub : 'not on this Mac') }) }).join('') +
+      '</div></section>'
+  }
   // Project (0.9.12): only when there are projects
   const projects = (pick.m && pick.m.projects) || []
   if (projects.length) {
@@ -228,17 +286,17 @@ export function startPageHtml(data, ui = {}, { esc, icon, emoji = () => '', loca
   // Where
   h += '<section class="start-sec"><h2 class="start-h">Where</h2><div class="start-opts start-where" role="radiogroup" aria-label="Where">' +
     opt({ k: 'where', v: 'repo', on: pick.where === 'repo', esc, label: 'In the repo', sub: 'on its current branch' }) +
-    opt({ k: 'where', v: 'worktree', on: pick.where === 'worktree', esc, label: 'New worktree', sub: pick.repo && pick.repo.git === false ? 'needs a git repo' : 'its own branch and folder', disabled: !!(pick.repo && pick.repo.git === false) }) +
+    opt({ k: 'where', v: 'worktree', on: pick.where === 'worktree', esc, label: 'New worktree', sub: pick.repo && pick.repo.git === false ? 'needs a git repo' : codex ? 'Codex’s own worktree' : 'its own branch and folder', disabled: !!(pick.repo && pick.repo.git === false) }) +
     '</div></section>'
   // Permissions (0.9.9)
   const mo = START_MODES.find((x) => x.v === pick.mode) || START_MODES[0]
-  const moreText = mo.text + ' ' + TERMINAL_MODE_HINT // behind the (?): the cards' own lines say enough
+  const moreText = codex ? (CODEX_MODE_SUBS[mo.v] || CODEX_MODE_SUBS.default).text : mo.text + ' ' + TERMINAL_MODE_HINT // behind the (?): the cards' own lines say enough
   h += '<section class="start-sec"><h2 class="start-h start-h-help">Permissions' + helpQHtml({ id: 'start-mode-help', label: 'About Permissions', text: moreText, open: !!ui.helpOpen }, { esc }) + '</h2><div class="start-opts start-mode" role="radiogroup" aria-label="Permissions">' +
-    START_MODES.map((x) => opt({ k: 'mode', v: x.v, on: x.v === mo.v, esc, label: esc(x.label), sub: esc(x.sub) })).join('') +
+    START_MODES.map((x) => opt({ k: 'mode', v: x.v, on: x.v === mo.v, esc, label: esc(x.label), sub: esc(codex ? CODEX_MODE_SUBS[x.v].sub : x.sub) })).join('') +
     '</div>' + helpMoreHtml({ id: 'start-mode-help', text: moreText, open: !!ui.helpOpen, cls: 'start-hint start-mode-hint' }, { esc }) + '</section>'
   // First message
   h += '<section class="start-sec"><h2 class="start-h" id="start-msg-h">First message</h2><div class="start-box">' +
-    composerBoxHtml({ submit: 'start', sendAction: 'start-send', draftKey: 'start', draft, ...(Array.isArray(atts) ? { attach: true, atts, chipHtml, sid: START_SID } : {}), may: rule.ok && !ui.ask, busy, placeholder: 'What should Claude do?', label: 'First message', inputClass: 'start-text', keys: 'Enter Meta+Enter Control+Enter' }) +
+    composerBoxHtml({ submit: 'start', sendAction: 'start-send', draftKey: 'start', draft, ...(Array.isArray(atts) && !codex ? { attach: true, atts, chipHtml, sid: START_SID } : {}), may: rule.ok && !(ui.ask && ui.ask.state !== 'starting'), busy, placeholder: codex ? 'What should Codex do? (or leave it empty)' : 'What should Claude do?', label: 'First message', inputClass: 'start-text', keys: 'Enter Meta+Enter Control+Enter' }) +
     '</div><p class="start-rule' + (rule.ok ? '' : ' bad') + '" role="status">' + esc(rule.text) + '</p>'
   const line = startAskLine(ui.ask, { clock })
   if (line) h += '<div class="start-ask ' + line.tone + '" role="status">' + esc(line.text) + (ui.ask && ['declined', 'expired', 'failed'].includes(ui.ask.state) ? ' <button type="button" class="btn" data-action="start-again">Try again</button>' : '') + '</div>'
@@ -458,20 +516,37 @@ export function headlessBarHtml(s, { esc, icon, may = true, busy = null, local =
   if (!h) return ''
   const from = s.startedFrom && s.startedFrom.device ? ' from ' + s.startedFrom.device : ''
   const where = s.machine ? ' on ' + s.machine : ''
+  const agent = h.agent === 'codex' || s.codingAgent === 'codex' ? 'Codex' : 'Claude Code'
+  // 1.0 the same conversation in a terminal: Leftoff's own (a terminal app attaches to it on the Mac itself)
+  const cont = may && h.state !== 'stopping' && h.state !== 'resuming' ? continueButtonHtml(s, 'board', { esc }) : ''
   let text, btn = ''
-  if (h.state === 'running') { text = 'Running' + where + ', started' + from + ' by Leftoff' + (h.awake ? ' · keeping it awake' : ''); if (may) btn = '<button type="button" class="btn" data-action="headless-stop" data-id="' + esc(s.id) + '">' + icon('square') + 'Stop</button>' }
+  if (h.state === 'running') { text = 'Running' + where + ', started' + from + ' by Leftoff' + (h.awake ? ' · keeping it awake' : ''); if (may) btn = cont + '<button type="button" class="btn" data-action="headless-stop" data-id="' + esc(s.id) + '">' + icon('square') + 'Stop</button>' }
   else if (h.state === 'stopping') text = 'Stopping' + where + '…'
-  else if (h.state === 'resuming') text = 'Starting Claude Code' + where + '…' // 0.9.9: Resume on its way
+  else if (h.state === 'resuming') text = 'Starting ' + agent + where + '…' // 0.9.9: Resume on its way
   else {
     // 0.9.13: Paused (its process went: a restart, an exit) is still open; a message resumes it, as does Stopped
     text = (h.error ? 'Claude Code stopped' + where : h.state === 'paused' ? 'Paused' + where + (h.pausedWhy && h.pausedWhy !== 'restart' ? '' : ' (Leftoff restarted)') : 'Stopped' + where) + (from ? ', started' + from : '') + ' · a message picks it up'
-    if (may) btn = '<button type="button" class="btn primary" data-action="headless-run" data-id="' + esc(s.id) + '">' + icon('play') + 'Resume here</button>'
+    if (may) btn = cont + '<button type="button" class="btn primary" data-action="headless-run" data-id="' + esc(s.id) + '">' + icon('play') + 'Resume here</button>'
   }
   return '<div class="headless-bar ' + esc(h.state) + '" data-sid="' + esc(s.id) + '"><span class="grow">' + icon('play') + esc(text) + '</span>' + btn + '</div>' +
     (h.error && h.state !== 'running' ? '<pre class="headless-err" data-headless-err="' + esc(s.id) + '"></pre>' : '') +
     (h.state !== 'stopping' && h.state !== 'resuming' ? headlessModeHtml(s, { esc, may, busy, local, helpOpen }) : '')
 }
 
+// 1.0 Continue in terminal / Continue headless: one button, the same conversation the other way
+export function continueButtonHtml(s, run, { esc }) {
+  const label = run === 'headless' ? 'Continue headless' : 'Continue in terminal'
+  const tip = run === 'headless' ? 'Ends it in the terminal, then picks the same conversation up headless (Live). Only when it’s idle.' : 'Ends the headless process, then picks the same conversation up in a terminal of Leftoff’s. Only when it’s idle.'
+  return '<button type="button" class="btn run-continue" data-action="run-continue" data-run="' + esc(run) + '" data-id="' + esc(s.id) + '" data-tip="' + esc(tip) + '"><span class="run-glyph" aria-hidden="true">' + (run === 'headless' ? '◇' : '▭') + '</span>' + esc(label) + '</button>'
+}
+// The same for a session in Leftoff's own terminal (not headless): where it runs, and the way to headless
+export function termBarHtml(s, { esc, may = true } = {}) {
+  const t = s && s.terminal
+  if (!s || s.headless || s.endedAt || !t || t.kind !== 'leftoff' || !t.termId) return ''
+  const where = t.apps > 0 ? 'In a terminal app' : t.detached ? 'Running · detached' : 'In Leftoff’s terminal'
+  return '<div class="headless-bar term-bar" data-sid="' + esc(s.id) + '"><span class="grow"><span class="run-glyph" aria-hidden="true">' + (t.apps > 0 ? '▣' : t.detached ? '◌' : '▭') + '</span>' + esc(where + (s.machine ? ' on ' + s.machine : '')) + '</span>' + (may ? continueButtonHtml(s, 'headless', { esc }) : '') + '</div>'
+}
+
 // The session page's Permissions switch for a session Leftoff runs: the same
 // three as New session. Running, it switches Claude Code mid-session; stopped,
 // it's the mode Resume starts it in.

package/ui/term.js

@@ -171,7 +171,7 @@ async function loadLib() {
 }
 
 export function mountTerminal({ api, icon = () => '', toast = () => {}, context = () => null, openMenu = null, relayApi = () => (typeof window !== 'undefined' && window.leftoffRelay) || null } = {}) {
-  const st = { max: ls.get(MAX_KEY) === '1', open: false, info: null, tabs: [], active: ls.get(ACTIVE_KEY), views: new Map(), ghostty: undefined, ctrl: false, loading: false, listTimer: 0, sid: null }
+  const st = { max: ls.get(MAX_KEY) === '1', open: false, info: null, tabs: [], active: ls.get(ACTIVE_KEY), views: new Map(), ghostty: undefined, ghosttyPeek: undefined, ctrl: false, loading: false, listTimer: 0, sid: null }
   // 0.9.15 each session's own terminal tab (term-sess.js); st.sid: the session in view, if any
   let sess = null
   try { sess = createTermSessStore({ storage: window.localStorage }) } catch { sess = createTermSessStore({ storage: null }) }
@@ -694,6 +694,14 @@ export function mountTerminal({ api, icon = () => '', toast = () => {}, context
     try { st.ghostty = await api('GET', '/v1/term/theme/ghostty') } catch { st.ghostty = null }
     return st.ghostty
   }
+  // 1.0: the ⋯ menu only asks whether there is a Ghostty to match; Ghostty's own
+  // files (its app data on a Mac) are read when you pick it, not when the menu opens
+  async function peekGhostty() {
+    if (st.ghostty !== undefined) return st.ghostty
+    if (st.ghosttyPeek !== undefined) return st.ghosttyPeek
+    try { st.ghosttyPeek = await api('GET', '/v1/term/theme/ghostty?peek=1') } catch { st.ghosttyPeek = null }
+    return st.ghosttyPeek
+  }
   applyLook()
   if ((ls.get(THEME_KEY) || '') === 'ghostty') loadGhostty().then(applyLook)
   new MutationObserver(() => applyLook()).observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] })
@@ -701,7 +709,7 @@ export function mountTerminal({ api, icon = () => '', toast = () => {}, context
 
   // ---------- menu
   async function menuItems() {
-    const g = await loadGhostty()
+    const g = await peekGhostty()
     const cur = ls.get(THEME_KEY) || 'auto'
     const ctx = context() || null
     const items = []
@@ -713,7 +721,7 @@ export function mountTerminal({ api, icon = () => '', toast = () => {}, context
     items.push({ label: 'Run claude here', sub: ctx && ctx.sessionId ? 'in ' + (ctx.folder || 'this session’s folder') : 'in ~', icon: icon('terminal'), cls: 'one-line', attrs: { 'data-term-act': 'claude', 'data-tip': 'Runs claude in ' + where } })
     if (ctx && ctx.sessionId && ctx.resumable) items.push({ label: 'Resume this session', sub: ctx.resumeCmd || 'claude --resume', icon: icon('play'), cls: 'one-line', attrs: { 'data-term-act': 'resume', 'data-tip': (ctx.resumeCmd || 'claude --resume') + ' in ' + where } })
     items.push({ sep: true })
-    const choices = THEME_CHOICES.filter((k) => k !== 'ghostty' || (g && g.found && (g.theme || g.light || g.dark)))
+    const choices = THEME_CHOICES.filter((k) => k !== 'ghostty' || (g && g.found && (g.theme || g.light || g.dark || g.deferred)))
     items.push({ label: 'Theme', sub: themeLabel(cur, g), icon: icon('palette'), cls: 'one-line', whole: true, more: { title: 'Theme', items: choices.map((k) => ({ label: themeLabel(k, g), on: k === cur, cls: 'one-line', after: k === cur ? '<span class="lo-act-cur">current</span>' : '', attrs: { 'data-term-theme': k } })) } })
     return items
   }

package/ui/walk-pop.js

@@ -67,6 +67,9 @@ export function popContent(kind, { size = null, away = false } = {}) {
       ? { icon: 'circle-dashed', text: label + ' · no changes yet, so nothing to walk through', dim: true }
       : { icon: 'git-compare', text: label + ' · ' + plural(size.files, 'file') })
   }
+  // 2026-11-03 what was already changed when the session started isn't counted: said quietly
+  if (w && size.excluded > 0) lines.push({ icon: 'circle-dashed', text: plural(size.excluded, 'file') + ' changed before this session, left out', dim: true })
+  else if (w && size.fallback) lines.push({ icon: 'circle-dashed', text: 'Only the files this session edited', dim: true })
   if (size && size.writer) lines.push({ icon: 'bot', text: 'Written by ' + size.writer })
   return {
     title: 'Walk me through the changes',

package/ui/what-it-did.js

@@ -5,6 +5,7 @@
 // app.js) so they can be checked without a browser.
 import { icon } from './icons.js'
 import { diffBlocks, splitPath } from './diff-view.js'
+import { fileScopeSegHtml, scopeTagHtml, unreadableLines } from './semdiff.js' // 2026-11-03 This session · Whole folder, the walkthrough's own rule
 
 const esc = (s) => String(s == null ? '' : s).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]))
 const plural = (n, w) => n + ' ' + w + (n === 1 ? '' : 's')
@@ -63,12 +64,12 @@ export function fileRowHtml(f, ui, sid) {
   const bodyId = 'wid-f-' + esc(encodeURIComponent(f.path).replace(/%/g, '_'))
   const bar = '<span class="gd-bar" aria-hidden="true">' + diffBlocks(f.add, f.del).map((b) => '<i class="gd-b' + b + '"></i>').join('') + '</span>'
   const counts = f.binary ? '<span class="wid-n">binary</span>' : f.big ? '<span class="wid-n">big</span>' : '<span class="wid-add">+' + esc(f.add) + '</span> <span class="wid-del">−' + esc(f.del) + '</span>' + bar
-  let h = '<li class="wid-item' + (open ? ' open' : '') + '">'
+  let h = '<li class="wid-item' + (open ? ' open' : '') + (f.notSession ? ' nots' : '') + '">'
   h += '<button type="button" class="wid-row wid-file" data-action="wid-file" data-id="' + esc(sid) + '" data-path="' + esc(f.path) + '" aria-expanded="' + open + '" aria-controls="' + bodyId + '">'
   h += '<span class="wid-chev" aria-hidden="true">' + icon(open ? 'chevron-down' : 'chevron-right') + '</span>'
   h += '<span class="wid-st st-' + esc(f.status) + '" data-tip="' + esc(word) + '" aria-label="' + esc(word) + '">' + letter + '</span>'
   const [dir, base] = splitPath(f.path)
-  h += '<span class="wid-path mono">' + (dir ? '<span class="wid-dir">' + esc(dir) + '</span>' : '') + '<b class="wid-base">' + esc(base) + '</b></span><span class="wid-counts">' + counts + '</span></button>'
+  h += '<span class="wid-path mono">' + (dir ? '<span class="wid-dir">' + esc(dir) + '</span>' : '') + '<b class="wid-base">' + esc(base) + '</b>' + scopeTagHtml(f, { esc }) + '</span><span class="wid-counts">' + counts + '</span></button>'
   if (open) {
     const v = ui.files[f.path]
     h += '<div class="wid-out" id="' + bodyId + '">'
@@ -91,16 +92,22 @@ export function fileRowHtml(f, ui, sid) {
 
 function diffHtml(ui, sid) {
   const d = ui.diff
-  let h = '<div class="wid-sub"><h3>This folder’s changes</h3>'
+  // 2026-11-03 scoped like the walkthrough: This session (the default) or Whole folder, counts on both
+  const fsc = d && d.fileScope && d.fileScope.session != null ? d.fileScope : null
+  const title = fsc && fsc.key !== 'folder' ? 'This session’s changes' : 'This folder’s changes'
+  let h = '<div class="wid-sub"><h3>' + title + '</h3>'
   if (d && d.folder && !d.tooBig && !d.noRepo) h += '<span class="wid-meta">' + esc(d.folder) + (d.totals && d.totals.files ? ' · ' + plural(d.totals.files, 'file') + ' · <span class="wid-add">+' + esc(d.totals.add) + '</span> <span class="wid-del">−' + esc(d.totals.del) + '</span>' : '') + '</span>'
   h += '</div>'
+  if (fsc) h += '<div class="wid-scope">' + fileScopeSegHtml(fsc, { esc, icon, action: 'wid-files', busy: !!ui.loading }) + '</div>'
   if (ui.diffError) return h + '<p class="wid-note">' + esc(ui.diffError) + '</p>'
   if (!d) return h + '<p class="wid-note">Loading…</p>'
   if (d.tooBig) return h + '<p class="wid-note">Too big to show here.</p>'
   if (d.noRepo) return h + '<p class="wid-note">' + (d.noRepo === 'not_a_repo' ? 'This folder isn’t a git repository.' : d.noRepo === 'no_git' ? 'git isn’t installed on that Mac.' : 'This session’s folder isn’t there any more.') + '</p>'
-  if (!d.files || !d.files.length) return h + '<p class="wid-note">No uncommitted changes.</p>'
-  h += '<ul class="wid-list">' + d.files.map((f) => fileRowHtml(f, ui, sid)).join('') + '</ul>'
+  const notes = unreadableLines({ baseNotes: d.baseNotes }).map((l) => '<p class="wid-note wid-scope-n">' + icon('info') + '<span>' + esc(l) + '</span></p>').join('')
+  if (!d.files || !d.files.length) return h + notes + '<p class="wid-note">' + (fsc && fsc.key !== 'folder' ? (fsc.folder ? 'No uncommitted changes from this session (' + plural(fsc.folder, 'file') + ' in the whole folder).' : 'No uncommitted changes from this session.') : 'No uncommitted changes.') + '</p>'
+  h += notes + '<ul class="wid-list">' + d.files.map((f) => fileRowHtml(f, ui, sid)).join('') + '</ul>'
   if (d.truncated) h += '<p class="wid-note">Showing the first ' + d.files.length + ' of ' + esc(d.totals.files) + ' files.</p>'
+  if (fsc && fsc.key !== 'folder') return h + '<p class="wid-foot">Uncommitted changes this session made in its folder. Whole folder shows everything, other sessions’ changes too.</p>'
   return h + '<p class="wid-foot">Uncommitted changes in the session’s folder (staged, unstaged and new files). Other sessions in this folder show the same changes.</p>'
 }