bitpull 0.1.30 → 0.1.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitpull",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "description": "BitPull (bitpull.cloud): share signed, AI-readable code, computing power and open AI models with AI tools through MCP. CLI and MCP server.",
   "mcpName": "io.github.SamuealPK/bitpull",
   "bin": {

package/ui/drop.js

@@ -0,0 +1,155 @@
+// Dropping things on the app's window. The desktop app tells the agent what was dropped (real paths,
+// which a page can never see) and calls window.bitpullDropped with an id and what it is. A folder
+// opens a window asking to authorise it and open it in Projects; files go to the chat.
+(() => {
+  const BP = window.__BITPULL__ || {};
+  const token = BP.token || "";
+  const lang = BP.lang || document.documentElement.lang || "en";
+  let dict = {};
+  let fallback = {};
+  const ready = Promise.all([
+    fetch("/i18n/en.json").then((r) => r.json()).then((d) => (fallback = d), () => {}),
+    lang === "en" ? null : fetch(`/i18n/${lang}.json`).then((r) => (r.ok ? r.json() : {})).then((d) => (dict = d), () => {}),
+  ]);
+  const t = (k, vars = {}) => String(dict[k] ?? fallback[k] ?? k).replace(/\{(\w+)\}/g, (m, v) => (v in vars ? vars[v] : m));
+  const api = (path, body) =>
+    fetch(path, { method: "POST", headers: { "content-type": "application/json", "x-bitpull-token": token }, body: JSON.stringify(body) }).then(async (r) => {
+      const data = await r.json().catch(() => ({}));
+      if (!r.ok) throw new Error((data.error && (data.error.message || data.error)) || String(r.status));
+      return data;
+    });
+
+  const css = document.createElement("style");
+  css.textContent = `
+  .bp-drop-veil { position:fixed; inset:0; z-index:9998; display:none; align-items:center; justify-content:center; padding:24px;
+    background:rgba(20,22,28,.55); backdrop-filter:blur(2px); pointer-events:none; }
+  .bp-drop-veil.on { display:flex; }
+  .bp-drop-veil div { border:2px dashed #8ea2ff; border-radius:18px; padding:28px 32px; max-width:520px; text-align:center;
+    color:#fff; font:600 17px/1.45 system-ui, sans-serif; background:rgba(30,33,44,.85); }
+  .bp-drop-dialog { position:fixed; inset:0; z-index:9999; display:flex; align-items:center; justify-content:center; padding:16px; background:rgba(0,0,0,.45); }
+  .bp-drop-card { width:min(480px,100%); border-radius:16px; padding:22px; background:var(--surface,#1f2128); color:var(--text,#ececec);
+    border:1px solid var(--line,#33363f); box-shadow:0 18px 50px rgba(0,0,0,.4); font:15px/1.5 system-ui, sans-serif; }
+  .bp-drop-card h2 { margin:0 0 6px; font-size:19px; }
+  .bp-drop-card .bp-drop-path { margin:10px 0 12px; padding:10px 12px; border-radius:10px; background:var(--bg,#16181d); font:13px/1.4 ui-monospace, Menlo, Consolas, monospace; overflow-wrap:anywhere; }
+  .bp-drop-card p { margin:0 0 10px; color:var(--muted,#a2a19b); font-size:14px; }
+  .bp-drop-card .bp-drop-row { display:flex; gap:10px; justify-content:flex-end; flex-wrap:wrap; margin-top:16px; }
+  .bp-drop-card button { min-height:40px; padding:8px 16px; border-radius:10px; border:1px solid var(--line,#33363f); font:600 14px system-ui, sans-serif; cursor:pointer;
+    background:transparent; color:var(--text,#ececec); }
+  .bp-drop-card button.bp-yes { background:var(--accent,#7f95ff); border-color:var(--accent,#7f95ff); color:#0d0f14; }
+  .bp-drop-card .bp-drop-msg { color:#ff8a8a; font-size:13px; min-height:1em; }`;
+  document.head.appendChild(css);
+
+  const veil = document.createElement("div");
+  veil.className = "bp-drop-veil";
+  veil.setAttribute("aria-hidden", "true");
+  veil.appendChild(document.createElement("div"));
+  document.addEventListener("DOMContentLoaded", () => document.body.appendChild(veil));
+  if (document.body) document.body.appendChild(veil);
+
+  window.bitpullDragging = async (on) => {
+    await ready;
+    veil.firstChild.textContent = t("drop.here");
+    veil.classList.toggle("on", !!on);
+  };
+
+  /** A small window of its own, so it looks the same on every page. */
+  function dialog({ title, path, text, yes, onYes }) {
+    const wrap = document.createElement("div");
+    wrap.className = "bp-drop-dialog";
+    wrap.setAttribute("role", "dialog");
+    wrap.setAttribute("aria-modal", "true");
+    const card = document.createElement("div");
+    card.className = "bp-drop-card";
+    const h = document.createElement("h2");
+    h.textContent = title;
+    card.append(h);
+    if (path) {
+      const p = document.createElement("div");
+      p.className = "bp-drop-path";
+      p.textContent = path;
+      card.append(p);
+    }
+    for (const line of [].concat(text || [])) {
+      const p = document.createElement("p");
+      p.textContent = line;
+      card.append(p);
+    }
+    const msg = document.createElement("div");
+    msg.className = "bp-drop-msg";
+    const row = document.createElement("div");
+    row.className = "bp-drop-row";
+    const close = () => wrap.remove();
+    const no = document.createElement("button");
+    no.textContent = onYes ? t("drop.no") : t("drop.ok");
+    no.dataset.tip = "tip.drop.no";
+    no.title = t("tip.drop.no");
+    no.addEventListener("click", close);
+    row.append(no);
+    if (onYes) {
+      const ok = document.createElement("button");
+      ok.className = "bp-yes";
+      ok.textContent = yes;
+      ok.dataset.tip = "tip.drop.yes";
+      ok.title = t("tip.drop.yes");
+      ok.addEventListener("click", async () => {
+        ok.disabled = no.disabled = true;
+        try {
+          await onYes();
+          close();
+        } catch (err) {
+          msg.textContent = err.message === "not a folder" ? t("drop.failed") : `${t("drop.failed")} (${err.message})`;
+          ok.disabled = no.disabled = false;
+        }
+      });
+      row.append(ok);
+      setTimeout(() => ok.focus(), 0);
+    }
+    card.append(msg, row);
+    wrap.append(card);
+    wrap.addEventListener("click", (e) => e.target === wrap && close());
+    wrap.addEventListener("keydown", (e) => e.key === "Escape" && close());
+    document.body.appendChild(wrap);
+  }
+
+  const openProjects = (folder) => {
+    const q = new URLSearchParams({ token, lang, folder });
+    if (location.pathname === "/ide") {
+      location.hash = q.toString();
+      location.reload();
+    } else location.href = `/ide#${q}`;
+  };
+
+  window.bitpullDropped = async (drop, x, y) => {
+    await ready;
+    if (!drop || !Array.isArray(drop.items) || !drop.items.length) {
+      return dialog({ title: t("drop.failed.title"), text: t("drop.failed") });
+    }
+    const folders = drop.items.filter((i) => i.kind === "folder");
+    const files = drop.items.filter((i) => i.kind === "file");
+    if (folders.length) {
+      const f = folders[0];
+      return dialog({
+        title: t("drop.title"),
+        path: f.path,
+        text: [t("drop.text"), folders.length > 1 ? t("drop.more", { n: folders.length - 1 }) : ""].filter(Boolean),
+        yes: t("drop.yes"),
+        onYes: async () => {
+          const r = await api("/api/drop/folder", { id: drop.id, i: f.i });
+          openProjects(r.folder);
+        },
+      });
+    }
+    // Files: into the chat, where a page knows how to attach them.
+    if (files.length && typeof window.bitpullAttach === "function") {
+      const list = [];
+      for (const f of files) {
+        const r = await fetch(`/api/drop/file?id=${encodeURIComponent(drop.id)}&i=${f.i}`, { headers: { "x-bitpull-token": token } });
+        if (r.status === 413) return dialog({ title: t("drop.failed.title"), text: t("drop.big", { name: f.name }) });
+        if (!r.ok) continue;
+        list.push(new File([await r.blob()], f.name));
+      }
+      if (list.length) return window.bitpullAttach(list, x, y);
+    }
+    return dialog({ title: t("drop.files.title"), text: t("drop.files") });
+  };
+})();

package/ui/ide-terminal.js

@@ -10,8 +10,24 @@ function register() {
   let opts = null;
   let term = null;
   let current = null;
+  let note = null;
   const start = () => {
-    if (term || !host || !opts || !opts.folder) return;
+    if (term || !host || !opts) return;
+    // No folder: say what is missing instead of an empty box.
+    if (!opts.folder) {
+      if (!note) {
+        note = document.createElement("div");
+        note.className = "bp-term-msg";
+        note.style.padding = "14px";
+        note.textContent = opts.t ? opts.t("term.nofolder") : "term.nofolder";
+        host.appendChild(note);
+      }
+      return;
+    }
+    if (note) {
+      note.remove();
+      note = null;
+    }
     term = mountTerminal(host, { cwd: opts.folder, token: opts.token, t: opts.t, fontSize: opts.phone ? 12 : 13, keep: !!opts.phone });
   };
   ide.terminal.register({
@@ -54,11 +70,13 @@ function register() {
       if (!opts) return;
       opts.folder = folder;
       // A new folder is a new place to work: the old shells close, new ones open there.
+      // Only where the terminal was already shown (open, or saying a folder was missing).
+      const shown = !!term || !!note;
       if (term) {
         term.dispose();
         term = null;
-        start();
       }
+      if (shown) start();
     },
   });
 }

package/ui/ide.css

@@ -333,3 +333,13 @@ button.sb:hover { background: var(--hover); color: var(--text); }
 #phone-keys button { flex: none; min-width: 46px; height: 40px; padding: 0 10px; border: 1px solid var(--line2); border-radius: 8px; background: var(--raised); color: var(--bright); font: 14px ui-monospace, Menlo, Consolas, monospace; }
 #phone-keys button.on { background: var(--accent); color: var(--accent-ink); border-color: var(--accent); }
 #ide.phone.typing .agent-top { display: none; }
+
+/* Projects without a folder: plainly what to do. */
+#welcome-nofolder .nofolder-ways { text-align:start; margin:10px auto 14px; max-width:460px; line-height:1.6; }
+#welcome-nofolder button { margin-top:4px; }
+
+/* Quick commands: the line under the box, and texts shown by a command (/btw, /context, /status). */
+#qc-line { min-height: 0; padding: 2px 4px 0; white-space: pre-wrap; }
+#qc-line:empty { display: none; }
+#qc-line.warn { color: var(--warn, #e0a64b); }
+.qc-pre { white-space: pre-wrap; max-height: 60vh; overflow: auto; margin: 0; font: 13px/1.5 ui-monospace, Menlo, Consolas, monospace; }

package/ui/ide.html

@@ -27,6 +27,9 @@
     term.type = "module";
     term.src = "/ui/ide-terminal.js";
     document.body.appendChild(term);
+    var drop = document.createElement("script");
+    drop.src = "/ui/drop.js";
+    document.body.appendChild(drop);
   });
 })();
 </script>
@@ -114,7 +117,7 @@
         <div id="editor" dir="ltr"></div>
         <div id="editor2" dir="ltr" hidden></div>
         <div id="diff" dir="ltr" hidden></div>
-        <div id="welcome"><div class="welcome-box"><div class="logo" data-icon="logo"></div><h2 data-i18n="ide.welcome"></h2><p class="muted" data-i18n="ide.welcome.text"></p><table id="keys" class="keys"></table></div></div>
+        <div id="welcome"><div class="welcome-box"><div class="logo" data-icon="logo"></div><div id="welcome-nofolder" hidden><h2 data-i18n="ide.nofolder.title"></h2><p class="muted" data-i18n="ide.nofolder.text"></p><ol class="muted nofolder-ways"><li data-i18n="ide.nofolder.drag"></li><li data-i18n="ide.nofolder.pick"></li><li data-i18n="ide.nofolder.panel"></li></ol><button id="nofolder-panel" data-i18n="ide.nofolder.open" data-tip="tip.ide.nofolder.open"></button></div><div id="welcome-folder"><h2 data-i18n="ide.welcome"></h2><p class="muted" data-i18n="ide.welcome.text"></p></div><table id="keys" class="keys"></table></div></div>
       </div>
     </main>
     <div class="sash" data-split="panel" data-tip="tip.ide.resize"></div>
@@ -156,6 +159,7 @@
           <button class="ib danger" id="agent-stop" data-tip="tip.pj.stop" data-icon="stop" hidden></button>
           <button class="send" id="agent-send" data-tip="tip.pj.send" data-icon="send"></button>
         </div>
+        <div id="qc-line" class="muted small" aria-live="polite"></div>
         <div id="mode-hint" class="muted small"></div>
       </div>
     </aside>

package/ui/ide.js

@@ -106,6 +106,8 @@
     document.title = `${t("ide.title")} · BitPull`;
     for (const n of document.querySelectorAll("[data-i18n]")) n.textContent = t(n.dataset.i18n);
     for (const n of document.querySelectorAll("[data-i18n-placeholder]")) n.placeholder = t(n.dataset.i18nPlaceholder);
+    // The empty box says how to find the commands and the shortcuts.
+    $("prompt").placeholder = `${t("ide.prompt.placeholder")}\n${t("qc.hint")}`;
     for (const n of document.querySelectorAll("[data-tip]")) n.setAttribute("aria-label", t(n.dataset.tip));
   }
   /** A known error's words, or the error as it came. */
@@ -1091,6 +1093,9 @@
     const sel = clear($("folder"));
     for (const f of r.folders) sel.append(el("option", { value: f, text: f }));
     if (!r.folders.length) sel.append(el("option", { value: "", text: t("ide.folder.none") }));
+    // No folder at all: say so in the middle of the page too, not only in the list at the top.
+    $("welcome-nofolder").hidden = r.folders.length > 0 && !!sel.value;
+    $("welcome-folder").hidden = !$("welcome-nofolder").hidden;
     const want = BP.folder || store.get("folder", "");
     sel.value = r.folders.includes(want) ? want : r.folders[0] || "";
     return r;
@@ -1101,6 +1106,9 @@
     folder = f;
     store.set("folder", f);
     $("folder-name").textContent = f ? folderLabel(f) : t("ide.folder.none");
+    // No folder yet: the page says plainly to choose the one to work on, and how.
+    $("welcome-nofolder").hidden = !!f;
+    $("welcome-folder").hidden = !f;
     $("tree-title").textContent = f ? folderLabel(f) : "";
     $("palette-label").textContent = f ? `${folderLabel(f)} — ${t("ide.palette.hint", { keys: `${MOD}⇧P` })}` : t("ide.palette");
     session = null;
@@ -1112,6 +1120,7 @@
     await refreshGit();
     refreshTree();
     if (terminal && terminal.folderChanged) terminal.folderChanged(f);
+    if (quick) quick.refreshSkills();
     await refreshAgents();
   }
   $("folder").addEventListener("change", () => setFolder($("folder").value));
@@ -1226,6 +1235,9 @@
     }
     log.scrollTop = log.scrollHeight;
     $("agent-status").textContent = `${t(`pj.status.${v.status}`)}  ·  ${t("pj.used", { steps: v.used.steps, minutes: v.used.minutes, credits: Math.round(v.used.credits * 100) / 100 })}  ·  ${t("ide.limits.short", { steps: v.limits.steps, minutes: v.limits.minutes, credits: v.limits.credits || "—" })}`;
+    const nowBusy = STATUS_BUSY.has(v.status);
+    if (quick && renderAgent.wasBusy && !nowBusy) setTimeout(() => quick.idle(), 0);
+    renderAgent.wasBusy = nowBusy;
     $("agent-stop").hidden = !STATUS_BUSY.has(v.status);
     $("agent-send").hidden = STATUS_BUSY.has(v.status);
     $("agent-undo").hidden = !v.canUndo;
@@ -1306,11 +1318,13 @@
       if (e.key === "ArrowDown") { mentionSel = Math.min(mentionItems.length - 1, mentionSel + 1); drawMentions(); e.preventDefault(); return; }
       if (e.key === "ArrowUp") { mentionSel = Math.max(0, mentionSel - 1); drawMentions(); e.preventDefault(); return; }
       if (e.key === "Enter" || e.key === "Tab") { e.preventDefault(); insertMention(mentionItems[mentionSel]); return; }
-      if (e.key === "Escape") { mentionItems = []; drawMentions(); return; }
+      if (e.key === "Escape") { e.preventDefault(); mentionItems = []; drawMentions(); return; }
     }
-    if (e.key === "Enter" && !e.shiftKey && !e.isComposing) { e.preventDefault(); send(); }
+    // Enter, Esc and the other keys of the box: the quick commands (quick.js). Without them, Enter sends.
+    if (!quick && e.key === "Enter" && !e.shiftKey && !e.isComposing) { e.preventDefault(); send(); }
   });
   async function send() {
+    if (quick) return quick.submit();
     const text = $("prompt").value.trim();
     if (!text) return;
     if (!session && !(await newAgent())) return;
@@ -1327,6 +1341,224 @@
     if (!(await confirmBox(t("pj.undo"), t("ide.undo.confirm"), t("pj.undo"), true))) return;
     try { renderAgent(await api("/api/projects/undo", { id: session.id })); for (const tab of tabs) if (!isDirty(tab)) reloadTab(tab).catch(() => {}); refreshTree(); } catch (err) { output(explain(err)); }
   });
+  // ---- quick commands: "/", "!", ":", "?" and the keys of the composer (see quick.js) ---------------------
+  const quickReady = new Promise((resolve) => {
+    if (window.BitPullQuick) return resolve(window.BitPullQuick);
+    const s = document.createElement("script");
+    s.src = `${BASE}quick.js`;
+    s.onload = () => resolve(window.BitPullQuick);
+    s.onerror = () => resolve(null);
+    document.head.appendChild(s);
+  });
+  let quick = null;
+  const agentBusy = () => !!(session && STATUS_BUSY.has(session.status));
+  const say = (text, kind) => { const line = $("qc-line"); line.textContent = text || ""; line.className = `small ${kind === "warn" ? "warn" : "muted"}`; };
+  /** Where a command of the panel lives: the panel opens on that part. */
+  const toPanel = (section) => { location.href = `${PHONE ? "/remote/" : "/"}#token=${encodeURIComponent(token)}&lang=${encodeURIComponent(lang)}&view=panel${section ? `&section=${encodeURIComponent(section)}` : ""}`; };
+  const ensureAgent = async () => session || (await newAgent());
+  /** A message to the agent, as if typed (used by /review, /init and the others that ask for work). */
+  async function ask(text) {
+    if (!(await ensureAgent())) return;
+    try { renderAgent(await api("/api/projects/send", { id: session.id, text })); } catch (err) { output(explain(err)); say(explain(err), "warn"); }
+  }
+  const logText = () => [...$("agent-log").children].map((n) => (n.classList.contains("user") ? `> ${n.textContent}` : n.textContent)).join("\n\n");
+  const answers = () => [...$("agent-log").querySelectorAll(".ev:not(.user):not(.action):not(.output):not(.notice):not(.error)")].map((n) => n.textContent);
+  const copyOut = async (text) => { try { await navigator.clipboard.writeText(text); say(t("qc.copied"), "info"); } catch { await modal(t("qc.copy.title"), el("textarea", { rows: 12, readonly: true, text }), [{ label: t("ide.ok"), value: null }]); } };
+  const showText = (title, text) => modal(title, el("pre", { class: "qc-pre", text }), [{ label: t("ide.ok"), value: null }]);
+  const shellReply = () => store.get("qcShellReply", true) !== false;
+  let loopTimer = null;
+
+  const PROMPTS = {
+    review: "Review the changes in this project that are not committed yet (git diff), or the files I name. List real problems first: bugs, security, missing error handling, then smaller things. Do not change files.",
+    "security-review": "Do a security review of the changes not committed yet (git diff): injection, secrets in code, unsafe input handling, permissions, dependencies. Explain each problem and how to fix it. Do not change files.",
+    simplify: "Look at the recently changed code for duplication, needless complexity and dead code, and simplify it without changing what it does. Then run the tests.",
+    verify: "Check that the work done so far really works: build it, run the tests and, where possible, run the program. Report what passed and what failed.",
+    debug: "Help me find the cause of a problem. Reproduce it first, read the relevant code and logs, form a hypothesis, check it, then fix it.",
+    init: `Create (or improve, if it exists) an instruction file for this project named ${"BITPULL.md"} in the project's root: what the project is, how to install, build, test and run it, the layout of the folders, and the rules for the code style that you can see. Keep it short and exact.`,
+    recap: "In a few lines: what have we done so far, and what is left to do?",
+  };
+
+  const H = {
+    clear: async (name) => { if (await newAgent() && name) renderAgent(await api("/api/projects/rename", { id: session.id, title: name })); },
+    compact: async (instructions) => {
+      if (!session) return say(t("qc.noagent"), "warn");
+      say(t("qc.compacting"), "info");
+      try { renderAgent(await api("/api/projects/compact", { id: session.id, instructions })); say(t("qc.compacted"), "info"); } catch (err) { say(explain(err), "warn"); }
+    },
+    resume: async (name) => {
+      await refreshAgents();
+      const q = name.toLowerCase();
+      const hit = q && agentList.find((a) => (a.title || "").toLowerCase().includes(q));
+      if (hit) return selectAgent(hit.id);
+      if (!agentList.length) return say(t("qc.noagents"), "warn");
+      menu($("prompt"), agentList.slice(0, 30).map((a) => ({ label: a.title || t("ide.agent.untitled"), keys: t(`pj.status.${a.status}`).replace(/[.…]$/, ""), check: session && a.id === session.id, run: () => selectAgent(a.id) })));
+    },
+    rename: async (name) => {
+      if (!session) return say(t("qc.noagent"), "warn");
+      const title = name || (await askText(t("qc.rename.title"), t("qc.rename.text"), session.title || ""));
+      if (title) { renderAgent(await api("/api/projects/rename", { id: session.id, title })); refreshAgents(); }
+    },
+    export: (file) => window.BitPullQuick.download(file || `${(session && session.title) || "bitpull-agent"}.txt`.replace(/[\\/:*?"<>|]/g, "_"), logText()),
+    copy: (n) => { const list = answers(); const i = Math.max(1, Number(n) || 1); const text = list[list.length - i]; if (!text) return say(t("qc.copy.none"), "warn"); return copyOut(text); },
+    recap: () => H.btw(PROMPTS.recap),
+    btw: async (question) => {
+      if (!question) return say(t("qc.btw.empty"), "warn");
+      if (!session) return say(t("qc.noagent"), "warn");
+      say(t("qc.thinking"), "info");
+      try { const r = await api("/api/projects/aside", { id: session.id, question }); say("", "info"); await showText(t("qc.btw.title"), r.answer); } catch (err) { say(explain(err), "warn"); }
+    },
+    rewind: () => { if (!session || $("agent-undo").hidden) return say(t("qc.rewind.none"), "warn"); $("agent-undo").click(); },
+    stop: () => { if (agentBusy()) $("agent-stop").click(); },
+    exit: () => $("back").click(),
+    "add-dir": async (path) => {
+      if (!path) return addFolder();
+      try { await api("/api/folders", { path }); await loadFolders(); say(t("qc.folder.added"), "info"); } catch (err) { say(explain(err), "warn"); }
+    },
+    cd: (path) => {
+      const options = [...$("folder").options].map((o) => o.value).filter(Boolean);
+      const q = path.toLowerCase();
+      const hit = q && (options.find((f) => f.toLowerCase() === q) || options.find((f) => folderLabel(f).toLowerCase() === q) || options.find((f) => f.toLowerCase().includes(q)));
+      if (hit) { $("folder").value = hit; return setFolder(hit); }
+      $("folder-btn").click();
+    },
+    init: () => ask(PROMPTS.init),
+    memory: async () => {
+      if (!folder) return say(t("pj.err.project_folder_not_authorised"), "warn");
+      const tree = await api("/api/ws/tree", { folder, path: "." }).catch(() => ({ entries: [] }));
+      const names = new Set((tree.entries || tree.items || []).map((e) => e.name || e.path));
+      const found = ["BITPULL.md", "AGENTS.md", "CLAUDE.md"].find((n) => names.has(n));
+      if (found) return openFile(found);
+      if (!(await confirmBox(t("qc.memory.title"), t("qc.memory.none"), t("qc.memory.create")))) return;
+      try { await api("/api/ws/write", { folder, path: "BITPULL.md", content: "# Instructions for the agent\n\n- \n" }); refreshTree(); openFile("BITPULL.md"); } catch (err) { say(explain(err), "warn"); }
+    },
+    context: async () => {
+      if (!session) return say(t("qc.noagent"), "warn");
+      const c = await api("/api/projects/context", { id: session.id });
+      const pct = (n) => `${Math.round((n / c.limit) * 100)}%`;
+      await showText(t("qc.context.title"), [
+        t("qc.context.used", { used: pct(c.used), chars: c.used.toLocaleString(), limit: c.limit.toLocaleString() }),
+        "",
+        `${t("qc.context.system")}: ${pct(c.parts.system)}`,
+        `${t("qc.context.person")}: ${pct(c.parts.person)}`,
+        `${t("qc.context.agent")}: ${pct(c.parts.agent)}`,
+        `${t("qc.context.results")}: ${pct(c.parts.results)}`,
+        "",
+        t("qc.context.hint"),
+      ].join("\n"));
+    },
+    model: (name) => {
+      const sel = $("model");
+      const q = name.toLowerCase();
+      const opt = q && [...sel.options].find((o) => !o.disabled && o.textContent.toLowerCase().includes(q));
+      if (opt) { sel.value = opt.value; sel.dispatchEvent(new Event("change")); return say(t("qc.model.set", { name: opt.textContent }), "info"); }
+      sel.focus();
+      try { sel.showPicker(); } catch {}
+    },
+    plan: (desc) => { setMode("ask"); if (desc) return ask(`Make a plan, step by step, before changing anything: ${desc}`); say(t("qc.plan.on"), "info"); },
+    permissions: (mode) => { if (MODES.includes(mode)) return setMode(mode); $("mode").focus(); try { $("mode").showPicker(); } catch {} },
+    diff: () => showSide("git"),
+    review: (focus) => ask(`${PROMPTS.review}${focus ? ` Focus on: ${focus}` : ""}`),
+    "security-review": () => ask(PROMPTS["security-review"]),
+    simplify: (target) => ask(`${PROMPTS.simplify}${target ? ` Look at: ${target}` : ""}`),
+    verify: () => ask(PROMPTS.verify),
+    debug: (desc) => ask(`${PROMPTS.debug}${desc ? ` The problem: ${desc}` : ""}`),
+    tasks: () => showTerminal(),
+    loop: (args) => {
+      if (/^stop$/i.test(args) || (!args && loopTimer)) { clearInterval(loopTimer); loopTimer = null; return say(t("qc.loop.stopped"), "info"); }
+      const m = /^(\d+)\s*([smh])\b\s*([\s\S]*)$/i.exec(args);
+      const every = m ? Number(m[1]) * { s: 1, m: 60, h: 3600 }[m[2].toLowerCase()] : 600;
+      const prompt = (m ? m[3] : args).trim();
+      if (!prompt) return say(t("qc.loop.empty"), "warn");
+      clearInterval(loopTimer);
+      const seconds = Math.max(60, every);
+      loopTimer = setInterval(() => { if (!agentBusy()) quick.submitText(prompt); }, seconds * 1000);
+      quick.submitText(prompt);
+      say(t("qc.loop.on", { minutes: Math.round(seconds / 60) }), "info");
+    },
+    skills: async () => {
+      const r = await api("/api/quick/commands", { folder }).catch(() => ({ skills: [] }));
+      const lines = r.skills.length ? r.skills.map((s) => `/${s.name}${s.argumentHint ? ` ${s.argumentHint}` : ""} — ${s.description || ""}\n   ${s.file}`) : [t("qc.skills.none")];
+      await showText(t("qc.skills.title"), `${lines.join("\n")}\n\n${t("qc.skills.how")}`);
+    },
+    "reload-skills": async () => { await quick.refreshSkills(); say(t("qc.skills.reloaded"), "info"); },
+    config: () => $("settings-btn").click(),
+    theme: () => $("settings-btn").click(),
+    keybindings: () => showText(t("qc.keys.title"), `${t("qc.keys.file", { file: quick.keymapFile() || "~/.bitpull/keybindings.json" })}\n\n${JSON.stringify(quick.keys(), null, 2)}`),
+    "shell-reply": (v) => { const on = v ? /^(on|1|yes|si|sì|true)$/i.test(v) : !shellReply(); store.set("qcShellReply", on); say(t(on ? "qc.shellreply.on" : "qc.shellreply.off"), "info"); },
+    "privacy-settings": () => toPanel("rules.title"),
+    help: () => { quick.set("/"); quick.update(); },
+    status: () => showText(t("qc.status.title"), [
+      `${t("qc.status.folder")}: ${folder || "—"}`,
+      `${t("qc.status.model")}: ${(chosenModel() || {}).label || "—"}`,
+      `${t("qc.status.mode")}: ${t(`pj.mode.${$("mode").value}`)}`,
+      `${t("qc.status.agent")}: ${session ? `${session.title || t("ide.agent.untitled")} · ${t(`pj.status.${session.status}`)}` : "—"}`,
+      session ? t("pj.used", { steps: session.used.steps, minutes: session.used.minutes, credits: Math.round(session.used.credits * 100) / 100 }) : "",
+    ].filter(Boolean).join("\n")),
+    usage: () => toPanel("credits.title"),
+    doctor: () => toPanel("setup.title"),
+    "release-notes": () => toPanel("update.title"),
+    version: () => toPanel("update.title"),
+    bug: () => api("/api/open", { url: "https://bitpull.cloud/help" }).catch(() => window.open("https://bitpull.cloud/help")),
+    feedback: () => api("/api/open", { url: "https://bitpull.cloud/help" }).catch(() => window.open("https://bitpull.cloud/help")),
+    login: () => toPanel("credits.title"),
+    logout: () => toPanel("credits.title"),
+    plans: () => toPanel("credits.title"),
+    topup: () => toPanel("credits.title"),
+    phone: () => toPanel("remote.title"),
+    lend: () => toPanel("lend.title"),
+    pause: () => toPanel("lend.title"),
+    network: () => toPanel("mynet.title"),
+    groups: () => toPanel("team.title"),
+    models: () => toPanel("models.title"),
+    terminal: () => showTerminal(),
+    chat: () => { location.href = `${PHONE ? "/remote/" : "/"}#token=${encodeURIComponent(token)}&lang=${encodeURIComponent(lang)}&view=chat`; },
+  };
+
+  quickReady.then((Q) => {
+    if (!Q) return;
+    const registry = Q.createRegistry();
+    Q.builtins(registry, H);
+    quick = Q.attach($("prompt"), {
+      t,
+      surface: "projects",
+      scope: () => folder,
+      registry,
+      busy: agentBusy,
+      say,
+      send: async (text) => {
+        if (!(await ensureAgent())) { $("prompt").value = text; return; }
+        try { renderAgent(await api("/api/projects/send", { id: session.id, text })); } catch (err) { $("prompt").value = text; output(explain(err)); say(explain(err), "warn"); }
+      },
+      shell: async (command) => {
+        if (!(await ensureAgent())) return;
+        // The command runs while the page follows its output: the answer of this request comes at the end.
+        api("/api/projects/shell", { id: session.id, command, reply: shellReply() }).then(renderAgent, (err) => say(explain(err), "warn"));
+        setTimeout(() => api("/api/projects/state", { id: session.id, after: cursor }).then(renderAgent, () => {}), 300);
+      },
+      loadSkills: async () => (await api("/api/quick/commands", { folder })).skills,
+      runSkill: async (name, args) => {
+        try {
+          let r = await api("/api/quick/expand", { folder, name, args, session: session && session.id });
+          // A command that came with the project runs commands: the person sees them and says yes once.
+          if (r.needsTrust) {
+            const ok = await modal(t("qc.trust.title", { name: `/${r.name}` }), [el("p", { text: t("qc.trust.text") }), el("pre", { class: "qc-pre", text: r.commands.join("\n") })], [{ label: t("pj.no"), ghost: true, value: false }, { label: t("qc.trust.yes"), value: true }]);
+            if (!ok) return;
+            await api("/api/quick/trust", { folder, name: r.name });
+            r = await api("/api/quick/expand", { folder, name, args, session: session && session.id });
+          }
+          await quick.sendNow(r.prompt);
+        } catch (err) {
+          // "skill_command_failed: npm test": the words, then which command.
+          const m = String(err.message || err), k = `pj.err.${m.split(":")[0]}`;
+          say(t(k) !== k ? `${t(k)}${m.includes(":") ? ` (${m.slice(m.indexOf(":") + 1).trim()})` : ""}` : explain(err), "warn");
+        }
+      },
+      interrupt: () => $("agent-stop").click(),
+      pickModel: () => H.model(""),
+      cycleMode,
+    });
+  });
+
   // The app works only while a page asks for news: this is also how it knows someone is watching.
   // Each request waits on the app until something happens, so a command's output shows while it is written.
   (async function follow() {
@@ -1380,7 +1612,8 @@
   document.addEventListener("keydown", (e) => {
     const mod = isMac ? e.metaKey : e.ctrlKey;
     const inEditor = e.target && e.target.closest && e.target.closest(".monaco-editor");
-    if (e.key === "Tab" && e.shiftKey && !inEditor && !mentionItems.length) { e.preventDefault(); cycleMode(); return; }
+    const inPrompt = quick && e.target === $("prompt");
+    if (e.key === "Tab" && e.shiftKey && !inEditor && !inPrompt && !mentionItems.length) { e.preventDefault(); cycleMode(); return; }
     if (e.ctrlKey && e.key === "`") { e.preventDefault(); showTerminal(); return; }
     if (!mod) return;
     const k = e.key.toLowerCase();
@@ -1392,7 +1625,7 @@
     else if (k === "b" && !e.shiftKey) { e.preventDefault(); toggle("sideOpen"); }
     else if (k === "j") { e.preventDefault(); if (layoutState.panelOpen && currentBottom() === "terminal") { layoutState.panelOpen = false; layout(); if (terminal) terminal.close(); } else showTerminal(); }
     else if (k === "l") { e.preventDefault(); newAgent(); }
-    else if (k === "s" && !inEditor) { e.preventDefault(); saveActive(); }
+    else if (k === "s" && !inEditor && !(inPrompt && !isMac)) { e.preventDefault(); saveActive(); }
     else if (k === "\\") { e.preventDefault(); if (active) toggleSplit(); }
   }, true);
   addEventListener("beforeunload", (e) => { if (tabs.some(isDirty)) { e.preventDefault(); e.returnValue = ""; } });
@@ -1404,6 +1637,7 @@
     if (PHONE) phoneSetup();
     $("ide").hidden = false;
     $("back").addEventListener("click", () => { location.href = `${PHONE ? "/remote/" : "/"}#token=${encodeURIComponent(token)}&lang=${encodeURIComponent(lang)}`; });
+    $("nofolder-panel").addEventListener("click", () => { location.href = `${PHONE ? "/remote/" : "/"}#token=${encodeURIComponent(token)}&lang=${encodeURIComponent(lang)}&view=panel`; });
     for (const b of document.querySelectorAll("#activity button[data-side]")) b.classList.toggle("on", b.dataset.side === layoutState.sideView && layoutState.sideOpen);
     for (const p of document.querySelectorAll("#side > section")) p.hidden = p.dataset.panel !== layoutState.sideView;
     layout();