kaizen-agent 1.40.3 → 1.41.2

package/cli/install.ts

@@ -576,7 +576,8 @@ if (upgrade) {
   // is not a failed upgrade: the version on disk is what decides.
   if (after !== latest) {
     console.log(`\n  ${c.bold(`could not install kaizen ${latest}`)}`);
-    console.log(`  ${c.dim("try:")} ${c.cyan(`bunx kaizen-agent@${latest}`)}\n`);
+    // npm names a new version before it serves it (its review takes minutes).
+    console.log(`  ${c.dim("npm may still be publishing it: try again in a few minutes, or run")} ${c.cyan(`bunx kaizen-agent@${latest}`)}\n`);
     process.exit(1);
   }
   console.log(`\n  ${c.bold("Upgraded")}  ${c.dim(now)} → ${c.green(after)}\n  ${c.dim("Restart Claude Code to pick up any new slash commands.")}\n`);

package/cli/setup.test.ts

@@ -38,7 +38,8 @@ test("kaizen setup without a terminal prints the manual steps and writes nothing
     const out = await new Response(p.stdout).text();
     expect(await p.exited).toBe(0);
     expect(out).toContain("tailscale serve --bg 127.0.0.1:7420");
-    expect(readdirSync(homeDir)).toEqual([]);
+    // Bun keeps its own cache in HOME (~/.bun); only what kaizen writes counts.
+    expect(readdirSync(homeDir).filter((n) => n !== ".bun")).toEqual([]);
     expect(existsSync(join(homeDir, ".kaizen"))).toBe(false);
   } finally { rmSync(homeDir, { recursive: true, force: true }); }
 });

package/cli/sources.test.ts

@@ -8,7 +8,7 @@ import { readInbox, writeInbox, replaceIdea, parseItem } from "./state.ts";
 import {
   readSources, addSource, removeSource, ingest, checkUrl, resolvesPublic, exportUrl, fetchText, split, sift,
   gatherSource, freshImages, gatherAll, due, takeImages, sheetImages, docImages, imagesUrl, SIGN_IN, UNREADABLE, CAP, moveSource, gatherDirs, writeSources,
-  readIcebox, writeIcebox, promote, markDone, dismiss, markReplied, setCategory, socialUrl, socialOf, AGENT_ONLY, PLATFORMS,
+  readIcebox, writeIcebox, promote, markDone, addItem, githubRepo, dismiss, markReplied, setCategory, socialUrl, socialOf, AGENT_ONLY, PLATFORMS,
 } from "./sources.ts";
 
 const root = realpathSync(mkdtempSync(join(tmpdir(), "kaizen-src-")));   // macOS: tmpdir is a symlink into /private
@@ -821,3 +821,22 @@ test("a done run that only mentions the idea does not finish it", () => {
   markDone(state);
   expect(readIcebox(state)[0]).toMatchObject({ status: "done", run: "r1" });
 });
+
+test("icebox: an item added by hand lands new, once, and promotes like a gathered one", () => {
+  expect(addItem(state, "  ")).toBe("write the request first");
+  expect(addItem(state, "Dark mode for the board", "asked twice")).toBeNull();
+  expect(addItem(state, "Dark mode for the board", "asked twice")).toBe("already in the icebox");
+  const [it] = open();
+  expect(it).toMatchObject({ text: "Dark mode for the board", notes: "asked twice", source: "manual", status: "new" });
+  expect(promote(state, [it.id])).toBeNull();
+  expect(readInbox(state).map((l) => l.text)).toEqual(["Dark mode for the board"]);
+});
+
+test("githubRepo: https and ssh GitHub links only, named by the repository", () => {
+  expect(githubRepo("https://github.com/acme/app")).toBe("app");
+  expect(githubRepo("https://github.com/acme/app.git")).toBe("app");
+  expect(githubRepo("git@github.com:acme/my.repo.git")).toBe("my.repo");
+  expect(githubRepo("ssh://git@github.com/acme/app.git")).toBe("app");
+  for (const bad of ["http://github.com/a/b", "https://gitlab.com/a/b", "https://github.com/a", "git@github.com:a/..", "--upload-pack=x", "https://github.com/a/b;rm -rf ~"])
+    expect(githubRepo(bad)).toBeNull();
+});

package/cli/sources.ts

@@ -237,6 +237,26 @@ export function ingest(state: string, url: string, items: Item[]): { added: numb
   return { added: fresh.length, held };
 }
 
+// A request typed into the icebox by hand: kept like a gathered one, source "manual".
+// Returns why not, or null.
+export function addItem(state: string, text: string, notes = ""): string | null {
+  const c = clean(text, notes);
+  if (!c) return "write the request first";
+  const ice = readIcebox(state);
+  const n = c.lines.join("\n").slice(0, 2000), key = rowKey(c.text, n);
+  if (ice.some((s) => rowKey(s.text, s.notes) === key)) return "already in the icebox";
+  ice.push({ id: idOf("manual " + key), text: c.text, ...(n ? { notes: n } : {}), source: "manual", at: new Date().toISOString(), status: "new" });
+  writeIcebox(state, ice);
+  return null;
+}
+
+// A GitHub repository link git can clone: https://github.com/o/r(.git) or
+// git@github.com:o/r(.git). Returns the folder name it clones into, or null.
+export function githubRepo(raw: string): string | null {
+  const m = raw.trim().match(/^(?:https:\/\/github\.com\/|git@github\.com:|ssh:\/\/git@github\.com\/)[\w.-]+\/([\w.-]+?)(?:\.git)?\/?$/);
+  return m && m[1] !== "." && m[1] !== ".." ? m[1] : null;
+}
+
 // The only way icebox text becomes an idea. Several items may become one idea (the
 // same need said twice); the idea's text is the caller's, or the first item's, and
 // `details` are the caller's own words for it. The notes hold those details first,

package/cli/state.test.ts

@@ -93,6 +93,22 @@ test("boardCards: a started idea stays until its run has a state.json", () => {
   rmSync(join(dir, ".."), { recursive: true, force: true });
 });
 
+test("boardCards: a started idea retires into the run its launch's session wrote, however reworded", () => {
+  const dir = join(mkdtempSync(join(tmpdir(), "kaizen-")), ".kaizen");
+  const r = join(dir, "runs", "2026-01-01-reworded");
+  mkdirSync(r, { recursive: true });
+  mkdirSync(join(dir, "sessions"));
+  writeInbox(dir, [{ status: "started", text: "revision" }]);
+  writeFileSync(join(r, "00-request.md"), "- add a form for the icebox\n");
+  writeFileSync(join(dir, "sessions", "1-a.json"), JSON.stringify({ run: null, text: "revision", cmd: "claude", sessionId: "abc", started: Date.now() }));
+  const cards = () => boardCards([dir], Date.now()).map((k) => k.kind);
+  writeFileSync(join(r, "state.json"), JSON.stringify({ id: "2026-01-01-reworded", stage: "build", awaiting: null }));
+  expect(cards()).toEqual(["idea", "run"]);
+  writeFileSync(join(r, "state.json"), JSON.stringify({ id: "2026-01-01-reworded", stage: "build", awaiting: null, session: "abc" }));
+  expect(cards()).toEqual(["run"]);
+  rmSync(join(dir, ".."), { recursive: true, force: true });
+});
+
 test("boardCards: a run older than the idea does not retire it", () => {
   const dir = join(mkdtempSync(join(tmpdir(), "kaizen-")), ".kaizen");
   const r = join(dir, "runs", "2026-01-01-old");

package/cli/state.ts

@@ -616,6 +616,7 @@ export type Card = {
   awaiting: string | null;
   dim: boolean;
   moved?: number;                                  // runs only: state.json mtime
+  added?: number;                                  // ideas only: when the inbox line first appeared (ms)
   title?: string;                                  // runs only: first line of the request
   archived: boolean;                               // hidden from the board unless asked for
   branch?: string;                                 // runs only: the run's own branch while it has a worktree
@@ -1001,6 +1002,9 @@ export function boardCards(states: string[], now: number): Card[] {
       for (const l of b.split("\n")) lines.push({ at, text: normalise(l.replace(/^[\s>*"'`-]+|[\s"'`.]+$/g, "")) });
     }
   }
+  // A launched idea whose run reworded the request: the board's own launch record,
+  // owned by a run (session id in its state.json, see ownerOf), retires it all the same.
+  const launchedInto = (st: string, t: string) => readSessions(st).some((s) => !s.run && normalise(s.text.replace(/^(lite|full|auto|plan)\s+/i, "")) === t.replace(/^(lite|full|auto|plan)\s+/i, "") && ownerOf(st, s) !== null);
   for (const st of states) {
     const where = label(st);
     const archive = readArchive(st);
@@ -1019,10 +1023,10 @@ export function boardCards(states: string[], now: number): Card[] {
       // titled "fix this bugs" must not swallow a new idea with the same words.
       // ponytail: 2s slack for coarse filesystem clocks.
       const after = (r: { at: number }) => !it.added || r.at >= it.added - 2000;
-      if (it.status === "started" ? requests.some((r) => after(r) && r.text.includes(t)) : lines.some((l) => after(l) && (l.text === t || l.text.endsWith(" " + t)))) continue;
+      if (it.status === "started" ? requests.some((r) => after(r) && r.text.includes(t)) || launchedInto(st, t) : lines.some((l) => after(l) && (l.text === t || l.text.endsWith(" " + t)))) continue;
       next.push(it.status === "started"
         ? { kind: "idea", status: "starting", text: it.text, state: st, where, column: 1, awaiting: null, dim: true, archived: false, notes: it.notes, parent: parentOf(it.notes) }
-        : { kind: "idea", status: "idea", text: it.text, state: st, where, column: 0, awaiting: null, dim: false, archived: it.status === "archived", notes: it.notes, parent: parentOf(it.notes) });
+        : { kind: "idea", status: "idea", text: it.text, state: st, where, column: 0, awaiting: null, dim: false, archived: it.status === "archived", notes: it.notes, parent: parentOf(it.notes), added: it.added });
     }
     // Runs started in Yolo. Only yolo records are matched to runs, so a project that
     // never used it pays one directory read.

package/cli/web.ts

@@ -10,7 +10,7 @@ import {
   launchMode, readSessions, ownerOf, resumePrompt, runAgent, firstSession, webHosts,
 } from "./state.ts";
 import { attachPty, writePty, resizePty, ptyState, ptyKeys, adoptLoginEnv } from "./pty.ts";
-import { readSources, addSource, removeSource, moveSource, setCategory, setWriteback, readIcebox, promote, dismiss, restore, markDone, markReplied, gatherSource, freshImages, gatherAll, gatherDirs, due, socialUrl, socialOf } from "./sources.ts";
+import { readSources, addSource, removeSource, moveSource, setCategory, setWriteback, readIcebox, promote, dismiss, restore, addItem, githubRepo, markDone, markReplied, gatherSource, freshImages, gatherAll, gatherDirs, due, socialUrl, socialOf } from "./sources.ts";
 import { projectLogo, LOGO_TYPES } from "./logo.ts";
 import * as chatgpt from "./chatgpt.ts";
 import * as google from "./google.ts";
@@ -688,6 +688,34 @@ export async function web(repoDir: string, opts: Opts = {}) {
           return json({ ok: true, added: knownProjects().length - before });
         }
 
+        // Clone a GitHub repository into the projects folder (else ~/Projects) and
+        // set it up as a project. Arguments go to git as an array: no shell.
+        if (path === "/clone") {
+          const link = typeof body.url === "string" ? body.url.trim() : "";
+          const name = githubRepo(link);
+          if (!name) return bad("paste a GitHub link: https://github.com/owner/repo or git@github.com:owner/repo.git");
+          const root = (await projectsRoot()) || join(home, "Projects");
+          // The page may name the folder: typed (~ allowed, relative to home) or picked.
+          // A new one is made, parents too; an empty one is used; anything else refused.
+          let to = join(root, name);
+          if (typeof body.to === "string" && body.to.trim()) {
+            const t = body.to.trim();
+            to = resolve(home, nativePath(t.startsWith("~") ? home + t.slice(1) : t));
+          }
+          if (body.check) return json({ ok: true, to, name });
+          let used = false;
+          try { used = readdirSync(to).length > 0; } catch (e) { used = existsSync(to); }
+          if (used) return bad(`${to} already exists and is not empty`, 409);
+          mkdirSync(to, { recursive: true });
+          const p = Bun.spawn(["git", "clone", "--", link, to], { stdin: "ignore", stdout: "ignore", stderr: "pipe", env: { ...process.env, GIT_TERMINAL_PROMPT: "0", GIT_SSH_COMMAND: process.env.GIT_SSH_COMMAND ?? "ssh -o BatchMode=yes" } });
+          const [err, code] = await Promise.all([new Response(p.stderr).text(), p.exited]);
+          if (code !== 0) return bad(err.trim().split("\n").filter(Boolean).pop() || "git clone failed", 500);
+          mkdirSync(join(to, ".kaizen"), { recursive: true });
+          remember(to);
+          changed();
+          return json({ ok: true, dir: join(to, ".kaizen") });
+        }
+
         // No project here means the global inbox, which is where the TUI puts ideas too.
         const dir: string = body.dir ?? state ?? join(home, ".kaizen");
         // Choosing a folder from the projects folder is what sets it up: an empty
@@ -787,6 +815,15 @@ export async function web(repoDir: string, opts: Opts = {}) {
           } catch (e) { return bad((e as Error).message, 500); }
         }
 
+        // Files added with a hand-written icebox item: saved beside the state, linked in its notes.
+        const iceFiles = (state: string, files: unknown) => {
+          const fs: { name: string; data: string }[] = Array.isArray(files) ? files : [];
+          if (fs.reduce((t, f) => t + (f.data?.length ?? 0), 0) > 20_000_000) throw new Error("attachments over 15MB");
+          return fs.map((f) => {
+            const rel = saveAttachment(state, null, String(f.name ?? "file"), Buffer.from(String(f.data).replace(/^data:[^,]*,/, ""), "base64"));
+            return (/\.(png|jpe?g|gif|webp|svg)$/i.test(rel) ? "!" : "") + `[${String(f.name ?? "file")}](${rel})`;
+          });
+        };
         // The icebox: the only way gathered text becomes an idea, one explicit click
         // (or agent call) at a time. An idea is made; no run starts.
         if (path === "/icebox") {
@@ -794,6 +831,7 @@ export async function web(repoDir: string, opts: Opts = {}) {
           const ids = Array.isArray(body.ids) ? body.ids.filter((i: unknown) => typeof i === "string") : [];
           try {
             const why = body.op === "promote" ? promote(body.dir, ids, typeof body.text === "string" ? body.text : undefined, typeof body.details === "string" ? body.details : undefined)
+              : body.op === "add" ? addItem(body.dir, typeof body.text === "string" ? body.text : "", [typeof body.details === "string" ? body.details : "", ...iceFiles(body.dir, body.files)].filter(Boolean).join("\n"))
               : body.op === "dismiss" ? dismiss(body.dir, ids) : body.op === "restore" ? restore(body.dir, ids) : "unknown op";
             if (why) return bad(why, why === "no such item" ? 404 : why === "unknown op" ? 400 : 409);
           } catch (e) { return bad((e as Error).message, 500); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaizen-agent",
-  "version": "1.40.3",
+  "version": "1.41.2",
   "description": "Staged workflow for AI agents — code, writing, research, operations: plan, human approval, build, independent review, bounded fix loop.",
   "type": "module",
   "bin": {

package/skills/kaizen/SKILL.md

@@ -341,7 +341,9 @@ changing because a setting moved:
 ```
 
 Every run writes all nine keys, from intake on: `id`, `mode`, `runner`, `agent`,
-`track`, `stage`, `awaiting`, `iteration` (0 until the fix loop runs), `updated`. The
+`track`, `stage`, `awaiting`, `iteration` (0 until the fix loop runs), `updated`. Where
+the environment has `CLAUDE_CODE_SESSION_ID`, also `session` with its value: without it
+a card launched from the board can stay stuck in planning beside its own run. The
 legal values of `stage` and `awaiting` are in [`spec.md`](spec.md).
 
 In a git repository, `init` also adds a gitignore entry that ignores run state but

package/web/board/cards.ts

@@ -2,7 +2,7 @@ import { store } from "./store.ts";
 import { where } from "./agent-term.ts";
 import { load, post } from "./api.ts";
 import { mic, stopDictation } from "./dictation.ts";
-import { $, esc, ico } from "./dom.ts";
+import { $, dataUrls, esc, ico } from "./dom.ts";
 import { draft, undraft } from "./drafts.ts";
 import { COLS, ICON, MARKS, NAMES, WORD, age, d, need } from "./labels.ts";
 import { brief } from "./markdown.ts";
@@ -468,6 +468,7 @@ export function render() {
     ...store.S.projects.map((p) => [p.label, p.dir]),
     ...store.S.fresh.map((p) => [p.label, p.dir, 1]),
     ["Find projects on this PC…", "__find"],
+    ["Clone from GitHub…", "__clone"],
   ];
   const cur = store.all || !store.S.dir ? "All projects" : (store.PL.find((p) => p[1] === store.S.dir) || ["All projects"])[0];
   $("proj").innerHTML =
@@ -501,13 +502,15 @@ export function render() {
         (archive || !nested(c)) &&
         (!q || `${c.title || ""} ${c.text || ""} ${c.id || ""}`.toLowerCase().includes(q)),
     );
-    // Runs age by their last move, ideas by inbox position (new ones are appended).
+    // Runs age by their last move, ideas by when they were added, across every project;
+    // an idea from before the stamp falls back to its inbox position.
     if (ci < 4) {
-      const at = (c) => (c.kind === "run" ? c.moved || 0 : store.S.cards.indexOf(c)),
-        old = order[ci] === "old";
+      const at = (c) => (c.kind === "run" ? c.moved || 0 : c.added || 0),
+        old = order[ci] === "old",
+        pos = (c) => store.S.cards.indexOf(c);
       // Runs waiting on you go first, then the column's own order.
       const w = (c) => (c.status === "waiting" ? 1 : 0);
-      list.sort((a, b) => w(b) - w(a) || (old ? at(a) - at(b) : at(b) - at(a)));
+      list.sort((a, b) => w(b) - w(a) || (old ? at(a) - at(b) || pos(a) - pos(b) : at(b) - at(a) || pos(b) - pos(a)));
     }
     const clearable = ci === 4 && !archive && list.length;
     const olderThan = (days) => list.filter((c) => store.S.now - (c.moved || store.S.now) > days * d);
@@ -606,16 +609,7 @@ export function render() {
           toast("Idea added");
           // The idea exists first: a failed upload leaves it as plain text.
           if (files.length) {
-            const enc = await Promise.all(
-              files.map(
-                (x) =>
-                  new Promise((res) => {
-                    const rd = new FileReader();
-                    rd.onload = () => res({ name: x.name, data: rd.result });
-                    rd.readAsDataURL(x);
-                  }),
-              ),
-            );
+            const enc = await dataUrls(files);
             const n = await post("/note", { dir, for: text, text: "", files: enc });
             if (!n.ok) toast("Idea added, files not attached");
           }

package/web/board/dom.ts

@@ -9,3 +9,26 @@ export const SKEL =
   '<span class="skel" style="height:16px;width:35%;margin:20px 0 14px"></span>' +
   '<span class="skel" style="height:44px;margin-bottom:10px"></span>'.repeat(4) +
   "</div>";
+// Files as {name, data-URL}, the shape /note and /icebox take.
+export const dataUrls = (files: File[]) =>
+  Promise.all(
+    files.map(
+      (x) =>
+        new Promise<{ name: string; data: string }>((res) => {
+          const rd = new FileReader();
+          rd.onload = () => res({ name: x.name, data: rd.result as string });
+          rd.readAsDataURL(x);
+        }),
+    ),
+  );
+// A modal form: the native <dialog>, removed from the page once closed.
+export function modal(html: string) {
+  const dl = document.createElement("dialog");
+  dl.className = "kz";
+  dl.innerHTML = `<form class="inl" method="dialog">${html}</form>`;
+  dl.onclose = () => dl.remove();
+  dl.onclick = (e) => e.target === dl && dl.close(); // a tap on the backdrop
+  document.body.appendChild(dl);
+  dl.showModal();
+  return dl;
+}

package/web/board/icebox.ts

@@ -2,9 +2,9 @@ import { store } from "./store.ts";
 import { termStop } from "./agent-term.ts";
 import { load, post } from "./api.ts";
 import { via } from "./cards.ts";
-import { stopDictation } from "./dictation.ts";
-import { $, esc, ico, SKEL } from "./dom.ts";
-import { plogo, setShown, short, showable } from "./projects.ts";
+import { mic, stopDictation } from "./dictation.ts";
+import { $, dataUrls, esc, ico, modal, SKEL } from "./dom.ts";
+import { ideaCombo, newDir, plogo, setShown, short, showable } from "./projects.ts";
 import { toast } from "./toast.ts";
 import { go, view } from "./views.ts";
 
@@ -340,7 +340,7 @@ export async function openSources() {
               .join(""),
         )
       : "");
-  const bar = `<div class="ice-bar">${order.length ? `<input type="checkbox" id="ice-all" aria-label="Select every request shown"${nSel && nSel === order.length ? " checked" : ""}>` : ""}<span class="count">${iceCat === "Dismissed" || iceCat === "Done" ? `${order.length} ${iceCat.toLowerCase()}` : `${order.length < waiting ? `${order.length} of ${waiting}` : waiting} waiting`}</span><span class="end"></span>${chips ? `<details class="ice-filt"><summary class="ib${iceCat || iceSrc ? " on" : ""}" aria-label="Filter requests" title="Filter requests">${ico("filter")}</summary><div class="ice-fpop">${chips}</div></details>` : ""}<button class="btn sm" id="src-go"${list.length ? "" : " disabled"}>${ico("refresh")} Gather all</button><button class="btn ghost sm" id="src-tog" aria-expanded="${srcShow ?? !list.length}" aria-controls="src-sec">${ico("link")} Sources · ${list.length}</button></div>`;
+  const bar = `<div class="ice-bar">${order.length ? `<input type="checkbox" id="ice-all" aria-label="Select every request shown"${nSel && nSel === order.length ? " checked" : ""}>` : ""}<span class="count">${iceCat === "Dismissed" || iceCat === "Done" ? `${order.length} ${iceCat.toLowerCase()}` : `${order.length < waiting ? `${order.length} of ${waiting}` : waiting} waiting`}</span><span class="end"></span>${chips ? `<details class="ice-filt"><summary class="ib${iceCat || iceSrc ? " on" : ""}" aria-label="Filter requests" title="Filter requests">${ico("filter")}</summary><div class="ice-fpop">${chips}</div></details>` : ""}<button class="btn ghost sm" id="ice-new" title="Add a request by hand">${ico("plus")} Add</button><button class="btn sm" id="src-go"${list.length ? "" : " disabled"}>${ico("refresh")} Gather all</button><button class="btn ghost sm" id="src-tog" aria-expanded="${srcShow ?? !list.length}" aria-controls="src-sec">${ico("link")} Sources · ${list.length}</button></div>`;
   const bulk = iceSel.size
     ? `<div class="ice-bulk" role="toolbar" aria-label="Selected requests"><span>${iceSel.size} selected</span><span class="end"></span><button class="btn sm" id="ice-bp" title="Promote (p)">${ico("plus")} Promote</button><button class="btn ghost sm" id="ice-bd" title="Dismiss (d)">${ico("x")} Dismiss</button><button class="btn ghost sm" id="ice-bc" title="Clear selection (Esc)">Clear</button></div>`
     : "";
@@ -987,6 +987,59 @@ export async function openSources() {
           if (e.key === "Enter") $("src-add").click();
         };
   }
+  if ($("ice-new"))
+    $("ice-new").onclick = () => {
+      const all = !dir;
+      if (!dir && !showable().length) return toast("Pick a project first");
+      // The new-idea form, cut down: the request, files, dictation and, in All projects, the project.
+      const dl = modal(
+        `${all ? `<div class="combo" id="ndc"><button type="button" class="sel" id="newdir" aria-label="Project for this request" aria-haspopup="listbox" aria-expanded="false"></button><div class="menu-pop" hidden><input class="sel" aria-label="Search projects" placeholder="Search projects…" spellcheck="false" autocomplete="off"><div id="nds" role="listbox"></div></div></div>` : ""}<textarea id="newidea" placeholder="New request for the icebox" aria-label="Request"></textarea><div class="att"></div><input type="file" multiple hidden><div class="row"><button type="button" class="ib" id="newpick" aria-label="Attach files" title="Attach files">${ico("clip")}</button><button type="button" class="btn ghost" value="">Cancel</button><button class="btn pri">Add</button></div>`,
+      );
+      const f = dl.querySelector("form"),
+        inp = f.querySelector("textarea"),
+        files = [];
+      const add = (x) => {
+        files.push(x);
+        f.querySelector(".att").textContent = files.map((y) => y.name).join(" · ");
+      };
+      f.querySelector("#newpick").onclick = () => f.querySelector("input[type=file]").click();
+      f.querySelector("input[type=file]").onchange = (e) => {
+        [...e.target.files].forEach(add);
+        e.target.value = "";
+      };
+      inp.onpaste = (e) => {
+        for (const it of e.clipboardData.items)
+          if (it.kind === "file") {
+            const x = it.getAsFile();
+            add(new File([x], x.name === "image.png" ? `paste-${Date.now()}.png` : x.name, { type: x.type }));
+            e.preventDefault();
+          }
+      };
+      f.querySelector(".btn.ghost").onclick = () => dl.close();
+      if (all) ideaCombo(f);
+      const m = mic([inp]);
+      if (m) f.querySelector(".row").prepend(m);
+      dl.addEventListener("close", () => stopDictation(false));
+      inp.onkeydown = (e) => {
+        if (e.key === "Enter" && !e.shiftKey) {
+          e.preventDefault();
+          f.requestSubmit();
+        }
+      };
+      f.onsubmit = async (e) => {
+        e.preventDefault();
+        const text = inp.value.trim(),
+          to = dir || newDir;
+        if (!text) return inp.focus();
+        if (!to) return toast("Pick a project first");
+        const j = await post("/icebox", { op: "add", dir: to, text, files: await dataUrls(files) });
+        if (j.ok) {
+          toast("Added to the icebox");
+          dl.close();
+        }
+      };
+      inp.focus();
+    };
   if ($("src-go"))
     $("src-go").onclick = () => {
       $("src-go").disabled = true;

package/web/board/projects.ts

@@ -1,7 +1,7 @@
 import { store } from "./store.ts";
 import { load, post } from "./api.ts";
 import { render } from "./cards.ts";
-import { $, esc, ico } from "./dom.ts";
+import { $, esc, ico, modal } from "./dom.ts";
 import { openSources, srcOpen } from "./icebox.ts";
 import { toast } from "./toast.ts";
 import { view } from "./views.ts";
@@ -35,7 +35,7 @@ export function list() {
     store.PL.map((p, i) =>
       p[0].toLowerCase().includes(q)
         ? (p[2] && !g++ ? `<div class="grp">In your projects folder</div>` : "") +
-          `<button role="option" data-i="${i}" title="${esc(p[0])}">${p[1] === "all" ? `<span class="plogo" aria-hidden="true">${ico("board")}</span><span>${esc(p[0])}</span>` : p[1] === "__find" ? `<span class="plogo" aria-hidden="true">${ico("plus")}</span><span>${esc(p[0])}</span>` : prow(p[1], p[0])}</button>`
+          `<button role="option" data-i="${i}" title="${esc(p[0])}">${p[1] === "all" ? `<span class="plogo" aria-hidden="true">${ico("board")}</span><span>${esc(p[0])}</span>` : p[1] === "__find" || p[1] === "__clone" ? `<span class="plogo" aria-hidden="true">${ico("plus")}</span><span>${esc(p[0])}</span>` : prow(p[1], p[0])}</button>`
         : "",
     ).join("") || `<div class="grp">No match</div>`;
   const f = $("projs").querySelector("button");
@@ -55,6 +55,51 @@ async function pick(v) {
     toast("Searching…");
     const j = await post("/find", {});
     if (j.ok) toast(j.added ? `Found ${j.added} new project${j.added === 1 ? "" : "s"}` : "No new projects found");
+  } else if (v === "__clone") {
+    // One form: the link, then where it goes. The folder fills in once the link names a repo.
+    const dl = modal(
+      `<b>Clone from GitHub</b><input name="url" placeholder="https://github.com/owner/repo or git@github.com:owner/repo" aria-label="GitHub link (https or ssh)" spellcheck="false" autocomplete="off"><div class="row"><input name="to" placeholder="Clone into (a new folder is made)" aria-label="Clone into" spellcheck="false" autocomplete="off"><button type="button" class="btn ghost" data-a="pick">Pick…</button></div><div class="row"><button type="button" class="btn ghost" data-a="x">Cancel</button><button class="btn pri">Clone</button></div>`,
+    );
+    const f = dl.querySelector("form"),
+      url = f.querySelector("[name=url]"),
+      to = f.querySelector("[name=to]");
+    let name = "",
+      auto = ""; // the folder this form filled in; one the user typed is left alone
+    const check = async () => {
+      const u = url.value.trim();
+      if (!u) return null;
+      const d = await post("/clone", { url: u, check: true });
+      if (!d.ok) return null;
+      name = d.name;
+      if (!to.value.trim() || to.value === auto) to.value = auto = d.to;
+      return d;
+    };
+    url.onchange = check;
+    f.querySelector("[data-a=x]").onclick = () => dl.close();
+    f.querySelector("[data-a=pick]").onclick = async () => {
+      if (!(await check())) return url.focus();
+      const p = await post("/pick-folder", {});
+      if (p.path) to.value = p.path.replace(/[\\/]+$/, "") + (p.path.includes("\\") ? "\\" : "/") + name;
+    };
+    url.focus();
+    const dir = await new Promise((done) => {
+      dl.addEventListener("close", () => done(null));
+      f.onsubmit = async (e) => {
+        e.preventDefault();
+        if (!(await check())) return url.focus();
+        toast("Cloning…");
+        const j = await post("/clone", { url: url.value.trim(), to: to.value.trim() || undefined });
+        if (!j.ok) return;
+        done(j.dir);
+        dl.close();
+      };
+    });
+    if (!dir) return;
+    await post("/cd", { dir });
+    store.all = false;
+    store.dir = dir;
+    keep(dir);
+    toast("Cloned");
   } else if (v === "all") {
     store.all = true;
     keep();

package/web/board.html

@@ -219,6 +219,7 @@ section li.hint{display:block;padding:14px;border:1px dashed var(--line);border-
 .inl input::placeholder,.inl textarea::placeholder,.notes textarea::placeholder{color:var(--dim)}
 .inl .row,.notes .row{display:flex;gap:6px;justify-content:flex-end;align-items:center}
 .inl .row .mic{margin-right:0}.inl .row #newpick{margin-right:auto}.inl .row .btn{white-space:nowrap}.inl .att{font-size:12px;color:var(--dim)}.inl .att{font-size:12px;color:var(--dim)}.inl .att:empty{display:none}
+dialog.kz{border:0;padding:0;background:none;width:min(480px,calc(100vw - 32px));max-height:calc(100dvh - 32px);overflow:visible;color:var(--ink)}dialog.kz::backdrop{background:rgb(0 0 0/.45)}dialog.kz .row input{flex:1;min-width:0}dialog.kz #ndc{align-self:flex-start}
 .inl .run-actions{display:grid;gap:8px}.inl .run-actions .row{display:grid;grid-template-columns:repeat(2,minmax(0,1fr))}.inl .run-actions .pri{grid-column:1/-1}
 .notes{display:flex;flex-direction:column;gap:8px}
 #pbody img{max-width:100%;border-radius:var(--r-s)}