huddle-cli 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.1.5 — 2026-10-16
+
+Run it from your phone; undo and GitHub issues in the dashboard.
+
+- **`huddle app --phone`: run it from your phone.** The dashboard also listens on your Wi-Fi and prints a QR code; scan it to watch the run, answer an agent's question, talk to the agents, or start and stop a run. Every page and call still needs the session key (longer on the network), and only this computer's own addresses are let in. It says plainly that anyone with the link can control the run, and ctrl-c stops sharing. `--anywhere` opens a Cloudflare quick tunnel instead (https, works off your Wi-Fi) when `cloudflared` is installed, and says how to get it when not. Checked at phone width (390 px).
+- **Undo from the dashboard.** A past run has **Undo this run** when it can be undone (otherwise the reason, in small print). It lists the commits and asks in the page first, then undoes exactly as `huddle undo` does: one revert commit, recorded the same way. Refused while a run is going, or if the run changed since you looked.
+- **Fix a GitHub issue from the dashboard.** With `gh` signed in, the start screen lists the repo's open issues (up to 20, checked at most once a minute); **Fix this** starts a run on it, like `huddle fix #12`. The sidebar shows which connectors are set up.
+- Fixed: undoing an older run (`huddle undo --run 1` after run 2) marked the newest run as undone instead.
+- Fixed: `huddle app --help` opened a dashboard; it prints the options now.
+- Live: a run started from the phone link (real Claude) built `--max N` for a slug CLI, and the dashboard's undo took it back. Suite: 457 tests, 0 failed.
+
+## 0.1.4 — 2026-10-16
+
+Your team's tools, for every agent.
+
+- **Connectors.** Every agent in a run (Claude, Codex, Cursor, any of them) gets the same outside tools through the Plug. The Room runs each connector once per run, so there's one sign-in and no per-vendor config.
+  - **GitHub, built in:** `github_issues`, `github_issue` (with comments), `github_prs`, `github_pr` (files, reviews, optional diff), `github_ci`, through the `gh` CLI you're signed in to. Huddle keeps no token.
+  - **Any MCP server:** `huddle connectors add atlassian` (Jira + Confluence), `linear`, `notion`, `miro`, `sentry`, any `https://` MCP URL (through `mcp-remote`, which does the sign-in), or `-- <command…>` for a local server. A connector that doesn't start is left out with a note; the run goes on.
+  - **Read-only until you allow more.** Tools that post or change things are hidden until `--write` (`huddle connectors github write` for comments and new issues). What agents post is signed "via Huddle".
+  - **Only your own agents** reach them; a teammate's agent in your room doesn't. Every call shows live (`codex  github: read issue #12`) and is recorded (`connector.call`).
+  - **Reviewers see what the author read.** A cross-review has no tools, so the ticket or issue the author read goes into the reviewer's prompt, verbatim. Found live: Codex sent back WEB-7 because "the ticket's contents are missing".
+  - **The planner knows what agents can read**, so a goal that names a ticket gets tasks that read it first rather than guessing.
+  - Live: "do Jira ticket WEB-7" with a stand-in Jira. Claude, then Codex (reviewed by Cursor), read the ticket and its PM comment through the connector and built all of it, first review approved.
+- **`huddle fix #12`**: a GitHub issue (title, body, comments) is the goal. A goal that mentions `#12` keeps your words and gets the issue attached.
+- **`huddle undo`** takes back what the last run merged (`--run n` for another): one revert commit, listed and confirmed first. If later commits build on the run, it changes nothing and says how to revert by hand.
+- **`huddle update`** (also `huddle --update`) installs the newest Huddle from npm. It says so when you're already on it, and a source checkout is told to `git pull` instead.
+- Tests pass in a terminal that sets `FORCE_COLOR` (found publishing 0.1.3).
+
 ## 0.1.3 — 2026-10-16
 
 You can follow a run, and take part in it, without being an engineer. Live capstone: 29/29 with real Claude, Codex and Cursor (13 merged, 0 failed, 22 min, 5.6M tokens, down from 6.6M).

package/QUICKSTART.md

@@ -67,6 +67,30 @@ Or skip the prompt: `huddle build a temperature converter with tests` (no quotes
 
 **The dashboard:** `huddle app` opens Huddle in your browser. You get the run going now (who's on what, how far along, a question waiting for you), every past run as a conversation, the plan and what each agent cost. Type there to start a run or talk to the agents; hold Space (or the mic) to say it instead. It works for runs started in a terminal too. Runs keep going if you close the page.
 
+- **From your phone:** `huddle app --phone` prints a QR code. Scan it with your phone's camera (same Wi-Fi as the computer) to watch the run, answer questions and talk to the agents from the couch. Anyone with that link can control the run, so keep it to yourself; ctrl-c stops sharing. Not on the same Wi-Fi? `huddle app --anywhere` uses a free Cloudflare link instead (needs `cloudflared`: `brew install cloudflared`).
+- **Undo a run:** open a past run and press **Undo this run**. It shows the commits it would take back and asks first, the same as `huddle undo`.
+- **Fix an issue:** when `gh` is signed in, the start screen lists the repo's open GitHub issues; **Fix this** starts a run on one.
+
+**Your team's tools: GitHub, Jira, Linear…** Every agent in a run can read the repo's GitHub issues, pull requests and CI through the `gh` CLI you're signed in to. Nothing to set up:
+
+```bash
+huddle fix #12                 # GitHub issue 12 is the goal: its text and comments, word for word
+huddle build a login page for #12 and #15    # your words, with both issues attached
+```
+
+(In bash, `#` starts a comment: type `huddle fix issue 12` there.)
+
+Add the other tools your team uses; each signs you in through your browser once:
+
+```bash
+huddle connectors add atlassian   # Jira + Confluence (also: linear, notion, miro, sentry)
+huddle connectors                 # what's on, and how many tools each one gives
+```
+
+Agents only get the tools that *read* until you allow more: `huddle connectors add --write atlassian`, `huddle connectors github write`. What they post is signed "via Huddle". Huddle keeps no tokens; `gh` and each service's own sign-in do.
+
+**Undo a run:** `huddle undo` takes back everything the last run merged, as one new commit (it shows the commits and asks first). `huddle undo --run 3` for an older one.
+
 **A second view** (another terminal, same folder):
 
 ```bash
@@ -117,14 +141,18 @@ Not on the same Wi-Fi? Install [Tailscale](https://tailscale.com) on both machin
 | `huddle doctor` | check Node, git and your agents |
 | `huddle agents` · `huddle agents skip <id>` · `use <id>` | who's ready, and which agents Huddle uses |
 | `huddle app` | the dashboard in your browser: live run, history, talk to the agents (or speak) |
+| `huddle app --phone` | the same on your phone: scan the QR code (`--anywhere`: off your Wi-Fi too) |
 | `huddle view` | watch a run live |
 | `huddle story` | replay the last run |
 | `huddle brief` · `huddle brief off` | what the last run left for your next solo agent · stop pointing CLAUDE.md / AGENTS.md at it |
 | `huddle runs` · `huddle export [run]` | list past runs · save one as a chat (`--level summary\|chat\|full`, `--format md\|html\|json`) |
 | `huddle board` | print the task board |
+| `huddle fix #12` | a GitHub issue as the goal |
+| `huddle connectors` · `add atlassian` · `remove <name>` | the outside tools every agent gets (GitHub is built in) |
+| `huddle undo` | take back what the last run merged (one revert commit; asks first) |
 | `add <file>` / `ctx` | (at the prompt) put a file on the shared screen / see what's on it |
 | `huddle add <file\|->` / `huddle ctx` | running claude/codex/cursor yourself (`huddle connect`): put a file, folder or stdin (`cat err.log \| huddle add -`) on the shared screen every session reads / see it |
-| `npm install -g huddle-cli` | update to the newest version |
+| `huddle update` | update to the newest version |
 | `npm uninstall -g huddle-cli` | remove it (your repos keep their work) |
 
 ## If something goes wrong

package/README.md

@@ -86,6 +86,18 @@ None of these steps blocks the run. If an agent doesn't answer or doesn't follow
 
 **Pasting and files: one shared screen, not N copies.** Paste a stack trace, a doc or a block of code at the prompt and it becomes one item on the Room's *shared screen* (`📎 pasted 214 lines (ctx-3 'TypeError…')`) instead of 214 commands; what you type next is the goal. Drag a file or screenshot into the terminal, or `add <file|folder|glob>`. Prompts carry only a one-line index per item; the planner links items to the tasks that need them, and agents open them with `huddle_context_read` (400 lines a call, images and PDFs as a file path; Codex also gets linked screenshots via `--image`), search them, and pin notes on them that everyone sees. `ctx` lists the screen (`ctx show|rm|note|clear`). Likely secrets (API keys, tokens, private keys, `.env` lines) are flagged before anything is shown to agents, and redacted unless you say no. One-shot: `huddle join "fix this" --with error.log --with shot.png`, or `cat log.txt | huddle join "fix this"`. Items live in `.huddle/context/` (git-ignored); caps: 2 MB of text, 25 MB per file, 200 MB in all (`HUDDLE_CTX_MAX_*_MB`).
 
+**Connectors: your team's tools for every agent.** One run's agents (Claude, Codex, Cursor, any of them) share the same outside tools through the Plug; the Room runs each connector once per run.
+
+- **GitHub, built in:** issues, pull requests (with diffs) and CI runs, through the `gh` CLI you're signed in to. `huddle fix #12` makes issue 12 the goal (title, body and comments, verbatim); a goal that mentions `#12` gets the issue attached.
+- **Any MCP server:** `huddle connectors add atlassian` (Jira + Confluence), `linear`, `notion`, `miro`, `sentry`; or `huddle connectors add <name> <https-url>`, or `huddle connectors add <name> -- <command…>` for a local one. Remote ones run through `mcp-remote`, which signs you in in the browser once and keeps the token. Huddle keeps none.
+- **Read-only until you say so.** A tool that posts or changes something (a comment, a new ticket) is hidden until `--write` (`huddle connectors github write`). The server's own annotations decide what reads; without them, the tool's name does. What agents post is signed "via Huddle".
+- **Only your agents.** A teammate's agent working from your room never reaches your connectors. Every call shows in the run (`codex  github: read issue #12`) and is kept in the Room's record of the run.
+- Config: `~/.huddle/connectors.json`. `huddle connectors` lists what's on and how many tools each gives.
+
+**`huddle undo`** takes back what a run merged: one commit that reverts the run's commits (it lists them and asks first; `--yes` doesn't; `--run n` for an older run). History stays, nothing is force-pushed. If later work builds on the run, it says so and changes nothing.
+
+**`huddle app`, the dashboard,** shows the run going now and every past run in your browser. A past run has **Undo this run** (the same undo, asked in the page first, refused while a run is going); with `gh` signed in, the start screen lists the repo's open issues with **Fix this**. **`huddle app --phone`** also opens it to your Wi-Fi and prints a QR code: scan it to follow and steer a run from your phone. The link carries a long per-session key and every page and call needs it; anyone with the link can control the run, and ctrl-c stops sharing. `--anywhere` uses a Cloudflare quick tunnel (an https link that works off your Wi-Fi) when `cloudflared` is installed.
+
 **Running claude, codex and cursor yourself, in one repo at once (attach mode):**
 
 ```bash

package/dist/app/page.js

@@ -162,22 +162,38 @@ pre.contract{font:12.5px/1.6 var(--mono);white-space:pre-wrap;margin:0;padding:1
 .ib.rec{background:var(--bad);color:#fff;animation:pulse 1.4s infinite}
 .listening{display:none;align-items:center;gap:8px;color:var(--bad);font-size:12.5px;font-weight:600}.listening.on{display:flex}
 
-.hero{max-width:640px;margin:0 auto;padding:17vh 32px 0;text-align:center}
+.hero{max-width:640px;margin:0 auto;padding:17vh 32px 170px;text-align:center}
 .hero .mark{width:46px;height:46px;border-radius:14px;margin:0 auto 24px}
 .hero h2{font:500 34px/1.2 var(--serif);letter-spacing:-.02em;margin:0 0 12px}.hero p{color:var(--mute);margin:0 auto;max-width:470px;font-size:15px}
 .ex{display:flex;flex-wrap:wrap;gap:8px;justify-content:center;margin-top:28px}
 .ex button{border:1px solid var(--line);background:var(--panel);border-radius:99px;padding:7px 14px;font-size:13.5px;color:var(--mute);box-shadow:var(--shadow)}
 .ex button:hover{color:var(--fg);border-color:var(--line2)}
 
+.quiet{color:var(--faint);font-size:12.5px}
+.confirm{margin-top:20px;padding:18px 20px;border-radius:14px;border:1px solid var(--line2);background:var(--panel);box-shadow:var(--shadow-lg)}
+.confirm .q{font:500 18px/1.35 var(--serif);margin:0 0 6px}.confirm p{margin:0;color:var(--mute);font-size:13.5px}
+.confirm ul{margin:12px 0 14px;padding:0;list-style:none;max-height:220px;overflow:auto}.confirm li{font:12.5px/1.5 var(--mono);color:var(--mute);padding:2px 0;overflow-wrap:anywhere}
+.confirm .acts{display:flex;flex-wrap:wrap;gap:8px;align-items:center}.confirm .err{color:var(--bad);font-size:13px;margin-top:10px}
+.btn.danger{background:var(--bad);color:#fff}.btn:disabled{opacity:.5;cursor:default}
+.issues{margin:34px auto 0;max-width:560px;text-align:left}
+.issues .k{text-align:center}
+.issue{display:flex;align-items:center;gap:10px;padding:9px 6px 9px 12px;border-top:1px solid var(--line);font-size:14px}.issue:first-of-type{border-top:0}
+.issues .card{padding:2px 0}
+.issue .no{color:var(--faint);font-variant-numeric:tabular-nums;font-size:13px;flex:none}.issue .ti{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.issue .btn{padding:6px 11px;font-size:12.5px;flex:none;margin-right:6px}
+.tools{color:var(--faint);font-size:11.5px;padding:10px 6px 0;line-height:1.5}
+.hero-menu{position:absolute;top:14px;left:12px}
+.acts-r{display:flex;flex-wrap:wrap;gap:2px}
 .toast{position:fixed;bottom:124px;left:calc(50% + 132px);transform:translate(-50%,6px);background:var(--fg);color:var(--bg);padding:9px 15px;border-radius:11px;font-size:13px;opacity:0;transition:all .2s;pointer-events:none;box-shadow:var(--shadow-lg)}.toast.on{opacity:1;transform:translate(-50%,0)}
 .side-toggle{display:none}
 @media (max-width:860px){.app{grid-template-columns:1fr}aside{position:fixed;inset:0 auto 0 0;width:280px;z-index:9;transform:translateX(-100%);transition:transform .2s;box-shadow:var(--shadow-lg)}aside.open{transform:none}
-.side-toggle{display:grid}.col{padding:22px 16px 170px}.dock{padding:0 16px 14px}.toast{left:50%}.steps{grid-template-columns:repeat(2,1fr)}h1{font-size:24px}}
+.side-toggle{display:grid}.col{padding:22px 16px 170px}.dock{padding:0 16px 14px}.toast{left:50%}.steps{grid-template-columns:repeat(2,1fr)}h1{font-size:24px}
+.top{flex-wrap:wrap;gap:8px 12px}.ask .h{flex-wrap:wrap}.ask .h .pill{margin-left:0}.top .acts-r{order:3;flex-basis:100%;margin-left:-8px}.top .pop{right:auto;left:0}.hero{padding-top:64px}.issue .ti{white-space:normal;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}}
 `;
 const JS = String.raw `
 "use strict";
 var TOKEN = window.__HUDDLE_TOKEN__, COLORS = window.__HUDDLE_COLORS__;
-var S = { state: null, doc: null, docKey: "", sel: null, tab: "story", open: {}, fresh: false };
+var S = { state: null, doc: null, docKey: "", sel: null, tab: "story", open: {}, fresh: false, gh: null, ghAt: 0, undo: null };
 var $ = function (sel) { return document.querySelector(sel); };
 
 // ---- a tiny DOM kit ----------------------------------------------------------------
@@ -214,7 +230,8 @@ var ICONS = {
   msg: "M21 12a8 8 0 0 1-11.6 7.1L4 21l1.9-5.4A8 8 0 1 1 21 12z",
   merge: "M6 3v12M18 9a3 3 0 1 0 0-6 3 3 0 0 0 0 6zM6 21a3 3 0 1 0 0-6 3 3 0 0 0 0 6zM18 9a9 9 0 0 1-9 9",
   bug: "M8 9V7a4 4 0 0 1 8 0v2M12 9v12M6 9h12v5a6 6 0 0 1-12 0V9zM3 13h3M18 13h3",
-  flag: "M5 21V4M5 4h11l-2 4 2 4H5"
+  flag: "M5 21V4M5 4h11l-2 4 2 4H5",
+  undo: "M9 14L4 9l5-5M4 9h11a5 5 0 0 1 0 10h-3"
 };
 function icon(name, size, color) {
   var NS = "http://www.w3.org/2000/svg", s = document.createElementNS(NS, "svg");
@@ -288,7 +305,7 @@ function refresh() {
     var n = viewRunIndex();
     if (n == null) { S.doc = null; S.docKey = ""; return null; }
     var row = st.runs.find(function (r) { return r.index === n; }) || {};
-    var key = n + ":" + row.tokens + ":" + row.merged + ":" + (S.sel === "live" && live ? Math.floor(live.updatedAt / 3000) : "");
+    var key = n + ":" + row.tokens + ":" + row.merged + ":" + st.undone + ":" + (live ? "L" : "") + (S.sel === "live" && live ? Math.floor(live.updatedAt / 3000) : "");
     if (key === S.docKey) return null;
     return api("/api/run?n=" + n).then(function (d) { S.doc = d; S.docKey = key; });
   }).catch(function (e) { toast(e.message); }).then(function () {
@@ -316,6 +333,7 @@ function render() {
   if (!live && !S.doc) { main.appendChild(hero()); setComposer(false); return; }
   var c = h("div", { class: "col" });
   c.appendChild(header(live));
+  if (!live && S.undo && S.undo.n === viewRunIndex() && S.doc.undo && S.doc.undo.ok) c.appendChild(undoCard(S.undo.n, S.doc.undo));
   var plain = live ? live.plain : S.doc && S.doc.plain;
   var report = !live && S.doc && S.doc.report;
   if (plain && plain.what && !report) c.appendChild(h("div", { class: "prose" }, h("span", { class: "k", text: "What you'll get" }), plain.what,
@@ -344,6 +362,15 @@ function renderSide(st) {
     var ready = a.state === "ready";
     ppl.appendChild(h("span", { class: "who" + (ready ? "" : " off"), title: ready ? a.id + " is ready" : a.id + ": " + (a.state === "not_installed" ? "not installed" : a.state === "skipped" ? "skipped" : "not signed in") }, av(a.id), a.id));
   });
+  // The outside tools every agent gets (huddle connectors), in small print.
+  var tools = $("#tools"), cn = st.connectors || { github: "off", others: [] }, gh = S.gh, names = [];
+  if (cn.github !== "off" && gh && gh.ready) names.push(h("span", { title: gh.note, text: "GitHub" + (cn.github === "write" ? " (can post)" : "") }));
+  cn.others.forEach(function (c) { names.push(h("span", { text: c.name + (c.write ? " (can post)" : "") })); });
+  tools.textContent = "";
+  if (!names.length && !gh) return;
+  add(tools, "Connectors: ");
+  if (!names.length) add(tools, h("span", { title: gh && gh.note ? "GitHub: " + gh.note : "", text: "none · huddle connectors" }));
+  names.forEach(function (x, i) { if (i) add(tools, " · "); add(tools, x); });
 }
 function runBtn(key, goal, when, tone) {
   return h("button", { class: "run" + (S.sel === key ? " sel" : ""), title: goal, onclick: function () { S.sel = key; S.fresh = false; S.docKey = ""; S.tab = "story"; $("aside").classList.remove("open"); $("#main").scrollTop = 0; refresh(); } },
@@ -361,9 +388,15 @@ function header(live) {
       h("span", { text: dur(d.run.ms) }), h("span", { text: tok(r.tokens) + " tokens" }));
     if (r.qa) sub.push(h("span", { class: "pill " + r.qa.tone, text: r.qa.text }));
   }
-  var right = h("div", { style: "display:flex;gap:2px" });
+  var right = h("div", { class: "acts-r" });
   if (live) right.appendChild(h("button", { class: "ghost stop", onclick: stop }, icon("stop", 14), "Stop"));
   var n = viewRunIndex();
+  // Undo: offered only when ui/undo.ts says it can be done; otherwise why not, in small print.
+  var u = !live && d && d.undo;
+  if (u && u.ok && S.state.live) sub.push(h("span", { class: "quiet", text: "Undo once the run going now is finished" }));
+  else if (u && u.ok) right.appendChild(h("button", { class: "ghost", onclick: function () { S.undo = { n: n, busy: false, err: "" }; render(); } }, icon("undo", 14), "Undo this run"));
+  else if (u && /already undone/.test(u.why)) sub.push(h("span", { class: "pill", text: "Undone" }));
+  else if (u && u.why) sub.push(h("span", { class: "quiet", text: "Can't undo: " + u.why.replace(/^run \d+('s)?\s*/, function (m, s) { return s ? "its " : ""; }) }));
   if (n != null) right.appendChild(exportMenu(n));
   return h("div", { class: "top" }, h("button", { class: "ib side-toggle", onclick: function () { $("aside").classList.add("open"); }, "aria-label": "Runs" }, icon("menu", 18)),
     h("div", { class: "grow" }, h("h1", { text: title }), h("div", { class: "sub" }, sub)), right);
@@ -417,6 +450,19 @@ function askCard(q) {
     h("div", { class: "own" }, own, h("button", { class: "btn", text: "Send", onclick: function () { if (own.value.trim()) answer(q, own.value.trim()); } })));
 }
 
+/** Asking before an undo, in the page (a browser's confirm box can't be styled, and the Mac app has none). */
+function undoCard(n, u) {
+  var c = u.commits || [], shown = c.slice(0, 12);
+  return h("div", { class: "confirm" },
+    h("div", { class: "q", text: "Undo run " + n + "?" }),
+    h("p", { text: "This adds one new commit that takes back " + (c.length === 1 ? "this commit" : "these " + c.length + " commits") + ". Nothing is deleted: you can undo the undo later." }),
+    h("ul", null, shown.map(function (x) { return h("li", { text: x, title: x }); }), c.length > shown.length ? h("li", { text: "… and " + (c.length - shown.length) + " more" }) : null),
+    h("div", { class: "acts" },
+      h("button", { class: "btn danger", disabled: S.undo.busy, text: S.undo.busy ? "Undoing…" : "Undo it", onclick: function () { undoRun(n, u.end); } }),
+      h("button", { class: "ghost", text: "Keep it", onclick: function () { S.undo = null; render(); } })),
+    S.undo.err ? h("div", { class: "err", text: S.undo.err }) : null);
+}
+
 function tabs() {
   function t(k, label) { return h("button", { class: "tab" + (S.tab === k ? " on" : ""), text: label, onclick: function () { S.tab = k; render(); } }); }
   return h("div", { class: "tabs" }, t("story", "Story"), t("plan", "Plan"), t("cost", "Cost"), t("log", "Full log"));
@@ -599,23 +645,50 @@ function logTab(c, live) {
 
 function hero() {
   var ex = ["A todo app with a REST API and tests", "A CLI that converts temperatures", "Fix the failing tests in this repo"];
-  return h("div", { class: "hero" }, logo(22),
+  loadGithub();
+  var gh = S.gh, issues = gh && gh.ready ? gh.issues : [];
+  return h("div", { class: "hero" },
+    h("button", { class: "ib side-toggle hero-menu", onclick: function () { $("aside").classList.add("open"); }, "aria-label": "Runs" }, icon("menu", 18)),
+    logo(22),
     h("h2", { text: "What should the team build?" }),
     h("p", { text: "Describe it in plain words. Your agents design it together, split the work, review each other, and merge only what passes the tests." }),
-    h("div", { class: "ex" }, ex.map(function (x) { return h("button", { text: x, onclick: function () { var t = $("#say"); t.value = x; grow(); t.focus(); } }); })));
+    h("div", { class: "ex" }, ex.map(function (x) { return h("button", { text: x, onclick: function () { var t = $("#say"); t.value = x; grow(); t.focus(); } }); })),
+    issues.length ? h("div", { class: "issues" }, h("span", { class: "k", text: "Or fix an open issue" + (gh.note ? " · " + gh.note : "") }),
+      h("div", { class: "card" }, issues.map(function (i) {
+        return h("div", { class: "issue" }, h("span", { class: "no", text: "#" + i.number }), h("span", { class: "ti", text: i.title, title: i.title }),
+          h("button", { class: "btn", text: "Fix this", onclick: function () { start("#" + i.number); } }));
+      }))) : null);
 }
 
 // ---- actions -------------------------------------------------------------------
 function setComposer(live) {
-  $("#say").placeholder = live ? "Tell the agents something…  (@codex for just one)" : "Describe what to build…";
+  // A phone has room for the short version only.
+  $("#say").placeholder = live ? (window.innerWidth < 600 ? "Tell the agents something…" : "Tell the agents something…  (@codex for just one)") : "Describe what to build…";
   $("#hint").textContent = live ? "Goes to every agent working now" : "Enter to start · Shift+Enter for a new line";
   $("#send").disabled = !$("#say").value.trim();
 }
 function send() {
   var t = $("#say"), text = t.value.trim(); if (!text) return;
   var live = S.state && S.state.live;
-  var p = live ? api("/api/say", { text: text }) : api("/api/goal", { goal: text });
-  p.then(function () { t.value = ""; grow(); toast(live ? "Sent to the agents" : "Starting — your agents are connecting"); if (!live) { S.sel = "live"; S.fresh = false; setTimeout(refresh, 1500); } }).catch(function (e) { toast(e.message); });
+  if (!live) { start(text, function () { t.value = ""; grow(); }); return; }
+  api("/api/say", { text: text }).then(function () { t.value = ""; grow(); toast("Sent to the agents"); }).catch(function (e) { toast(e.message); });
+}
+function start(goal, then) {
+  api("/api/goal", { goal: goal }).then(function () { if (then) then(); toast("Starting — your agents are connecting"); S.sel = "live"; S.fresh = false; setTimeout(refresh, 1500); }).catch(function (e) { toast(e.message); });
+}
+function undoRun(n, end) {
+  S.undo.busy = true; S.undo.err = ""; render();
+  api("/api/undo", { n: n, end: end }).then(function (r) {
+    S.undo = null; S.docKey = "";
+    toast("Undone in " + r.commit + (r.pushedTo ? " · git push sends it to " + r.pushedTo : ""));
+    refresh();
+  }).catch(function (e) { if (S.undo) { S.undo.busy = false; S.undo.err = e.message; } render(); });
+}
+/** The repo's open GitHub issues and whether GitHub is on: asked at most once a minute (the server keeps gh's answer as long). */
+function loadGithub() {
+  if (S.ghAt && Date.now() - S.ghAt < 60e3) return;
+  S.ghAt = Date.now();
+  api("/api/github").then(function (g) { S.gh = g; render(); }).catch(function () {});
 }
 function answer(q, line) { api("/api/answer", { id: q.id, line: line }).then(function () { toast("Sent to " + q.from); }).catch(function (e) { toast(e.message); }); }
 function stop() { api("/api/stop", {}).then(function () { toast("Stopping — what's merged stays"); }).catch(function (e) { toast(e.message); }); }
@@ -662,6 +735,7 @@ window.addEventListener("load", function () {
   setInterval(function () { if (S.state && S.state.live && S.sel === "live") render(); }, 1000);
   grow();
   refresh();
+  loadGithub();
 });
 `;
 export function appPage(token) {
@@ -680,7 +754,7 @@ export function appPage(token) {
     <button class="new" id="new"><span class="plus"></span>New build</button>
     <div class="label">Recent</div>
     <div class="runs" id="runs"></div>
-    <div class="crew"><div class="row"><span>Your agents</span><button id="refresh" title="Check again" aria-label="Check your agents again"></button></div><div class="people" id="people"></div></div>
+    <div class="crew"><div class="row"><span>Your agents</span><button id="refresh" title="Check again" aria-label="Check your agents again"></button></div><div class="people" id="people"></div><div class="tools" id="tools"></div></div>
   </aside>
   <main>
     <div class="scroll" id="main"></div>

package/dist/app/qr.js

@@ -0,0 +1,47 @@
+// A QR code in the terminal, for `huddle app --phone`: point the phone's
+// camera at it instead of typing a 70-character link.
+//
+// The encoder is the one qrcode-terminal ships (Kazuhiko Arase's, MIT); the
+// drawing is ours: two rows of the code per line of text (▀ with a top and a
+// bottom color), so a phone link fits in about 20 lines. In color it paints
+// black on bright white itself, so it scans on a light or a dark terminal.
+// Without color it draws the light parts with blocks, which reads right on a
+// dark terminal (phone cameras also read the inverted code a light one shows).
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const QRCode = require("qrcode-terminal/vendor/QRCode/index.js");
+const LEVEL = require("qrcode-terminal/vendor/QRCode/QRErrorCorrectLevel.js");
+/** Light space around the code: scanners need some to find its corners. */
+export const QUIET = 2;
+/** The code's modules, true = dark, with the quiet zone around them. */
+export function qrMatrix(text, level = "L") {
+    const q = new QRCode(-1, LEVEL[level]); // -1: the smallest size that fits
+    q.addData(text);
+    q.make();
+    const n = q.getModuleCount();
+    const size = n + QUIET * 2;
+    return Array.from({ length: size }, (_, r) => Array.from({ length: size }, (_, c) => {
+        const y = r - QUIET;
+        const x = c - QUIET;
+        return y >= 0 && x >= 0 && y < n && x < n && q.isDark(y, x);
+    }));
+}
+/** The code as lines of text, two rows per line. */
+export function qrLines(text, opts) {
+    const m = qrMatrix(text);
+    const lines = [];
+    for (let r = 0; r < m.length; r += 2) {
+        let line = "";
+        for (let c = 0; c < m.length; c++) {
+            const top = m[r][c];
+            const bottom = r + 1 < m.length ? m[r + 1][c] : false;
+            if (opts.color)
+                line += `\x1b[${top ? 30 : 97};${bottom ? 40 : 107}m▀`;
+            else
+                line += !top && !bottom ? "█" : !top ? "▀" : !bottom ? "▄" : " ";
+        }
+        lines.push(opts.color ? line + "\x1b[0m" : line);
+    }
+    return lines;
+}
+//# sourceMappingURL=qr.js.map