@leftoff/cli 0.6.9 → 0.7.1

package/mod/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "leftoff",
-  "version": "0.6.9",
+  "version": "0.7.1",
   "description": "Leftoff (formerly Checkpoints): WTF was I working on? Tracks every Claude Code session on this machine, writes a 3-line checkpoint when one goes quiet, and adds /cp (checkpoint now), /cp-name and a /leftoff pane. Talks to the local Leftoff daemon on 127.0.0.1:7429 and falls back to writing markdown in ~/checkpoints.",
   "author": {
     "name": "Joel"

package/mod/hooks/core.js

@@ -284,10 +284,20 @@ const CP_ORDER = ['id', 'session_id', 'session_title', 'created_at', 'trigger',
 
 export function resumeCommand(session) {
   const id = session.id || session.sessionId
-  const cwd = session.cwd
+  const cwd = resumeDir(session)
   return (cwd ? 'cd ' + shArg(cwd) + ' && ' : '') + claudeInvocation(session, ['--resume', id])
 }
 
+// 0.7.1: where to run `claude --resume`: the session's folder, or, inside a git
+// worktree, that worktree's own top folder (Claude Code declines to re-enter a
+// `git worktree add` worktree from one of its subfolders; code.claude.com/docs/en/worktrees).
+export function resumeDir(session) {
+  const cwd = session && session.cwd
+  const wt = session && session.repo && session.repo.worktree
+  if (cwd && wt && typeof wt === 'string' && (cwd === wt || String(cwd).startsWith(wt.replace(/\/+$/, '') + '/'))) return wt
+  return cwd || null
+}
+
 // POSIX single quotes when needed (also right in fish).
 export function shArg(s) {
   const v = String(s)
@@ -494,7 +504,7 @@ const SESSION_ORDER = ['id', 'title', 'title_source', 'machine', 'cwd', 'repo',
 export const SESSION_EXTRA = ['inTurn', 'needsInput', 'backgroundTasks', 'turnsSinceCheckpoint', 'dormantStretch',
   'finalCheckpointDone', 'firstPrompt', 'lastPreview', 'lastNotification', 'lastEventAt', 'statusChanges', 'folder',
   'pid', 'tty', 'pidStartedAt', 'pidSource', 'term', 'closedAt', 'answers', 'lastNotificationMessage', 'needsInputAt', 'question', 'questionAt',
-  'startSource', 'historyTurns', 'healedAt', 'healedVia', 'archivedReason', 'backend', 'prLinks', 'prUnlinked']
+  'startSource', 'historyTurns', 'healedAt', 'healedVia', 'archivedReason', 'backend', 'prLinks', 'prUnlinked', 'todos', 'files', 'startRepo', 'editedRepos']
 
 export const SESSION_FIELDS = ['id', 'title', 'titleSource', 'machine', 'cwd', 'repo', 'transcriptPath', 'model', 'surface', 'capture',
   'status', 'startedAt', 'lastActivityAt', 'lastHeartbeatAt', 'endedAt', 'endReason', 'turns', 'lastCheckpointId',
@@ -745,7 +755,8 @@ export function checkpointDue(s, now, cfg = DEFAULT_CONFIG) {
 // "N empty sessions" row until their first prompt; the digest and restore skip them.
 export function isEmptySession(s, checkpointCount = 0) {
   if (!s) return true
-  return !(Number(s.turns) > 0) && !s.title && !(Number(checkpointCount) > 0) && !s.lastCheckpointId &&
+  // 0.7.1: a prompt counts. A long first turn (a worktree bug fix) has no completed turn yet.
+  return !(Number(s.turns) > 0) && !s.title && !s.firstPrompt && !(Number(checkpointCount) > 0) && !s.lastCheckpointId &&
     !(Number(s.historyTurns) > 0) && s.startSource !== 'resume'
 }
 

package/mod/hooks/register.js

@@ -27,7 +27,7 @@ const END_TIMEOUT_MS = 1000
 const MODEL_TIMEOUT_MS = 20000
 
 // Module state. $.state is not used: the pane redraws with $.ui.invalidate.
-const MOD_VERSION = '0.6.9' // keep in step with .claude-plugin/plugin.json
+const MOD_VERSION = '0.7.1' // keep in step with .claude-plugin/plugin.json
 
 const st = {
   internal: false,
@@ -828,6 +828,18 @@ function startReplyLoop($) {
   loop().catch(() => { st.replyLoop = false })
 }
 
+// 0.7.1: Claude moved (cd, or into a git worktree). Settings-hook payloads carry
+// the session's cwd and transcript path, which both follow it into a worktree
+// (code.claude.com/docs/en/worktrees), so pass them on when they change.
+function moved(e) {
+  const out = {}
+  const r = st.record || {}
+  if (e && typeof e.cwd === 'string' && e.cwd && e.cwd !== r.cwd) out.cwd = e.cwd
+  if (e && typeof e.transcript_path === 'string' && e.transcript_path && e.transcript_path !== r.transcriptPath) out.transcriptPath = e.transcript_path
+  if (out.cwd && st.hello) st.hello = { ...st.hello, cwd: out.cwd, repo: null } // a hello said again says where it is now
+  return out
+}
+
 export function register(on, options) {
   on('session.start', async ($, e, next) => {
     try {
@@ -890,7 +902,7 @@ export function register(on, options) {
   })
 
   on('classic.UserPromptSubmit', async ($, e, next) => {
-    await sendOrSpool($, 'activity', { kind: 'prompt', prompt: clip(e.prompt || '', 300), sessionTitle: e.session_title && e.session_title === st.tabTitle ? null : e.session_title }) // our own /rename isn't a name you chose
+    await sendOrSpool($, 'activity', { kind: 'prompt', prompt: clip(e.prompt || '', 300), sessionTitle: e.session_title && e.session_title === st.tabTitle ? null : e.session_title, ...moved(e) }) // our own /rename isn't a name you chose
     return next(e)
   })
 
@@ -920,6 +932,7 @@ export function register(on, options) {
     // board's card offers "Claude wrote a 7-step list · Save". Nothing is saved here.
     const listHint = listHintFrom(e.last_assistant_message || '', { fallback: st.daemonTitle || null })
     await sendOrSpool($, 'turn_completed', {
+      ...moved(e),
       lastAssistantPreview: clip(e.last_assistant_message || '', 280),
       question: trailingQuestion(e.last_assistant_message || ''),
       ...(listHint ? { listHint } : {}),
@@ -937,13 +950,18 @@ export function register(on, options) {
   })
 
   on('classic.Notification', async ($, e, next) => {
-    await sendOrSpool($, 'notification', { notificationType: e.notification_type || null, message: clip(e.message || '', 200) })
+    await sendOrSpool($, 'notification', { notificationType: e.notification_type || null, message: clip(e.message || '', 200), ...moved(e) })
     return next(e)
   })
 
   on('classic.PermissionRequest', permissionHook)
 
-  on('classic.PostToolUse', async ($, e, next) => { await toolRan($, e); return next(e) })
+  on('classic.PostToolUse', async ($, e, next) => {
+    await toolRan($, e)
+    const m = moved(e) // EnterWorktree, or a cd: say so now, not at the end of the turn
+    if (m.cwd || m.transcriptPath) await sendOrSpool($, 'activity', { kind: 'cwd', ...m })
+    return next(e)
+  })
 
   on('classic.PostToolUseFailure', async ($, e, next) => { await toolRan($, e); return next(e) })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leftoff/cli",
-  "version": "0.6.9",
+  "version": "0.7.1",
   "description": "Leftoff: WTF was I working on? Tracks every Claude Code session, writes a 3-line checkpoint when one goes quiet, and gives you a daily digest and a board, on your Mac and (optionally) your phone.",
   "keywords": [
     "claude",

package/ui/app.css

@@ -342,6 +342,9 @@ h2 .count { color: var(--faint); font-weight: 500; }
 .repomore .opt[hidden] { display: none; }
 .chip.repo-link { cursor: pointer; font: inherit; font-family: var(--mono); font-size: 11.5px; }
 .chip.repo-link:hover { color: var(--text); border-color: var(--line-strong); }
+/* 0.7.1: git worktree marker and "started in" */
+.chip.wt { color: var(--text2); max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.chip.started-in { color: var(--muted); border-style: dashed; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 .linkish { background: none; border: 0; padding: 0; color: var(--accent); cursor: pointer; font: inherit; }
 .linkish:hover { text-decoration: underline; }
 .digest-repos { margin: 0 0 14px; }
@@ -1441,3 +1444,81 @@ a.cpr:hover { border-color: var(--line-strong); }
 .stat.on { border-color: var(--accent); box-shadow: inset 0 0 0 1px var(--accent), var(--card-shadow); background: color-mix(in srgb, var(--accent) 12%, var(--card)); }
 .stat.on .n { color: var(--accent); }
 .stat.on .k { color: var(--text); }
+
+/* ---- To do and Files (0.7.0) ---- */
+.todo-subcount { font-size: 13px; font-weight: 500; color: var(--yellow); background: var(--tint-yellow); border-radius: 999px; padding: 2px 9px; margin-left: 6px; vertical-align: middle; }
+.stat .todo-subn { display: inline-block; margin-left: 6px; font-size: 11px; font-weight: 500; color: var(--yellow); vertical-align: middle; white-space: nowrap; }
+.todos-sec { margin-top: 18px; }
+.todo-head h2 { color: var(--yellow); }
+.todo-head .count { background: var(--yellow); color: #1a1405; }
+.todo-group { background: var(--card); border: 1px solid var(--line); border-radius: var(--radius); padding: 10px 12px; margin-top: 10px; }
+.todo-sess { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; font-size: 13px; color: var(--muted); margin-bottom: 4px; }
+.todo-sess a { color: var(--text2); text-decoration: none; font-weight: 600; }
+ul.todos { list-style: none; margin: 0; padding: 0; }
+li.todo { display: flex; gap: 10px; align-items: flex-start; padding: 8px 0; border-top: 1px solid var(--line); }
+.todo-group li.todo:first-child, .stodos li.todo:first-child { border-top: 0; }
+li.todo.ticked { opacity: .45; }
+li.todo.ticked .todo-text { text-decoration: line-through; }
+.todo-check { position: relative; flex: none; width: 24px; height: 24px; margin-top: 1px; cursor: pointer; }
+.todo-check input { position: absolute; inset: 0; width: 100%; height: 100%; margin: 0; opacity: 0; cursor: pointer; }
+.todo-check .box { display: block; width: 22px; height: 22px; border: 2px solid var(--line-strong); border-radius: 6px; background: var(--field); }
+.todo-check input:checked + .box { background: var(--green); border-color: var(--green); }
+.todo-check input:focus-visible + .box { box-shadow: 0 0 0 3px var(--focus); }
+.todo-main { min-width: 0; flex: 1; }
+.todo-text { color: var(--text); font-size: 14.5px; line-height: 1.4; overflow-wrap: anywhere; }
+.todo-text code, .todo-code code { font-family: var(--mono); font-size: 12.5px; }
+.todo-codes { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 6px; }
+.todo-code { display: inline-flex; align-items: center; gap: 8px; max-width: 100%; background: var(--bg2); border: 1px solid var(--line); border-radius: 8px; padding: 4px 8px; color: var(--text2); cursor: pointer; font: inherit; }
+.todo-code code { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
+.todo-code .todo-cp { flex: none; font-size: 11.5px; color: var(--accent); }
+.todo-meta { margin-top: 3px; font-size: 12px; color: var(--faint); }
+.todo-add { display: flex; gap: 8px; margin-top: 10px; }
+.todo-add input { flex: 1; min-width: 0; font-size: 16px; padding: 9px 12px; border-radius: 10px; border: 1px solid var(--line); background: var(--field); color: var(--text); }
+.todo-add input:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px var(--focus); }
+.handoff-chips { display: flex; flex-wrap: wrap; gap: 6px; margin: 8px 0 2px; }
+.handoff-chips .chip { text-decoration: none; }
+.chip.todochip { color: var(--yellow); border-color: color-mix(in srgb, var(--yellow) 35%, transparent); background: var(--tint-yellow); }
+.chip.fileschip { color: var(--cyan); border-color: color-mix(in srgb, var(--cyan) 35%, transparent); background: var(--tint-cyan); }
+.closed-head { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.chip.docs-filter { cursor: pointer; font: inherit; font-size: 13px; padding: 5px 12px; }
+.chip.docs-filter[aria-pressed="true"] { color: var(--cyan); border-color: var(--cyan); background: var(--tint-cyan); }
+ul.files-list { list-style: none; margin: 0; padding: 0; border: 1px solid var(--line); border-radius: var(--radius); background: var(--card); overflow: hidden; }
+ul.files-list li + li { border-top: 1px solid var(--line); }
+.f-row { display: flex; align-items: center; gap: 10px; width: 100%; padding: 11px 12px; background: none; border: 0; color: var(--text); font: inherit; text-align: left; text-decoration: none; cursor: pointer; }
+.f-row:hover { background: var(--subtle); }
+.f-ic { flex: none; min-width: 38px; text-align: center; font-size: 10px; font-weight: 700; letter-spacing: .03em; color: var(--muted); border: 1px solid var(--line); border-radius: 6px; padding: 3px 4px; }
+.f-ic.art { color: var(--accent); font-size: 13px; padding: 1px 4px; }
+.f-name { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 14px; }
+.f-name.mono { font-family: var(--mono); font-size: 13px; }
+.f-kind { flex: none; font-size: 12px; color: var(--muted); }
+.f-kind.new { color: var(--green); }
+.f-at { flex: none; font-size: 12px; color: var(--faint); }
+.f-code { margin: 8px 2px 0; font-size: 13px; }
+.doc-viewer { position: fixed; inset: 0; z-index: 60; background: rgba(0,0,0,.55); display: flex; align-items: stretch; justify-content: center; padding: max(16px, env(safe-area-inset-top)) 12px 12px; }
+.doc-viewer[hidden] { display: none; }
+html.dv-open, html.dv-open body { overflow: hidden; }
+.dv-sheet { width: 100%; max-width: 820px; background: var(--bg); border: 1px solid var(--line); border-radius: var(--radius); display: flex; flex-direction: column; overflow: hidden; }
+.dv-head { display: flex; align-items: center; gap: 10px; padding: 12px 14px; border-bottom: 1px solid var(--line); }
+.dv-title { flex: 1; min-width: 0; font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dv-x { flex: none; width: 36px; height: 36px; border-radius: 10px; border: 1px solid var(--line); background: var(--bg2); color: var(--text); font-size: 20px; line-height: 1; cursor: pointer; }
+.dv-sub { padding: 6px 14px 0; font-size: 12px; }
+.dv-body { flex: 1; overflow: auto; padding: 8px 16px 24px; -webkit-overflow-scrolling: touch; }
+.doc-md { font-size: 15px; line-height: 1.55; color: var(--text2); overflow-wrap: anywhere; }
+.doc-md h2, .doc-md h3, .doc-md h4 { color: var(--text); margin: 18px 0 8px; }
+.doc-md h2, .doc-md h3, .doc-md h4 { text-transform: none; letter-spacing: normal; }
+.doc-md h2 { font-size: 20px; } .doc-md h3 { font-size: 17px; } .doc-md h4 { font-size: 15px; }
+.doc-md code { font-family: var(--mono); font-size: 13px; background: var(--bg2); border-radius: 5px; padding: 1px 5px; }
+.doc-md pre.doc-code, .doc-pre { background: var(--bg2); border: 1px solid var(--line); border-radius: 10px; padding: 10px 12px; overflow: auto; font-family: var(--mono); font-size: 12.5px; line-height: 1.45; white-space: pre; }
+.doc-md pre.doc-code code { background: none; padding: 0; }
+.doc-md blockquote { margin: 10px 0; padding: 2px 12px; border-left: 3px solid var(--line-strong); color: var(--muted); }
+.doc-md li.sub { margin-left: 18px; }
+.doc-md li.task { list-style: none; margin-left: -18px; }
+.doc-md .tbox { display: inline-block; width: 13px; height: 13px; border: 1.5px solid var(--line-strong); border-radius: 3px; margin-right: 7px; vertical-align: -1px; }
+.doc-md .tbox.on { background: var(--green); border-color: var(--green); }
+.doc-table { overflow-x: auto; }
+.doc-md table { border-collapse: collapse; font-size: 13.5px; }
+.doc-md table { overflow-wrap: normal; word-break: normal; }
+.doc-md th { white-space: nowrap; }
+.doc-md th, .doc-md td { border: 1px solid var(--line); padding: 5px 8px; text-align: left; }
+.doc-img { text-align: center; padding-top: 10px; }
+.doc-img img { max-width: 100%; height: auto; border-radius: 8px; background: #fff; }

package/ui/app.js

@@ -9,6 +9,7 @@ import { needsItems, needsStrip, needPanel, agentNeedPanel, httpsOnly, agentRepl
 import { SUMMARY_EXAMPLES, LENGTH_CHOICES } from './summary-examples.js'
 import { mdInline, renderSection } from './changelog-md.js'
 import { cardPrsHtml, sessionPrsSection, prsPageHtml } from './prs.js'
+import { todosSection, sessionTodosSection, cardHandoffChips, sessionFilesSection, docViewerBody, docDownloadHref } from './handoffs.js'
 const $app = document.getElementById('app')
 const state = { sessions: [], health: null, cfg: null, route: null, machine: localStorage.getItem('cp.machine') || '', drafts: {}, pendingAsk: {}, mayAnswer: true, needOpen: {}, needTurns: {} }
 const multi = () => !!(state.health && state.health.machines && state.health.machines.length > 1)
@@ -138,11 +139,20 @@ function agentChip(a, { title } = {}) {
   return '<span class="chip machine agent' + (a.ok === false ? ' stale' : '') + '" title="' + esc(title || ('external agent · ' + (a.pullsHere ? 'pulled by this Mac' : 'pulled by ' + (a.puller || 'another Mac')) + (a.lastSuccessAt ? ' · last pull ' + ago(a.lastSuccessAt) : ''))) + '">' + esc(a.icon || '◆') + ' ' + esc(a.display || a.name) + '</span>'
 }
 
+// 0.7.1: a session in a git worktree says which ("⑂ fix-login"); one filed
+// where its edits went says where it started.
+function wtChips(s) {
+  let h = ''
+  if (s.worktree && s.worktree.name) h += '<span class="chip mono wt" title="' + esc('git worktree · ' + (s.worktree.path || s.worktree.name)) + '">⑂ ' + esc(s.worktree.name) + '</span>'
+  if (s.startedIn) h += '<span class="chip started-in" title="' + esc('Started in ' + s.startedIn + '; its edits went to ' + (s.repoLabel || s.repoName || 'this repo')) + '">started in ' + esc(s.startedIn) + '</span>'
+  return h
+}
+
 function where(s) {
   if (s.agent) return (s.project ? '<button type="button" class="chip mono repo-link" data-action="repo" data-repo="' + esc(s.repoLabel) + '" data-key="' + esc(s.repoKey || '') + '" title="' + esc(s.repoLabel + ' · show only this project') + '">' + esc(s.repoLabel) + '</button>' : '') + agentChip(s.agent)
   const branch = s.repo && s.repo.branch
   const label = s.repoLabel || s.repoName || 'no repo'
-  return '<button type="button" class="chip mono repo-link" data-action="repo" data-repo="' + esc(label) + '" data-key="' + esc(s.repoKey || '') + '" title="' + esc((s.repoKey || label) + ' · show only this repo') + '">' + esc(label) + (branch ? ' · ' + esc(branch) : '') + '</button>' +
+  return '<button type="button" class="chip mono repo-link" data-action="repo" data-repo="' + esc(label) + '" data-key="' + esc(s.repoKey || '') + '" title="' + esc((s.repoKey || label) + ' · show only this repo') + '">' + esc(label) + (branch ? ' · ' + esc(branch) : '') + '</button>' + wtChips(s) +
     (multi() || !s.isLocal ? '<span class="chip machine' + (s.isLocal ? '' : ' remote') + '" title="' + (s.isLocal ? 'this machine' : 'synced from another machine') + '">⌂ ' + esc(s.machine) + '</span>' : '') + modelChip(s)
 }
 
@@ -298,7 +308,7 @@ function card(s) {
     '</div>' + pill(s.status) + '</div>' +
     '<div class="meta">' + spaceChip(s) + where(s) + (ln ? '<span class="livenote ' + esc(s.live) + '">' + esc(ln) + '</span>' : '') + (endedNote ? '<span>' + esc(endedNote) + '</span>' : '') + '<span>·</span><span>' + esc(s.turns) + (s.turns === 1 ? ' turn' : ' turns') + (s.historyTurns ? ' · resumed (' + esc(s.historyTurns) + ' before)' : s.startSource === 'resume' && !s.turns ? ' · resumed' : s.empty && s.live !== 'closed' ? ' · no prompt yet' : '') + '</span>' +
       (s.needsInput && s.lastNotification && !s.needsYou ? '<span class="chip">' + esc(s.lastNotification.replace(/_/g, ' ')) + '</span>' : '') + '</div>' +
-    cardPrsHtml(s.prs) + listChips(s) + nb + cpBlock(s.latestCheckpoint) +
+    cardPrsHtml(s.prs) + listChips(s) + cardHandoffChips(s) + nb + cpBlock(s.latestCheckpoint) +
     '<a class="cplink" href="#/s/' + encodeURIComponent(s.id) + '">' + (s.checkpointCount ? s.checkpointCount + (s.checkpointCount === 1 ? ' checkpoint' : ' checkpoints') : 'Session history') + ' →</a>' +
     '<div class="actions-row">' + goButton(s) +
       '<button type="button" class="btn" data-action="resume">Copy resume</button>' +
@@ -371,7 +381,7 @@ function chipBar(chips, selected, allCount, emptyNote) {
 async function viewBoard() {
   if (!state.health) await refreshHealth()
   if (state.health && state.health.update && state.health.update.available && !state.updates) { try { state.updates = await api('GET', '/v1/updates') } catch {} }
-  const { sessions, viewer, closedCount } = await api('GET', '/v1/sessions?limit=200' + (state.machine ? '&machine=' + encodeURIComponent(state.machine) : ''))
+  const { sessions, viewer, closedCount, todoCount } = await api('GET', '/v1/sessions?limit=200' + (state.machine ? '&machine=' + encodeURIComponent(state.machine) : ''))
   state.sessions = sessions
   state.viewerLocal = viewer ? viewer.local !== false : true
   state.ghostty = viewer ? viewer.ghostty === true : false
@@ -414,8 +424,10 @@ async function viewBoard() {
   // Needs you (v0.4.4): every session waiting on you, whatever the filters, longest wait first.
   const needs = needsItems(sessions)
   html += needsStrip(needs, needOpts())
+  // 0.7.0: open to-dos are their own sub-count, not part of the Needs you number
+  const todoN = f.repos.length || sp ? inRepos.reduce((n, s) => n + ((s.todos && s.todos.length) || 0), 0) : (todoCount || 0)
   html += '<div class="stats">' + Object.entries(FILTERS).map(([k, fl]) =>
-    '<button type="button" class="stat' + (filter === k ? ' on' : '') + '" data-action="filter" data-filter="' + k + '" aria-pressed="' + (filter === k) + '" title="' + esc(filter === k ? 'Showing ' + fl.label.toLowerCase() + ' · tap to show all' : 'Show ' + fl.label.toLowerCase()) + '"><div class="n">' + count(k) + '</div><div class="k"><span class="pill ' + fl.cls + '" aria-hidden="true"></span>' + esc(fl.label) + '</div></button>').join('') + '</div>'
+    '<button type="button" class="stat' + (filter === k ? ' on' : '') + '" data-action="filter" data-filter="' + k + '" aria-pressed="' + (filter === k) + '" title="' + esc(filter === k ? 'Showing ' + fl.label.toLowerCase() + ' · tap to show all' : 'Show ' + fl.label.toLowerCase()) + '"><div class="n">' + count(k) + (k === 'needs' && todoN ? '<span class="todo-subn" title="To-dos handed back to you (not counted as waiting)">' + todoN + (todoN === 1 ? ' to-do' : ' to-dos') + '</span>' : '') + '</div><div class="k"><span class="pill ' + fl.cls + '" aria-hidden="true"></span>' + esc(fl.label) + '</div></button>').join('') + '</div>'
   html += spaceTabs(spaces, sp, spCounts, 'board-space', allShown.length)
   if (filter === 'closed') {
     html += await closedSection(f, sp)
@@ -443,10 +455,11 @@ async function viewBoard() {
 // a search box and Show more. Each card has its last checkpoint and Resume,
 // which reopens it in a new Ghostty tab (claude --resume) on the Mac that owns it.
 const CLOSED_PAGE = 30
-const closedUi = { q: '', limit: CLOSED_PAGE, data: null, seq: 0, timer: null, busy: new Set() }
+const closedUi = { q: '', limit: CLOSED_PAGE, data: null, seq: 0, timer: null, busy: new Set(), docs: false }
 function closedQuery(f, sp) {
   const qs = new URLSearchParams({ limit: String(closedUi.limit) })
   if (closedUi.q.trim()) qs.set('q', closedUi.q.trim())
+  if (closedUi.docs) qs.set('docs', '1')
   if (state.machine) qs.set('machine', state.machine)
   if (f.repos.length) qs.set('repo', f.repos.join(','))
   if (sp) qs.set('space', sp)
@@ -461,12 +474,14 @@ async function closedFetch(f, sp) {
 async function closedSection(f, sp) {
   const r = await closedFetch(f, sp)
   return chipBar(r.repos.map((c) => ({ ...c, count: c.total })), f.repos, r.total, 'nothing closed yet') +
-    '<div class="closed-head"><div class="set-search closed-search">' + icon('search') + '<input id="closedQ" type="search" placeholder="Search closed sessions" aria-label="Search closed sessions" autocomplete="off" autocapitalize="off" spellcheck="false" value="' + esc(closedUi.q) + '"></div></div>' +
+    '<div class="closed-head"><div class="set-search closed-search">' + icon('search') + '<input id="closedQ" type="search" placeholder="Search closed sessions" aria-label="Search closed sessions" autocomplete="off" autocapitalize="off" spellcheck="false" value="' + esc(closedUi.q) + '"></div>' +
+      '<button type="button" class="chip docs-filter" data-action="closed-docs" aria-pressed="' + closedUi.docs + '" title="Only sessions that made docs, plans or artifacts">' + (closedUi.docs ? '✓ ' : '') + 'Docs &amp; artifacts</button></div>' +
     '<div id="closedList">' + closedListHtml(r, f, sp) + '</div>'
 }
 function closedListHtml(r, f, sp) {
   if (!r.sessions.length) {
     const inWhat = (f.repos.length ? ' in ' + f.repos.join(', ') : '') + (sp ? ' in ' + sp : '')
+    if (closedUi.docs && !closedUi.q.trim()) return '<div class="empty mt">No closed sessions with docs or artifacts' + esc((f.repos.length ? ' in ' + f.repos.join(', ') : '') + (sp ? ' in ' + sp : '')) + ' yet. <button type="button" class="linkish" data-action="closed-clear">Clear</button></div>'
     return '<div class="empty mt">' + (closedUi.q.trim() ? 'No closed sessions match “' + esc(closedUi.q.trim()) + '”' + esc(inWhat) + '.' : 'No closed sessions' + esc(inWhat) + ' yet.') +
       (f.repos.length || sp || closedUi.q ? ' <button type="button" class="linkish" data-action="closed-clear">Clear</button>' : '') + '</div>'
   }
@@ -494,10 +509,10 @@ function closedCard(s, viewer) {
   return '<article class="card ended is-closed closed-card" data-id="' + esc(s.id) + '" data-href="' + esc(href) + '">' +
     '<div class="row1"><div class="title"><a href="' + href + '">' + esc(s.title || 'Untitled session') + '</a></div><span class="pill s-closed">closed</span></div>' +
     '<div class="meta">' + (s.space && s.space !== s.machine ? spaceChip(s) : '') +
-      '<button type="button" class="chip mono repo-link" data-action="repo" data-repo="' + esc(label) + '" data-key="' + esc(s.repoKey || '') + '" title="' + esc((s.repoKey || label) + ' · show only this repo') + '">' + esc(label) + (branch ? ' · ' + esc(branch) : '') + '</button>' +
+      '<button type="button" class="chip mono repo-link" data-action="repo" data-repo="' + esc(label) + '" data-key="' + esc(s.repoKey || '') + '" title="' + esc((s.repoKey || label) + ' · show only this repo') + '">' + esc(label) + (branch ? ' · ' + esc(branch) : '') + '</button>' + wtChips(s) +
       '<span class="chip machine' + (s.isLocal ? '' : ' remote') + '" title="' + (s.isLocal ? 'this machine' : 'another machine') + '">⌂ ' + esc(s.machine) + '</span>' + modelChip(s) +
       '<span title="' + esc(clock(s.endedAt)) + '">ended ' + esc(ago(s.endedAt)) + '</span><span>·</span><span>' + esc(s.turns) + (s.turns === 1 ? ' turn' : ' turns') + '</span></div>' +
-    cpBlock(s.latestCheckpoint, { showWhen: false }) +
+    cardHandoffChips(s) + cpBlock(s.latestCheckpoint, { showWhen: false }) +
     '<div class="actions-row">' + resumeButton(s, viewer) +
       '<button type="button" class="btn" data-action="resume" data-id="' + esc(s.id) + '">Copy resume</button>' +
       '<a class="btn" href="' + href + '">' + (s.checkpointCount ? s.checkpointCount + (s.checkpointCount === 1 ? ' checkpoint' : ' checkpoints') : 'Details') + ' →</a>' +
@@ -536,7 +551,7 @@ async function resumeOpen(btn, id) {
   btn.disabled = true; btn.textContent = 'Opening…'
   try {
     const r = await api('POST', '/v1/sessions/' + encodeURIComponent(id) + '/resume', {}, { timeoutMs: 60000 })
-    toast(r.peer ? 'Resumed on ' + r.peer + ' in a new Ghostty tab' : 'Resumed in a new Ghostty tab')
+    toast(r.note ? r.note : r.peer ? 'Resumed on ' + r.peer + ' in a new Ghostty tab' : 'Resumed in a new Ghostty tab', r.note ? 6000 : undefined)
     return true
   } catch (e) {
     toast(e.message, 6000)
@@ -614,11 +629,14 @@ async function viewWaiting() {
   const f = boardFilter()
   const shownSessions = applyFilter(all.map((n) => n.session), { repos: f.repos })
   const items = all.filter((n) => shownSessions.includes(n.session))
-  let html = '<div class="pagehead"><div><h1>Needs you</h1><div class="sub">Permission prompts and questions waiting on you, longest wait first. Answer here, or Go to the terminal.' +
+  const todoOv = needs.todos || { open: [], done: [] }
+  const nTodos = (todoOv.open || []).length
+  let html = '<div class="pagehead"><div><h1>Needs you' + (nTodos ? ' <span class="todo-subcount">' + nTodos + (nTodos === 1 ? ' to-do' : ' to-dos') + '</span>' : '') + '</h1><div class="sub">Permission prompts and questions waiting on you, longest wait first. Answer here, or Go to the terminal.' +
     (state.mayAnswer ? '' : ' Answering from this device is off.') + '</div></div></div>'
   html += chipBar(repoChips(all.map((n) => n.session)), f.repos, all.length, 'nothing waiting')
   if (!items.length) html += '<div class="empty mt"><p><strong>Nothing waiting on you.</strong></p><p>When a session asks for permission or asks you a question, it shows up here and at the top of the board.' + (f.repos.length && all.length ? ' (' + all.length + ' in other repos. <button type="button" class="linkish" data-action="clear-filters">Show all</button>)' : '') + '</p></div>'
   else html += '<section class="needs-strip quiet mt" aria-label="Waiting"><div class="needs-list">' + items.map((n) => needPanel(n, needOpts())).join('') + '</div></section>'
+  html += todosSection(todoOv, { agoFn: ago, mayEdit: state.mayAnswer !== false, doneOpen: !!state.todoDoneOpen, repos: f.repos })
   const recent = needs.recent || []
   html += '<details class="recent"' + (state.recentOpen !== false ? ' open' : '') + '><summary>Recently answered <span class="count">' + recent.length + '</span></summary>' +
     (recent.length ? '<ul>' + recent.map((r) => '<li><span class="t" title="' + esc(r.at) + '">' + esc(ago(r.at)) + '</span><a href="#/s/' + encodeURIComponent(r.session.id) + '">' + esc(r.session.title || 'Untitled session') + '</a>' +
@@ -630,8 +648,10 @@ async function viewWaiting() {
   html += dismissedHtml(needs.dismissed || [], { open: !!state.dismissedOpen, agoFn: ago })
   $app.innerHTML = banners() + html
   // Open/closed survives live repaints (0.6.5).
-  const dz = $app.querySelector('details.dismissed')
+  const dz = $app.querySelector('details.dismissed:not(.todo-done-list)')
   if (dz) dz.addEventListener('toggle', () => { state.dismissedOpen = dz.open })
+  const td = $app.querySelector('details.todo-done-list')
+  if (td) td.addEventListener('toggle', () => { state.todoDoneOpen = td.open })
   const rc = $app.querySelector('details.recent')
   if (rc) rc.addEventListener('toggle', () => { state.recentOpen = rc.open })
 }
@@ -739,15 +759,18 @@ async function viewSession(id) {
   const branch = s.repo && s.repo.branch
   const spv = await api('GET', '/v1/spaces').catch(() => null)
   let html = '<a class="back" href="#/">← All sessions</a>'
-  html += '<div class="pagehead"><div><h1>' + esc(s.title || 'Untitled session') + '</h1><div class="sub">' + pill(s.status) + ' ' + spaceChip(s, { force: true }) + ' &nbsp;' + esc(s.titleSource ? s.titleSource + ' title' : '') + '</div></div>' +
+  html += '<div class="pagehead"><div><h1>' + esc(s.title || 'Untitled session') + '</h1><div class="sub">' + pill(s.status) + ' ' + spaceChip(s, { force: true }) + wtChips(s) + ' &nbsp;' + esc(s.titleSource ? s.titleSource + ' title' : '') + '</div></div>' +
     '<div class="actions">' + goButton(s) + (s.status === 'ended' || s.live === 'closed' ? resumeButton(s, s.viewer || { local: state.viewerLocal !== false, ghostty: !!state.ghostty }) : '') + '<a class="btn" href="#/timeline?session=' + encodeURIComponent(s.id) + '">' + icon('history') + 'Open in Timeline</a><button type="button" class="btn" data-action="resume" data-id="' + esc(s.id) + '">Copy resume</button>' + (s.isLocal ? '<button type="button" class="btn primary" data-action="checkpoint" data-id="' + esc(s.id) + '">Checkpoint now</button>' : '') + '</div></div>'
   html += '<div class="facts">' +
-    fact('Machine', s.machine + (s.isLocal ? ' (this one)' : ' (synced)')) + fact('Repo', (s.repoName || '—') + (branch ? ' · ' + branch : '')) + fact('Directory', s.cwd || '—') + fact('Last activity', ago(s.lastActivityAt)) + fact('Started', clock(s.startedAt)) +
+    fact('Machine', s.machine + (s.isLocal ? ' (this one)' : ' (synced)')) + fact('Repo', (s.repoName || '—') + (branch ? ' · ' + branch : '')) + (s.worktree ? fact('Worktree', '⑂ ' + s.worktree.name + (s.worktree.branch ? ' · ' + s.worktree.branch : ''), 'wrap') : '') + (s.startedIn ? fact('Started in', s.startedIn) : '') + fact('Directory', s.cwd || '—') + fact('Last activity', ago(s.lastActivityAt)) + fact('Started', clock(s.startedAt)) +
     fact('Turns', s.turns + ' (' + s.turnsSinceCheckpoint + ' since checkpoint)' + (s.historyTurns ? ' · resumed, ' + s.historyTurns + ' before' : '')) + fact('Capture', s.capture || '—') + fact('Model', s.modelLabel || s.model || '—', 'wrap') + fact('Session id', s.id) +
     fact('Open?', s.live === 'open' ? 'open' + (s.liveVia === 'pid' ? ' (process ' + s.pid + ' running)' : ' (heartbeat)') : s.live === 'closed' ? 'closed ' + ago(s.closedAt) : 'unknown') +
     fact('Terminal', (s.terminal ? s.terminal.label : '—') + (s.tty ? ' · ' + s.tty.replace('/dev/', '') : '') + ' · tab cp:' + (s.shortId || '')) + '</div>'
   html += spacePicker(s, spv, 'session', s.id)
   html += '<section class="sprs" id="prs">' + sessionPrsSection(s, { mayEdit: !s.agent }) + '</section>'
+  // 0.7.0: steps handed back to you, and the docs, plans and artifacts it made
+  html += '<section class="stodos" id="todos">' + sessionTodosSection(s, { agoFn: ago, mayEdit: state.mayAnswer !== false }) + '</section>'
+  html += '<section class="sfiles" id="files">' + sessionFilesSection(s, { agoFn: ago }) + '</section>'
   if (s.needsYou) html += '<section class="needs-strip one" aria-label="Needs you"><div class="needs-head"><h2>Needs you</h2></div><div class="needs-list">' + needPanel({ ...s.needsYou, session: s }, needOpts({ compact: true })) + '</div></section>'
   if (s.statusChanges && s.statusChanges.length) {
     html += '<div class="striplabel">Status history</div><div class="strip">' + s.statusChanges.slice(-24).map((c) => '<span class="s-' + esc(c.status) + '" title="' + esc(clock(c.at)) + '">' + esc(LABEL[c.status] || c.status) + '</span>').join('') + '</div>'
@@ -2957,6 +2980,15 @@ document.addEventListener('click', async (ev) => {
     if (action === 'quick-reply') return quickReplyClick(btn)
     if (action === 'need-more') return needMoreClick(btn)
     if (action === 'need-dismiss') return needDismissClick(btn)
+    // ---- To do and Files (0.7.0)
+    if (action === 'todo-restore' || action === 'todo-restore-all') {
+      btn.disabled = true
+      state.todoDoneOpen = true
+      try { await api('POST', '/v1/todos/restore', action === 'todo-restore-all' ? { all: true } : { key: btn.dataset.todo }) } catch (e) { toast(e.message, 5000) }
+      return render()
+    }
+    if (action === 'file-open') return openDoc(btn.dataset.session, { path: btn.dataset.path, plan: btn.dataset.plan })
+    if (action === 'doc-close') return closeDoc()
     if (action === 'need-restore' || action === 'need-restore-all') {
       btn.disabled = true
       state.dismissedOpen = true
@@ -2966,7 +2998,9 @@ document.addEventListener('click', async (ev) => {
     if (action === 'go') return goClick(btn, id, s)
     if (action === 'resume-open') return resumeOpen(btn, btn.dataset.id || id)
     if (action === 'closed-more') { closedUi.limit += CLOSED_PAGE; btn.disabled = true; try { await closedFetch(state.boardFilter || { repos: [] }, state.boardSpace); closedRepaint() } catch (e) { toast(e.message, 5000) } return }
-    if (action === 'closed-clear') { closedUi.q = ''; closedUi.limit = CLOSED_PAGE; state.boardSpace = null; saveSpace(null); return setBoardFilter({ repos: [], status: 'closed' }) }
+    // 0.7.0: only sessions with docs, plans or artifacts
+    if (action === 'closed-docs') { closedUi.docs = !closedUi.docs; closedUi.limit = CLOSED_PAGE; btn.setAttribute('aria-pressed', String(closedUi.docs)); btn.textContent = (closedUi.docs ? '✓ ' : '') + 'Docs & artifacts'; try { await closedFetch(state.boardFilter || { repos: [] }, state.boardSpace); closedRepaint() } catch (e) { toast(e.message, 5000) } return }
+    if (action === 'closed-clear') { closedUi.docs = false; closedUi.q = ''; closedUi.limit = CLOSED_PAGE; state.boardSpace = null; saveSpace(null); return setBoardFilter({ repos: [], status: 'closed' }) }
     if (action && action.startsWith('st-')) return stAction(action, btn)
     if (action && action.startsWith('sync-') || action === 'peer-trust') return syncAction(action, btn)
     if (action === 'resume') {
@@ -3109,6 +3143,65 @@ async function needMoreClick(btn) {
   paint()
 }
 
+// Tick a to-do (0.7.0): done on every board at once, kept in the folder, Undo for 5 s.
+async function todoDoneChange(cb) {
+  const key = cb.dataset.todoDone
+  if (!key || !cb.checked) return
+  const li = cb.closest('li.todo')
+  if (li) li.classList.add('ticked')
+  try { await api('POST', '/v1/todos/done', { key }) } catch (e) { cb.checked = false; if (li) li.classList.remove('ticked'); toast('Couldn’t tick it: ' + e.message, 5000); return }
+  for (const s of state.sessions || []) if (s.todos) s.todos = s.todos.filter((t) => t.key !== key)
+  toastUndo('Done', async () => {
+    try { await api('POST', '/v1/todos/restore', { key }) } catch (e) { toast(e.message, 5000) }
+    render()
+  })
+  setTimeout(() => { if (!busy()) render() }, 400)
+}
+
+// The in-app viewer (0.7.0): a doc or plan a session wrote, read from the Mac
+// that owns it (through another Mac or the relay from a phone). Markdown is
+// rendered from escaped text; HTML files show as source; anything else downloads.
+function docViewerEl() {
+  let el = document.getElementById('docViewer')
+  if (el) return el
+  el = document.createElement('div')
+  el.id = 'docViewer'
+  el.className = 'doc-viewer'
+  el.hidden = true
+  el.setAttribute('role', 'dialog')
+  el.setAttribute('aria-modal', 'true')
+  el.setAttribute('aria-labelledby', 'docViewerTitle')
+  el.innerHTML = '<div class="dv-sheet"><div class="dv-head"><div class="dv-title" id="docViewerTitle"></div><a class="btn sm dv-dl" hidden>Download</a><button type="button" class="dv-x" data-action="doc-close" aria-label="Close">×</button></div><div class="dv-sub faint"></div><div class="dv-body"></div></div>'
+  el.addEventListener('click', (ev) => { if (ev.target === el) closeDoc() })
+  document.body.appendChild(el)
+  return el
+}
+function closeDoc() { const el = document.getElementById('docViewer'); if (el) { el.hidden = true; el.querySelector('.dv-body').innerHTML = '' } document.documentElement.classList.remove('dv-open') }
+document.addEventListener('keydown', (ev) => { if (ev.key === 'Escape' && document.getElementById('docViewer') && !document.getElementById('docViewer').hidden) closeDoc() })
+async function openDoc(sessionId, { path, plan } = {}) {
+  if (!sessionId || (!path && !plan)) return
+  const el = docViewerEl()
+  const name = plan ? 'Plan' : String(path).split('/').pop()
+  el.querySelector('.dv-title').textContent = name
+  el.querySelector('.dv-sub').textContent = ''
+  el.querySelector('.dv-body').innerHTML = '<div class="empty">Opening…</div>'
+  const dl = el.querySelector('.dv-dl'); dl.hidden = true; dl.removeAttribute('href')
+  el.hidden = false
+  document.documentElement.classList.add('dv-open')
+  const qs = new URLSearchParams(plan ? { plan } : { path })
+  try {
+    const r = await api('GET', '/v1/sessions/' + encodeURIComponent(sessionId) + '/file?' + qs)
+    if (el.hidden) return
+    el.querySelector('.dv-title').textContent = r.name || name
+    el.querySelector('.dv-sub').textContent = [r.plan ? 'Plan' : r.kind === 'new' ? 'New' : r.kind === 'edited' ? 'Edited' : '', r.size ? (r.size < 1024 ? r.size + ' B' : Math.round(r.size / 1024) + ' KB') : '', r.peer ? 'from ' + r.peer : ''].filter(Boolean).join(' · ')
+    el.querySelector('.dv-body').innerHTML = docViewerBody(r)
+    const href = docDownloadHref(r)
+    if (href) { dl.href = href; dl.download = String(r.name || name).split('/').pop() + (r.plan ? '.md' : ''); dl.hidden = false }
+  } catch (e) {
+    el.querySelector('.dv-body').innerHTML = '<div class="empty">' + esc(e.message) + '</div>'
+  }
+}
+
 // Dismiss a need (0.6.5): gone from every card and count at once, kept on
 // the daemon (so your other devices and the relay see it too), Undo for 5 s.
 async function needDismissClick(btn) {
@@ -3138,6 +3231,16 @@ function goClick(btn, id, s) {
 }
 
 document.addEventListener('submit', async (ev) => {
+  if (ev.target.dataset && ev.target.dataset.todoAdd) {
+    ev.preventDefault()
+    const input = ev.target.querySelector('input[name=todo]')
+    const text = input.value.trim()
+    if (!text) { input.focus(); return }
+    const sid = ev.target.dataset.todoAdd === '-' ? null : ev.target.dataset.todoAdd
+    const b = ev.target.querySelector('button'); if (b) b.disabled = true
+    try { await api('POST', '/v1/todos', { text, sessionId: sid }); input.value = ''; input.blur(); toast('Added to your to-dos'); await render() } catch (e) { toast(e.message, 5000) } finally { if (b) b.disabled = false }
+    return
+  }
   if (ev.target.dataset && ev.target.dataset.prLink) {
     ev.preventDefault()
     const input = ev.target.querySelector('input[name=ref]')
@@ -3204,7 +3307,7 @@ document.addEventListener('submit', async (ev) => {
 
 // Live updates over SSE; re-render the current view, at most every 800 ms.
 let pending = null
-const busy = () => !!document.querySelector('.lo-menu, .title input, .repomore[open], .need .deny-form:not([hidden])') || !!(document.activeElement && document.activeElement.closest && document.activeElement.closest('.addform') && document.activeElement.value) || !!(document.activeElement && document.activeElement.closest && document.activeElement.closest('.need') && /^(INPUT|TEXTAREA)$/.test(document.activeElement.tagName))
+const busy = () => !!document.querySelector('.doc-viewer:not([hidden]), .lo-menu, .title input, .repomore[open], .need .deny-form:not([hidden])') || !!(document.activeElement && document.activeElement.closest && document.activeElement.closest('.addform') && document.activeElement.value) || !!(document.activeElement && document.activeElement.closest && document.activeElement.closest('.need') && /^(INPUT|TEXTAREA)$/.test(document.activeElement.tagName))
 // Settings isn't redrawn by live updates: it would wipe what you're editing,
 // and the QR code you're scanning (v0.4.6). Its sections fetch their own state.
 function soon() { if (pending) return; pending = setTimeout(() => { pending = null; if (!busy() && !(state.route && state.route.name === 'settings') && !(state.route && state.route.name === 'catchup' && cuUi.open)) render(); refreshHealth() }, 800) }
@@ -3223,6 +3326,7 @@ function connect() {
 }
 
 document.addEventListener('change', async (ev) => {
+  if (ev.target.dataset && ev.target.dataset.todoDone) return todoDoneChange(ev.target)
   // Spaces (v0.5.8): a session's or agent's own space, a Mac's default.
   if (ev.target.dataset && ev.target.dataset.spaceKind) {
     const sel = ev.target