yourskills 0.1.2 → 0.1.3

package/dist/main.js

@@ -49,7 +49,13 @@ async function resolveAgents(flagAgents) {
   return config.agents ?? [];
 }
 // src/settings/keys.ts
-var CONFIG_KEYS = ["scope", "agents", "server", "track"];
+var CONFIG_KEYS = [
+  "scope",
+  "agents",
+  "server",
+  "track",
+  "autoUpdate"
+];
 function isConfigKey(key) {
   return CONFIG_KEYS.includes(key);
 }
@@ -65,6 +71,8 @@ function configValue(config, key) {
       return config.serverUrl ?? UNSET;
     case "track":
       return config.track === undefined ? UNSET : String(config.track);
+    case "autoUpdate":
+      return String(config.autoUpdate !== false);
   }
 }
 function setConfigValue(config, key, value) {
@@ -125,6 +133,17 @@ function setConfigValue(config, key, value) {
       const track = value === "true";
       return { ok: true, config: { ...config, track }, shown: String(track) };
     }
+    case "autoUpdate": {
+      if (value !== "true" && value !== "false") {
+        return { ok: false, message: "autoUpdate must be `true` or `false`." };
+      }
+      const autoUpdate = value === "true";
+      return {
+        ok: true,
+        config: { ...config, autoUpdate },
+        shown: String(autoUpdate)
+      };
+    }
   }
 }
 function configLines(config) {
@@ -367,17 +386,25 @@ async function requireToken(server) {
 async function hasSession() {
   return Boolean((await readConfig()).token);
 }
+async function localAccount(server) {
+  const config = await readConfig();
+  return {
+    signedIn: Boolean(config.token),
+    email: config.userEmail ?? null,
+    server: serverUrl(config, server)
+  };
+}
 // src/auth/screens/gate.tsx
-import { Box as Box5, Text as Text7, useApp as useApp2, useInput } from "ink";
+import { Box as Box6, Text as Text8, useApp as useApp2, useInput as useInput3 } from "ink";
 import {
   useCallback,
   useEffect as useEffect3,
   useMemo,
-  useState as useState3
+  useState as useState4
 } from "react";
 
-// src/ui/command.tsx
-import { Box as Box2, Text as Text3 } from "ink";
+// src/ui/back.tsx
+import { useInput } from "ink";
 
 // ../../packages/ui/src/lib/ascii.ts
 var DEFAULT_ASCII_CHARS = {
@@ -502,23 +529,157 @@ function clip(text, width) {
   return width <= 1 ? text.slice(0, width) : `${text.slice(0, width - 1)}~`;
 }
 
+// ../../packages/skills/src/lifecycle.ts
+var LIFECYCLES = [
+  { status: "active", word: "active", glyph: "#", tone: "state-active" },
+  {
+    status: "experimental",
+    word: "experimental",
+    glyph: "?",
+    tone: "state-experimental"
+  },
+  {
+    status: "deprecated",
+    word: "deprecated",
+    glyph: "x",
+    tone: "state-deprecated"
+  }
+];
+var LIFECYCLE_ORDER = LIFECYCLES.map((lifecycle) => lifecycle.status);
+var BY_STATUS = new Map(LIFECYCLES.map((lifecycle) => [lifecycle.status, lifecycle]));
+function lifecycleOf(status) {
+  const lifecycle = BY_STATUS.get(status);
+  if (!lifecycle) {
+    throw new Error(`No lifecycle vocabulary for "${status}". Add it to LIFECYCLES.`);
+  }
+  return lifecycle;
+}
+// src/ui/rows.tsx
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsx as jsx2, jsxs as jsxs2, Fragment } from "react/jsx-runtime";
+function lifecycleTag(status) {
+  if (!status || status === "active")
+    return "";
+  return `[${lifecycleOf(status).word}]`;
+}
+function lifecycleColor(status) {
+  return stateTone[lifecycleOf(status ?? "active").tone];
+}
+var GUTTER = 4;
+var GAP = 2;
+function nameWidth(rows, max = 28) {
+  return Math.min(max, Math.max(8, ...rows.map((r) => r.name.length)));
+}
+function SkillRow({
+  row,
+  width,
+  names,
+  cursor,
+  selected,
+  selectable = false
+}) {
+  const tag = lifecycleTag(row.status);
+  const meta = row.count !== undefined ? `${row.count} skills` : tag;
+  const gutter = selectable ? GUTTER : 0;
+  const rest = width - gutter - names - GAP - (meta ? meta.length + GAP : 0);
+  return /* @__PURE__ */ jsxs2(Box2, {
+    children: [
+      selectable ? /* @__PURE__ */ jsx2(Text2, {
+        color: cursor ? "cyan" : undefined,
+        children: `${cursor ? mark.cursor : " "} ${selected ? mark.selected : mark.unselected} `
+      }) : null,
+      /* @__PURE__ */ jsx2(Text2, {
+        bold: cursor,
+        color: lifecycleColor(row.status),
+        children: clip(row.name, names).padEnd(names)
+      }),
+      /* @__PURE__ */ jsx2(Text2, {
+        children: " ".repeat(GAP)
+      }),
+      /* @__PURE__ */ jsx2(Text2, {
+        dimColor: true,
+        children: clip(row.description ?? "", Math.max(rest, 0))
+      }),
+      meta ? /* @__PURE__ */ jsxs2(Fragment, {
+        children: [
+          /* @__PURE__ */ jsx2(Text2, {
+            children: " ".repeat(GAP)
+          }),
+          /* @__PURE__ */ jsx2(Text2, {
+            color: lifecycleColor(row.status),
+            dimColor: !tag,
+            children: meta
+          })
+        ]
+      }) : null
+    ]
+  });
+}
+function Hints({ hints }) {
+  return /* @__PURE__ */ jsx2(Box2, {
+    children: hints.map(([key, label], i) => /* @__PURE__ */ jsxs2(Text2, {
+      children: [
+        i > 0 ? /* @__PURE__ */ jsx2(Text2, {
+          dimColor: true,
+          children: "   "
+        }) : null,
+        /* @__PURE__ */ jsx2(Text2, {
+          color: "cyan",
+          children: key
+        }),
+        /* @__PURE__ */ jsx2(Text2, {
+          dimColor: true,
+          children: ` ${label}`
+        })
+      ]
+    }, key))
+  });
+}
+
+// src/ui/back.tsx
+import { jsx as jsx3, jsxs as jsxs3, Fragment as Fragment2 } from "react/jsx-runtime";
+function Back({
+  width,
+  onBack,
+  extra = []
+}) {
+  useInput((input, key) => {
+    if (key.escape || input === "x")
+      onBack?.();
+  }, { isActive: Boolean(onBack) });
+  if (!onBack)
+    return null;
+  return /* @__PURE__ */ jsxs3(Fragment2, {
+    children: [
+      /* @__PURE__ */ jsx3(Divider, {
+        width
+      }),
+      /* @__PURE__ */ jsx3(Hints, {
+        hints: [...extra, ["esc/x", "back"]]
+      })
+    ]
+  });
+}
+// src/ui/command.tsx
+import { Box as Box3, Text as Text4 } from "ink";
+
 // src/ui/text-input.tsx
-import { Text as Text2 } from "ink";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Text as Text3 } from "ink";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function SearchInput({
   value,
   placeholder = "",
   focus = true
 }) {
-  return /* @__PURE__ */ jsxs2(Text2, {
+  return /* @__PURE__ */ jsxs4(Text3, {
     children: [
-      value.length > 0 ? /* @__PURE__ */ jsx2(Text2, {
+      value.length > 0 ? /* @__PURE__ */ jsx4(Text3, {
         children: value
-      }) : /* @__PURE__ */ jsx2(Text2, {
+      }) : /* @__PURE__ */ jsx4(Text3, {
         dimColor: true,
         children: placeholder
       }),
-      focus ? /* @__PURE__ */ jsx2(Text2, {
+      focus ? /* @__PURE__ */ jsx4(Text3, {
         color: tone.primary,
         children: "_"
       }) : null
@@ -527,7 +688,7 @@ function SearchInput({
 }
 
 // src/ui/command.tsx
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function filterCommands(groups, query) {
   if (query.length === 0)
     return groups;
@@ -541,28 +702,28 @@ function flattenCommands(groups) {
   return groups.flatMap((group) => group.items);
 }
 var POINTER = 2;
-var GAP = 2;
+var GAP2 = 2;
 function CommandRow({
   item,
   width,
   active
 }) {
   const hint = item.hint ?? "";
-  const room = width - POINTER - (hint ? hint.length + GAP : 0);
+  const room = width - POINTER - (hint ? hint.length + GAP2 : 0);
   const label = clip(item.label, Math.max(room, 0));
   const gap = Math.max(width - POINTER - label.length - hint.length, hint ? 1 : 0);
-  return /* @__PURE__ */ jsxs3(Text3, {
+  return /* @__PURE__ */ jsxs5(Text4, {
     children: [
-      /* @__PURE__ */ jsx3(Text3, {
+      /* @__PURE__ */ jsx5(Text4, {
         color: tone.primary,
         children: `${active ? mark.cursor : " "} `
       }),
-      /* @__PURE__ */ jsx3(Text3, {
+      /* @__PURE__ */ jsx5(Text4, {
         bold: active,
         color: active ? tone.primary : undefined,
         children: label
       }),
-      /* @__PURE__ */ jsx3(Text3, {
+      /* @__PURE__ */ jsx5(Text4, {
         dimColor: true,
         children: `${" ".repeat(gap)}${hint}`
       })
@@ -581,38 +742,38 @@ function CommandPalette({
   const rows = flattenCommands(visible);
   const current = rows[cursor];
   const interior = width - FRAME_CHROME;
-  return /* @__PURE__ */ jsxs3(Box2, {
+  return /* @__PURE__ */ jsxs5(Box3, {
     flexDirection: "column",
     children: [
-      /* @__PURE__ */ jsxs3(Box2, {
+      /* @__PURE__ */ jsxs5(Box3, {
         children: [
-          /* @__PURE__ */ jsx3(Text3, {
+          /* @__PURE__ */ jsx5(Text4, {
             color: tone.primary,
             children: "> "
           }),
-          /* @__PURE__ */ jsx3(SearchInput, {
+          /* @__PURE__ */ jsx5(SearchInput, {
             value: query,
             placeholder
           })
         ]
       }),
-      /* @__PURE__ */ jsx3(Divider, {
+      /* @__PURE__ */ jsx5(Divider, {
         width
       }),
-      rows.length === 0 ? /* @__PURE__ */ jsx3(Text3, {
+      rows.length === 0 ? /* @__PURE__ */ jsx5(Text4, {
         dimColor: true,
         children: emptyMessage
-      }) : visible.map((group, i) => /* @__PURE__ */ jsxs3(Box2, {
+      }) : visible.map((group, i) => /* @__PURE__ */ jsxs5(Box3, {
         flexDirection: "column",
         children: [
-          i > 0 ? /* @__PURE__ */ jsx3(Divider, {
+          i > 0 ? /* @__PURE__ */ jsx5(Divider, {
             width
           }) : null,
-          /* @__PURE__ */ jsx3(Text3, {
+          /* @__PURE__ */ jsx5(Text4, {
             dimColor: true,
             children: group.group.toUpperCase()
           }),
-          group.items.map((item) => /* @__PURE__ */ jsx3(CommandRow, {
+          group.items.map((item) => /* @__PURE__ */ jsx5(CommandRow, {
             item,
             width: interior,
             active: item.value === current?.value
@@ -622,143 +783,147 @@ function CommandPalette({
     ]
   });
 }
-// ../../packages/skills/src/lifecycle.ts
-var LIFECYCLES = [
-  { status: "active", word: "active", glyph: "#", tone: "state-active" },
-  {
-    status: "experimental",
-    word: "experimental",
-    glyph: "?",
-    tone: "state-experimental"
-  },
-  {
-    status: "deprecated",
-    word: "deprecated",
-    glyph: "x",
-    tone: "state-deprecated"
-  }
-];
-var LIFECYCLE_ORDER = LIFECYCLES.map((lifecycle) => lifecycle.status);
-var BY_STATUS = new Map(LIFECYCLES.map((lifecycle) => [lifecycle.status, lifecycle]));
-function lifecycleOf(status) {
-  const lifecycle = BY_STATUS.get(status);
-  if (!lifecycle) {
-    throw new Error(`No lifecycle vocabulary for "${status}". Add it to LIFECYCLES.`);
-  }
-  return lifecycle;
-}
-// src/ui/rows.tsx
-import { Box as Box3, Text as Text4 } from "ink";
-import { jsx as jsx4, jsxs as jsxs4, Fragment } from "react/jsx-runtime";
-function lifecycleTag(status) {
-  if (!status || status === "active")
-    return "";
-  return `[${lifecycleOf(status).word}]`;
-}
-function lifecycleColor(status) {
-  return stateTone[lifecycleOf(status ?? "active").tone];
-}
-var GUTTER = 4;
-var GAP2 = 2;
-function nameWidth(rows, max = 28) {
-  return Math.min(max, Math.max(8, ...rows.map((r) => r.name.length)));
-}
-function SkillRow({
-  row,
-  width,
-  names,
-  cursor,
-  selected,
-  selectable = false
+// src/ui/confirm.tsx
+import { Box as Box4, Text as Text5, useInput as useInput2 } from "ink";
+import { useState } from "react";
+import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+function ConfirmScreen({
+  title,
+  headline,
+  lines,
+  notes = [],
+  yes,
+  no,
+  argv,
+  onYes,
+  onNo
 }) {
-  const tag = lifecycleTag(row.status);
-  const meta = row.count !== undefined ? `${row.count} skills` : tag;
-  const gutter = selectable ? GUTTER : 0;
-  const rest = width - gutter - names - GAP2 - (meta ? meta.length + GAP2 : 0);
-  return /* @__PURE__ */ jsxs4(Box3, {
-    children: [
-      selectable ? /* @__PURE__ */ jsx4(Text4, {
-        color: cursor ? "cyan" : undefined,
-        children: `${cursor ? mark.cursor : " "} ${selected ? mark.selected : mark.unselected} `
-      }) : null,
-      /* @__PURE__ */ jsx4(Text4, {
-        bold: cursor,
-        color: lifecycleColor(row.status),
-        children: clip(row.name, names).padEnd(names)
-      }),
-      /* @__PURE__ */ jsx4(Text4, {
-        children: " ".repeat(GAP2)
-      }),
-      /* @__PURE__ */ jsx4(Text4, {
-        dimColor: true,
-        children: clip(row.description ?? "", Math.max(rest, 0))
-      }),
-      meta ? /* @__PURE__ */ jsxs4(Fragment, {
-        children: [
-          /* @__PURE__ */ jsx4(Text4, {
-            children: " ".repeat(GAP2)
-          }),
-          /* @__PURE__ */ jsx4(Text4, {
-            color: lifecycleColor(row.status),
-            dimColor: !tag,
-            children: meta
-          })
-        ]
-      }) : null
-    ]
+  const width = useFrameWidth();
+  const [choice, setChoice] = useState("yes");
+  useInput2((input, key) => {
+    if (key.upArrow || key.downArrow) {
+      setChoice((c) => c === "yes" ? "no" : "yes");
+    } else if (key.return) {
+      if (choice === "yes")
+        onYes();
+      else
+        onNo();
+    } else if (key.escape || input === "x") {
+      onNo();
+    }
   });
-}
-function Hints({ hints }) {
-  return /* @__PURE__ */ jsx4(Box3, {
-    children: hints.map(([key, label], i) => /* @__PURE__ */ jsxs4(Text4, {
+  const interior = width - FRAME_CHROME;
+  const row = (label, active, hint) => {
+    const room = interior - 2 - (hint ? hint.length + 2 : 0);
+    const text = clip(label, Math.max(room, 0));
+    const gap = Math.max(interior - 2 - text.length - (hint?.length ?? 0), 1);
+    return /* @__PURE__ */ jsxs6(Text5, {
       children: [
-        i > 0 ? /* @__PURE__ */ jsx4(Text4, {
-          dimColor: true,
-          children: "   "
-        }) : null,
-        /* @__PURE__ */ jsx4(Text4, {
-          color: "cyan",
-          children: key
+        /* @__PURE__ */ jsx6(Text5, {
+          color: tone.primary,
+          children: `${active ? mark.cursor : " "} `
+        }),
+        /* @__PURE__ */ jsx6(Text5, {
+          bold: active,
+          color: active ? tone.primary : undefined,
+          children: text
         }),
-        /* @__PURE__ */ jsx4(Text4, {
+        hint ? /* @__PURE__ */ jsx6(Text5, {
           dimColor: true,
-          children: ` ${label}`
-        })
+          children: `${" ".repeat(gap)}${hint}`
+        }) : null
       ]
-    }, key))
+    });
+  };
+  return /* @__PURE__ */ jsxs6(Frame, {
+    title,
+    width,
+    children: [
+      /* @__PURE__ */ jsxs6(Box4, {
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsx6(Text5, {
+            color: tone.notice,
+            children: clip(headline, interior)
+          }),
+          /* @__PURE__ */ jsx6(Text5, {
+            children: " "
+          }),
+          lines.map((line) => /* @__PURE__ */ jsxs6(Text5, {
+            children: [
+              /* @__PURE__ */ jsx6(Text5, {
+                color: line.mark === "fail" ? tone.danger : undefined,
+                children: line.mark === "none" ? "  " : `${MARK[line.mark]} `
+              }),
+              /* @__PURE__ */ jsx6(Text5, {
+                children: clip(line.text, interior - 2)
+              }),
+              line.note ? /* @__PURE__ */ jsx6(Text5, {
+                dimColor: true,
+                children: clip(`  ${line.note}`, Math.max(interior - 2 - line.text.length, 0))
+              }) : null
+            ]
+          }, `${line.mark}:${line.text}`)),
+          notes.length > 0 ? /* @__PURE__ */ jsx6(Text5, {
+            children: " "
+          }) : null,
+          notes.map((note) => /* @__PURE__ */ jsx6(Text5, {
+            dimColor: true,
+            children: clip(note, interior)
+          }, note)),
+          /* @__PURE__ */ jsx6(Text5, {
+            children: " "
+          }),
+          row(yes, choice === "yes", argv),
+          row(no, choice === "no")
+        ]
+      }),
+      /* @__PURE__ */ jsx6(Divider, {
+        width
+      }),
+      /* @__PURE__ */ jsx6(Hints, {
+        hints: [
+          ["^v", "choose"],
+          ["enter", choice === "yes" ? yes : no],
+          ["esc", no]
+        ]
+      })
+    ]
   });
 }
+var MARK = { ok: mark.ok, fail: mark.fail, pending: mark.pending };
 // src/ui/spinner.tsx
-import { Text as Text5 } from "ink";
-import { useEffect, useState } from "react";
-import { jsx as jsx5 } from "react/jsx-runtime";
+import { Text as Text6 } from "ink";
+import { useEffect, useState as useState2 } from "react";
+import { jsx as jsx7 } from "react/jsx-runtime";
 var FRAMES = ["-", "\\", "|", "/"];
 var INTERVAL_MS = 90;
 function Spinner() {
-  const [frame, setFrame] = useState(0);
+  const [frame, setFrame] = useState2(0);
   useEffect(() => {
     const timer = setInterval(() => setFrame((f) => (f + 1) % FRAMES.length), INTERVAL_MS);
     return () => clearInterval(timer);
   }, []);
-  return /* @__PURE__ */ jsx5(Text5, {
+  return /* @__PURE__ */ jsx7(Text6, {
     color: tone.primary,
     children: FRAMES[frame]
   });
 }
 // src/auth/screens/login.tsx
-import { Box as Box4, Text as Text6, useApp } from "ink";
-import { useEffect as useEffect2, useState as useState2 } from "react";
-import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Box as Box5, Text as Text7, useApp } from "ink";
+import { useEffect as useEffect2, useState as useState3 } from "react";
+import { jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function minutesLeft(expiresAt) {
   return Math.max(0, Math.ceil((expiresAt - Date.now()) / 60000));
 }
 function LoginScreen({
   onError,
-  onDone
+  onDone,
+  onBack
 }) {
   const { exit } = useApp();
   const width = useFrameWidth();
-  const [state, setState] = useState2({ phase: "starting" });
+  const [state, setState] = useState3({ phase: "starting" });
   useEffect2(() => {
     let live = true;
     (async () => {
@@ -789,16 +954,16 @@ function LoginScreen({
     };
   }, [exit, onError, onDone]);
   if (state.phase === "done") {
-    return /* @__PURE__ */ jsx6(Frame, {
+    return /* @__PURE__ */ jsx8(Frame, {
       title: "login",
       width,
-      children: /* @__PURE__ */ jsxs5(Text6, {
+      children: /* @__PURE__ */ jsxs7(Text7, {
         children: [
-          /* @__PURE__ */ jsx6(Text6, {
+          /* @__PURE__ */ jsx8(Text7, {
             color: "green",
             children: mark.ok
           }),
-          /* @__PURE__ */ jsx6(Text6, {
+          /* @__PURE__ */ jsx8(Text7, {
             children: ` Logged in${state.email ? ` as ${state.email}` : ""}.`
           })
         ]
@@ -806,66 +971,78 @@ function LoginScreen({
     });
   }
   if (state.phase === "starting") {
-    return /* @__PURE__ */ jsx6(Frame, {
+    return /* @__PURE__ */ jsxs7(Frame, {
       title: "login",
       width,
-      children: /* @__PURE__ */ jsxs5(Text6, {
-        children: [
-          /* @__PURE__ */ jsx6(Spinner, {}),
-          /* @__PURE__ */ jsx6(Text6, {
-            dimColor: true,
-            children: " Requesting a device code..."
-          })
-        ]
-      })
+      children: [
+        /* @__PURE__ */ jsxs7(Text7, {
+          children: [
+            /* @__PURE__ */ jsx8(Spinner, {}),
+            /* @__PURE__ */ jsx8(Text7, {
+              dimColor: true,
+              children: " Requesting a device code..."
+            })
+          ]
+        }),
+        /* @__PURE__ */ jsx8(Back, {
+          width,
+          onBack
+        })
+      ]
     });
   }
   const { prompt } = state;
-  return /* @__PURE__ */ jsx6(Frame, {
+  return /* @__PURE__ */ jsxs7(Frame, {
     title: "login",
     width,
-    children: /* @__PURE__ */ jsxs5(Box4, {
-      flexDirection: "column",
-      children: [
-        /* @__PURE__ */ jsx6(Text6, {
-          dimColor: true,
-          children: "Open this URL in your browser:"
-        }),
-        /* @__PURE__ */ jsx6(Text6, {
-          color: tone.primary,
-          children: prompt.verificationUri
-        }),
-        /* @__PURE__ */ jsx6(Box4, {
-          height: 1
-        }),
-        /* @__PURE__ */ jsx6(Text6, {
-          dimColor: true,
-          children: "and enter the code:"
-        }),
-        /* @__PURE__ */ jsx6(Text6, {
-          bold: true,
-          color: tone.notice,
-          children: prompt.userCode
-        }),
-        /* @__PURE__ */ jsx6(Box4, {
-          height: 1
-        }),
-        /* @__PURE__ */ jsxs5(Text6, {
-          children: [
-            /* @__PURE__ */ jsx6(Spinner, {}),
-            /* @__PURE__ */ jsx6(Text6, {
-              dimColor: true,
-              children: ` Waiting for approval — expires in ${minutesLeft(prompt.expiresAt)} min`
-            })
-          ]
-        })
-      ]
-    })
+    children: [
+      /* @__PURE__ */ jsxs7(Box5, {
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsx8(Text7, {
+            dimColor: true,
+            children: "Open this URL in your browser:"
+          }),
+          /* @__PURE__ */ jsx8(Text7, {
+            color: tone.primary,
+            children: prompt.verificationUri
+          }),
+          /* @__PURE__ */ jsx8(Box5, {
+            height: 1
+          }),
+          /* @__PURE__ */ jsx8(Text7, {
+            dimColor: true,
+            children: "and enter the code:"
+          }),
+          /* @__PURE__ */ jsx8(Text7, {
+            bold: true,
+            color: tone.notice,
+            children: prompt.userCode
+          }),
+          /* @__PURE__ */ jsx8(Box5, {
+            height: 1
+          }),
+          /* @__PURE__ */ jsxs7(Text7, {
+            children: [
+              /* @__PURE__ */ jsx8(Spinner, {}),
+              /* @__PURE__ */ jsx8(Text7, {
+                dimColor: true,
+                children: ` Waiting for approval — expires in ${minutesLeft(prompt.expiresAt)} min`
+              })
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsx8(Back, {
+        width,
+        onBack
+      })
+    ]
   });
 }
 
 // src/auth/screens/gate.tsx
-import { jsx as jsx7, jsxs as jsxs6, Fragment as Fragment2 } from "react/jsx-runtime";
+import { jsx as jsx9, jsxs as jsxs8, Fragment as Fragment3 } from "react/jsx-runtime";
 function AuthGate({
   title,
   build,
@@ -875,7 +1052,7 @@ function AuthGate({
 }) {
   const { exit } = useApp2();
   const width = useFrameWidth();
-  const [phase, setPhase] = useState3({ kind: "checking" });
+  const [phase, setPhase] = useState4({ kind: "checking" });
   const open = useCallback(() => {
     connect().then((client) => {
       process.exitCode = 0;
@@ -899,7 +1076,7 @@ function AuthGate({
       live = false;
     };
   }, [check, open, onError]);
-  useInput((input, key) => {
+  useInput3((input, key) => {
     if (input === "l")
       setPhase({ kind: "logging-in" });
     if (input === "q" || key.escape)
@@ -907,67 +1084,67 @@ function AuthGate({
   }, { isActive: phase.kind === "blocked" });
   const child = useMemo(() => phase.kind === "ready" ? build(phase.client) : null, [phase, build]);
   if (phase.kind === "ready")
-    return /* @__PURE__ */ jsx7(Fragment2, {
+    return /* @__PURE__ */ jsx9(Fragment3, {
       children: child
     });
   if (phase.kind === "logging-in")
-    return /* @__PURE__ */ jsx7(LoginScreen, {
+    return /* @__PURE__ */ jsx9(LoginScreen, {
       onError,
       onDone: open
     });
   if (phase.kind === "checking")
-    return /* @__PURE__ */ jsx7(Frame, {
+    return /* @__PURE__ */ jsx9(Frame, {
       title,
       width,
-      children: /* @__PURE__ */ jsxs6(Text7, {
+      children: /* @__PURE__ */ jsxs8(Text8, {
         children: [
-          /* @__PURE__ */ jsx7(Spinner, {}),
-          /* @__PURE__ */ jsx7(Text7, {
+          /* @__PURE__ */ jsx9(Spinner, {}),
+          /* @__PURE__ */ jsx9(Text8, {
             dimColor: true,
             children: " Checking session..."
           })
         ]
       })
     });
-  return /* @__PURE__ */ jsx7(Frame, {
+  return /* @__PURE__ */ jsx9(Frame, {
     title,
     width,
-    children: /* @__PURE__ */ jsxs6(Box5, {
+    children: /* @__PURE__ */ jsxs8(Box6, {
       flexDirection: "column",
       children: [
-        /* @__PURE__ */ jsxs6(Text7, {
+        /* @__PURE__ */ jsxs8(Text8, {
           children: [
-            /* @__PURE__ */ jsx7(Text7, {
+            /* @__PURE__ */ jsx9(Text8, {
               color: tone.notice,
               children: mark.fail
             }),
-            /* @__PURE__ */ jsx7(Text7, {
+            /* @__PURE__ */ jsx9(Text8, {
               children: ` Not signed in — ${title} needs a session.`
             })
           ]
         }),
-        /* @__PURE__ */ jsx7(Blank, {}),
-        /* @__PURE__ */ jsxs6(Text7, {
+        /* @__PURE__ */ jsx9(Blank, {}),
+        /* @__PURE__ */ jsxs8(Text8, {
           dimColor: true,
           children: [
             "press ",
-            /* @__PURE__ */ jsx7(Text7, {
+            /* @__PURE__ */ jsx9(Text8, {
               color: tone.primary,
               children: "l"
             }),
             " to log in, ",
-            /* @__PURE__ */ jsx7(Text7, {
+            /* @__PURE__ */ jsx9(Text8, {
               color: tone.primary,
               children: "q"
             }),
             " to quit"
           ]
         }),
-        /* @__PURE__ */ jsxs6(Text7, {
+        /* @__PURE__ */ jsxs8(Text8, {
           dimColor: true,
           children: [
             "or run ",
-            /* @__PURE__ */ jsx7(Text7, {
+            /* @__PURE__ */ jsx9(Text8, {
               color: tone.primary,
               children: "yourskills login"
             }),
@@ -979,8 +1156,8 @@ function AuthGate({
   });
 }
 // src/catalog/screens/browser.tsx
-import { Box as Box7, Text as Text9, useApp as useApp4, useInput as useInput2, useWindowSize as useWindowSize2 } from "ink";
-import { useCallback as useCallback2, useEffect as useEffect5, useMemo as useMemo2, useState as useState5 } from "react";
+import { Box as Box8, Text as Text10, useApp as useApp4, useInput as useInput4, useWindowSize as useWindowSize2 } from "ink";
+import { useCallback as useCallback2, useEffect as useEffect5, useMemo as useMemo2, useState as useState6 } from "react";
 
 // src/install/install.ts
 import { spawn } from "node:child_process";
@@ -1193,6 +1370,57 @@ async function* installResolution(entries, opts, bundle) {
     yield* installTargets(entry.locations, opts, bundle);
   }
 }
+
+// src/install/update.ts
+function update(client, bundle, opts = {}) {
+  return installBundle(client, bundle, opts);
+}
+function updateScope(bundles, loose) {
+  return [
+    bundles > 0 ? `${bundles} ${bundles === 1 ? "bundle" : "bundles"}` : "",
+    loose > 0 ? `${loose} loose ${loose === 1 ? "skill" : "skills"}` : ""
+  ].filter(Boolean).join(" and ");
+}
+function looseSkills(manifest) {
+  return Object.values(manifest.skills).filter((entry) => !entry.bundle).map((entry) => entry.name);
+}
+async function* updateTracked(client, manifest, opts = {}, all = false) {
+  for (const bundle of Object.keys(manifest.bundles)) {
+    yield* installBundle(client, bundle, opts);
+  }
+  const loose = all ? looseSkills(manifest) : [];
+  if (loose.length > 0)
+    yield* install(client, loose, opts);
+}
+
+// src/install/empty.ts
+function nothingTracked(nearest, kind, all = false) {
+  const has = kind === "install" ? Object.keys(nearest.manifest.skills).length > 0 : Object.keys(nearest.manifest.bundles).length > 0 || all && looseSkills(nearest.manifest).length > 0;
+  if (has)
+    return null;
+  return {
+    title: kind,
+    lines: [
+      {
+        mark: "none",
+        text: kind === "install" ? "Nothing recorded to install yet." : "No bundles tracked here yet.",
+        note: nearest.path
+      }
+    ],
+    json: { manifest: nearest.path, skills: [], bundles: [] },
+    next: { command: "yourskills browse", why: "pick something to install" }
+  };
+}
+// src/install/options.ts
+async function resolveInstallOptions(opts) {
+  const { scope, manifestPath } = await resolveScope({ flag: opts.scope });
+  const path = scope === "project" && manifestPath ? manifestPath : manifestPathFor(scope);
+  return {
+    scope,
+    agents: await resolveAgents(opts.agents),
+    manifest: { path, scope }
+  };
+}
 // src/install/reinstall.ts
 function targetOf(entry) {
   return {
@@ -1255,9 +1483,9 @@ async function removeSkills(names, manifest, manifestPath, opts = {}) {
   };
 }
 // src/install/screens/installer.tsx
-import { Box as Box6, Text as Text8, useApp as useApp3 } from "ink";
-import { useEffect as useEffect4, useState as useState4 } from "react";
-import { jsx as jsx8, jsxs as jsxs7, Fragment as Fragment3 } from "react/jsx-runtime";
+import { Box as Box7, Text as Text9, useApp as useApp3 } from "ink";
+import { useEffect as useEffect4, useState as useState5 } from "react";
+import { jsx as jsx10, jsxs as jsxs9, Fragment as Fragment4 } from "react/jsx-runtime";
 function where(location) {
   return `${location.source}/${location.path}@${location.ref.slice(0, 8)}`;
 }
@@ -1306,76 +1534,76 @@ function InstallLine({ line, width }) {
   const name = clip(line.name, names).padEnd(names);
   switch (line.state) {
     case "resolving":
-      return /* @__PURE__ */ jsxs7(Text8, {
+      return /* @__PURE__ */ jsxs9(Text9, {
         children: [
-          /* @__PURE__ */ jsx8(Spinner, {}),
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Spinner, {}),
+          /* @__PURE__ */ jsx10(Text9, {
             children: ` ${name}`
           }),
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Text9, {
             dimColor: true,
             children: "resolving..."
           })
         ]
       });
     case "installing":
-      return /* @__PURE__ */ jsxs7(Text8, {
+      return /* @__PURE__ */ jsxs9(Text9, {
         children: [
-          /* @__PURE__ */ jsx8(Spinner, {}),
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Spinner, {}),
+          /* @__PURE__ */ jsx10(Text9, {
             children: ` ${name}`
           }),
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Text9, {
             dimColor: true,
             children: clip(line.where, width - names - 3)
           })
         ]
       });
     case "installed":
-      return /* @__PURE__ */ jsxs7(Text8, {
+      return /* @__PURE__ */ jsxs9(Text9, {
         children: [
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Text9, {
             color: "green",
             children: mark.ok
           }),
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Text9, {
             children: ` ${name}`
           }),
-          /* @__PURE__ */ jsx8(Text8, {
+          /* @__PURE__ */ jsx10(Text9, {
             dimColor: true,
             children: clip(line.where, width - names - 3)
           }),
-          line.deprecated ? /* @__PURE__ */ jsx8(Text8, {
+          line.deprecated ? /* @__PURE__ */ jsx10(Text9, {
             color: lifecycleColor("deprecated"),
             children: `  ${lifecycleTag("deprecated")}`
           }) : null
         ]
       });
     case "pending":
-      return /* @__PURE__ */ jsxs7(Box6, {
+      return /* @__PURE__ */ jsxs9(Box7, {
         flexDirection: "column",
         children: [
-          /* @__PURE__ */ jsxs7(Text8, {
+          /* @__PURE__ */ jsxs9(Text9, {
             children: [
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 color: tone.notice,
                 children: mark.pending
               }),
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 children: ` ${name}`
               }),
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 color: tone.notice,
                 children: "not in your registry yet"
               })
             ]
           }),
-          line.vendor.prUrl ? /* @__PURE__ */ jsxs7(Text8, {
+          line.vendor.prUrl ? /* @__PURE__ */ jsxs9(Text9, {
             children: [
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 children: "    "
               }),
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 color: tone.primary,
                 children: line.vendor.prUrl
               })
@@ -1384,26 +1612,26 @@ function InstallLine({ line, width }) {
         ]
       });
     case "failed":
-      return /* @__PURE__ */ jsxs7(Box6, {
+      return /* @__PURE__ */ jsxs9(Box7, {
         flexDirection: "column",
         children: [
-          /* @__PURE__ */ jsxs7(Text8, {
+          /* @__PURE__ */ jsxs9(Text9, {
             children: [
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 color: tone.danger,
                 children: mark.fail
               }),
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 children: ` ${name}`
               }),
-              /* @__PURE__ */ jsx8(Text8, {
+              /* @__PURE__ */ jsx10(Text9, {
                 color: tone.danger,
                 children: clip(line.message, width - names - 3)
               })
             ]
           }),
           line.detail ? line.detail.split(`
-`).slice(-3).map((d) => /* @__PURE__ */ jsx8(Text8, {
+`).slice(-3).map((d) => /* @__PURE__ */ jsx10(Text9, {
             dimColor: true,
             children: clip(`    ${d}`, width)
           }, d)) : null
@@ -1415,13 +1643,15 @@ function Installer({
   title,
   stream,
   onDone,
-  exitWhenDone = true
+  exitWhenDone = true,
+  onBack,
+  plan
 }) {
   const { exit } = useApp3();
   const width = useFrameWidth();
-  const [lines, setLines] = useState4([]);
-  const [error, setError] = useState4(null);
-  const [done, setDone] = useState4(false);
+  const [lines, setLines] = useState5([]);
+  const [error, setError] = useState5(null);
+  const [done, setDone] = useState5(false);
   useEffect4(() => {
     let live = true;
     (async () => {
@@ -1452,51 +1682,86 @@ function Installer({
     };
   }, [stream, onDone, exit, exitWhenDone]);
   const pending = lines.filter((l) => l.state === "pending");
-  return /* @__PURE__ */ jsx8(Frame, {
+  const installed = lines.filter((l) => l.state === "installed").length;
+  const failed = lines.filter((l) => l.state === "failed").length;
+  return /* @__PURE__ */ jsxs9(Frame, {
     title,
     width,
-    children: /* @__PURE__ */ jsxs7(Box6, {
-      flexDirection: "column",
-      children: [
-        lines.length === 0 && !error ? /* @__PURE__ */ jsxs7(Text8, {
-          children: [
-            /* @__PURE__ */ jsx8(Spinner, {}),
-            /* @__PURE__ */ jsx8(Text8, {
-              dimColor: true,
-              children: " Resolving..."
-            })
-          ]
-        }) : null,
-        lines.map((line) => /* @__PURE__ */ jsx8(InstallLine, {
-          line,
-          width: width - 2
-        }, line.name)),
-        error ? /* @__PURE__ */ jsx8(Text8, {
-          color: tone.danger,
-          children: `${mark.fail} ${error}`
-        }) : null,
-        done && pending.length > 0 ? /* @__PURE__ */ jsxs7(Fragment3, {
-          children: [
-            /* @__PURE__ */ jsx8(Divider, {
-              width
-            }),
-            /* @__PURE__ */ jsx8(Text8, {
-              color: tone.notice,
-              children: pending.length === 1 ? "1 skill is waiting on a pull request." : `${pending.length} skills are waiting on a pull request.`
-            }),
-            /* @__PURE__ */ jsx8(Text8, {
-              dimColor: true,
-              children: "Merge it, then run this command again."
-            })
-          ]
-        }) : null
-      ]
-    })
+    children: [
+      /* @__PURE__ */ jsxs9(Box7, {
+        flexDirection: "column",
+        children: [
+          plan ? /* @__PURE__ */ jsx10(Text9, {
+            dimColor: true,
+            children: clip(plan, width - 4)
+          }) : null,
+          lines.length === 0 && !error ? /* @__PURE__ */ jsxs9(Text9, {
+            children: [
+              /* @__PURE__ */ jsx10(Spinner, {}),
+              /* @__PURE__ */ jsx10(Text9, {
+                dimColor: true,
+                children: " Resolving..."
+              })
+            ]
+          }) : null,
+          lines.map((line) => /* @__PURE__ */ jsx10(InstallLine, {
+            line,
+            width: width - 2
+          }, line.name)),
+          error ? /* @__PURE__ */ jsx10(Text9, {
+            color: tone.danger,
+            children: `${mark.fail} ${error}`
+          }) : null,
+          done && lines.length > 0 ? /* @__PURE__ */ jsxs9(Fragment4, {
+            children: [
+              /* @__PURE__ */ jsx10(Divider, {
+                width
+              }),
+              /* @__PURE__ */ jsxs9(Text9, {
+                children: [
+                  /* @__PURE__ */ jsx10(Text9, {
+                    color: "green",
+                    children: `${installed} installed`
+                  }),
+                  /* @__PURE__ */ jsx10(Text9, {
+                    color: pending.length > 0 ? tone.notice : undefined,
+                    dimColor: pending.length === 0,
+                    children: `   ${pending.length} pending`
+                  }),
+                  /* @__PURE__ */ jsx10(Text9, {
+                    color: failed > 0 ? tone.danger : undefined,
+                    dimColor: failed === 0,
+                    children: `   ${failed} failed`
+                  })
+                ]
+              })
+            ]
+          }) : null,
+          done && pending.length > 0 ? /* @__PURE__ */ jsxs9(Fragment4, {
+            children: [
+              /* @__PURE__ */ jsx10(Text9, {
+                color: tone.notice,
+                children: pending.length === 1 ? "1 skill is waiting on a pull request." : `${pending.length} skills are waiting on a pull request.`
+              }),
+              /* @__PURE__ */ jsx10(Text9, {
+                dimColor: true,
+                children: "Merge it, then run this command again."
+              })
+            ]
+          }) : null
+        ]
+      }),
+      done || error !== null ? /* @__PURE__ */ jsx10(Back, {
+        width,
+        onBack
+      }) : null
+    ]
   });
 }
 async function installPlain(stream) {
   const pending = [];
   let failed = 0;
+  let installed = 0;
   for await (const event of stream) {
     switch (event.kind) {
       case "resolving":
@@ -1508,6 +1773,7 @@ async function installPlain(stream) {
         console.log(`${event.location.skillName}  ${where(event.location)}`);
         break;
       case "installed":
+        installed += 1;
         break;
       case "pending":
         console.log(pendingMessage(event.vendor));
@@ -1521,25 +1787,13 @@ async function installPlain(stream) {
         break;
     }
   }
-  return { pending, failed };
-}
-// src/install/update.ts
-function update(client, bundle, opts = {}) {
-  return installBundle(client, bundle, opts);
-}
-function looseSkills(manifest) {
-  return Object.values(manifest.skills).filter((entry) => !entry.bundle).map((entry) => entry.name);
-}
-async function* updateTracked(client, manifest, opts = {}, all = false) {
-  for (const bundle of Object.keys(manifest.bundles)) {
-    yield* installBundle(client, bundle, opts);
+  if (pending.length > 0 || failed > 0) {
+    console.log(`${installed} installed, ${pending.length} pending, ${failed} failed`);
   }
-  const loose = all ? looseSkills(manifest) : [];
-  if (loose.length > 0)
-    yield* install(client, loose, opts);
+  return { pending, failed };
 }
 // src/catalog/screens/browser.tsx
-import { jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
+import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
 var TABS = ["bundles", "skills"];
 function pageSize(rows) {
   return Math.max(3, Math.min(20, rows - 11));
@@ -1551,18 +1805,18 @@ function matches(row, query) {
   return row.name.toLowerCase().includes(q) || (row.description ?? "").toLowerCase().includes(q);
 }
 function TabBar({ active }) {
-  return /* @__PURE__ */ jsx9(Box7, {
-    children: TABS.map((tab, i) => /* @__PURE__ */ jsxs8(Text9, {
+  return /* @__PURE__ */ jsx11(Box8, {
+    children: TABS.map((tab, i) => /* @__PURE__ */ jsxs10(Text10, {
       children: [
-        i > 0 ? /* @__PURE__ */ jsx9(Text9, {
+        i > 0 ? /* @__PURE__ */ jsx11(Text10, {
           dimColor: true,
           children: "  "
         }) : null,
-        tab === active ? /* @__PURE__ */ jsx9(Text9, {
+        tab === active ? /* @__PURE__ */ jsx11(Text10, {
           bold: true,
           color: tone.primary,
           children: `[${tab}]`
-        }) : /* @__PURE__ */ jsx9(Text9, {
+        }) : /* @__PURE__ */ jsx11(Text10, {
           dimColor: true,
           children: ` ${tab} `
         })
@@ -1575,20 +1829,22 @@ function BrowserScreen({
   opts,
   onError,
   onSummary,
-  onExit
+  onExit,
+  initialTab = "bundles",
+  initialQuery = ""
 }) {
   const { exit } = useApp4();
   const width = useFrameWidth();
   const { rows: terminalRows } = useWindowSize2();
-  const [catalog, setCatalog] = useState5(null);
-  const [tab, setTab] = useState5("bundles");
-  const [query, setQuery] = useState5("");
-  const [cursor, setCursor] = useState5(0);
-  const [picked, setPicked] = useState5({
+  const [catalog, setCatalog] = useState6(null);
+  const [tab, setTab] = useState6(initialTab);
+  const [query, setQuery] = useState6(initialQuery);
+  const [cursor, setCursor] = useState6(0);
+  const [picked, setPicked] = useState6({
     bundles: new Set,
     skills: new Set
   });
-  const [running, setRunning] = useState5(null);
+  const [running, setRunning] = useState6(null);
   useEffect5(() => {
     let live = true;
     Promise.all([client.skills.list.query({}), client.bundles.list.query()]).then(([skills, bundles]) => {
@@ -1631,7 +1887,7 @@ function BrowserScreen({
       names: names2
     });
   }, [selected, visible, cursor, tab]);
-  useInput2((input, key) => {
+  useInput4((input, key) => {
     if (key.upArrow) {
       setCursor((c) => Math.max(0, c - 1));
     } else if (key.downArrow) {
@@ -1675,7 +1931,7 @@ function BrowserScreen({
   if (running) {
     const names2 = running.names;
     const stream = tab === "bundles" ? () => installBundle(client, names2[0], opts) : () => install(client, names2, opts);
-    return /* @__PURE__ */ jsx9(Installer, {
+    return /* @__PURE__ */ jsx11(Installer, {
       title: running.title,
       stream,
       exitWhenDone: true,
@@ -1683,13 +1939,13 @@ function BrowserScreen({
     });
   }
   if (!catalog) {
-    return /* @__PURE__ */ jsx9(Frame, {
+    return /* @__PURE__ */ jsx11(Frame, {
       title: "yourskills",
       width,
-      children: /* @__PURE__ */ jsxs8(Text9, {
+      children: /* @__PURE__ */ jsxs10(Text10, {
         children: [
-          /* @__PURE__ */ jsx9(Spinner, {}),
-          /* @__PURE__ */ jsx9(Text9, {
+          /* @__PURE__ */ jsx11(Spinner, {}),
+          /* @__PURE__ */ jsx11(Text10, {
             dimColor: true,
             children: " Loading your registry..."
           })
@@ -1701,37 +1957,37 @@ function BrowserScreen({
   const first = Math.max(0, Math.min(cursor - Math.floor(size / 2), visible.length - size));
   const page = visible.slice(Math.max(0, first), Math.max(0, first) + size);
   const names = nameWidth(visible.length > 0 ? visible : catalog[tab]);
-  return /* @__PURE__ */ jsx9(Frame, {
+  return /* @__PURE__ */ jsx11(Frame, {
     title: "yourskills",
     width,
-    children: /* @__PURE__ */ jsxs8(Box7, {
+    children: /* @__PURE__ */ jsxs10(Box8, {
       flexDirection: "column",
       children: [
-        /* @__PURE__ */ jsx9(TabBar, {
+        /* @__PURE__ */ jsx11(TabBar, {
           active: tab
         }),
-        /* @__PURE__ */ jsx9(Divider, {
+        /* @__PURE__ */ jsx11(Divider, {
           width
         }),
-        /* @__PURE__ */ jsxs8(Box7, {
+        /* @__PURE__ */ jsxs10(Box8, {
           children: [
-            /* @__PURE__ */ jsx9(Text9, {
+            /* @__PURE__ */ jsx11(Text10, {
               color: tone.primary,
               children: "search> "
             }),
-            /* @__PURE__ */ jsx9(SearchInput, {
+            /* @__PURE__ */ jsx11(SearchInput, {
               value: query,
               placeholder: "type to filter"
             })
           ]
         }),
-        /* @__PURE__ */ jsx9(Divider, {
+        /* @__PURE__ */ jsx11(Divider, {
           width
         }),
-        page.length === 0 ? /* @__PURE__ */ jsx9(Text9, {
+        page.length === 0 ? /* @__PURE__ */ jsx11(Text10, {
           dimColor: true,
           children: `No ${tab} match "${query}".`
-        }) : page.map((row, i) => /* @__PURE__ */ jsx9(SkillRow, {
+        }) : page.map((row, i) => /* @__PURE__ */ jsx11(SkillRow, {
           row,
           width: width - 2,
           names,
@@ -1739,23 +1995,23 @@ function BrowserScreen({
           cursor: Math.max(0, first) + i === cursor,
           selected: selected.has(row.name)
         }, row.name)),
-        /* @__PURE__ */ jsx9(Divider, {
+        /* @__PURE__ */ jsx11(Divider, {
           width
         }),
-        /* @__PURE__ */ jsxs8(Box7, {
+        /* @__PURE__ */ jsxs10(Box8, {
           children: [
-            /* @__PURE__ */ jsx9(Text9, {
+            /* @__PURE__ */ jsx11(Text10, {
               dimColor: true,
               children: `${visible.length > 0 ? cursor + 1 : 0}/${visible.length}`
             }),
-            selected.size > 0 ? /* @__PURE__ */ jsx9(Text9, {
+            selected.size > 0 ? /* @__PURE__ */ jsx11(Text10, {
               color: tone.notice,
               children: `  ${selected.size} selected`
             }) : null,
-            /* @__PURE__ */ jsx9(Text9, {
+            /* @__PURE__ */ jsx11(Text10, {
               children: "   "
             }),
-            /* @__PURE__ */ jsx9(Hints, {
+            /* @__PURE__ */ jsx11(Hints, {
               hints: [
                 ["^v", "move"],
                 ["space", "select"],
@@ -1771,9 +2027,9 @@ function BrowserScreen({
   });
 }
 // src/catalog/screens/catalog.tsx
-import { Box as Box8, Text as Text10, useApp as useApp5 } from "ink";
-import { useEffect as useEffect6, useState as useState6 } from "react";
-import { jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
+import { Box as Box9, Text as Text11, useApp as useApp5 } from "ink";
+import { useEffect as useEffect6, useState as useState7 } from "react";
+import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 function CatalogScreen({
   title,
   load,
@@ -1781,7 +2037,7 @@ function CatalogScreen({
 }) {
   const { exit } = useApp5();
   const width = useFrameWidth();
-  const [rows, setRows] = useState6(null);
+  const [rows, setRows] = useState7(null);
   useEffect6(() => {
     let live = true;
     load().then((result) => {
@@ -1798,13 +2054,13 @@ function CatalogScreen({
     };
   }, [load, exit, onError]);
   if (rows === null) {
-    return /* @__PURE__ */ jsx10(Frame, {
+    return /* @__PURE__ */ jsx12(Frame, {
       title,
       width,
-      children: /* @__PURE__ */ jsxs9(Text10, {
+      children: /* @__PURE__ */ jsxs11(Text11, {
         children: [
-          /* @__PURE__ */ jsx10(Spinner, {}),
-          /* @__PURE__ */ jsx10(Text10, {
+          /* @__PURE__ */ jsx12(Spinner, {}),
+          /* @__PURE__ */ jsx12(Text11, {
             dimColor: true,
             children: " Loading..."
           })
@@ -1813,22 +2069,22 @@ function CatalogScreen({
     });
   }
   if (rows.length === 0) {
-    return /* @__PURE__ */ jsx10(Frame, {
+    return /* @__PURE__ */ jsx12(Frame, {
       title,
       width,
-      children: /* @__PURE__ */ jsx10(Text10, {
+      children: /* @__PURE__ */ jsx12(Text11, {
         dimColor: true,
         children: "No skills found."
       })
     });
   }
   const names = nameWidth(rows);
-  return /* @__PURE__ */ jsx10(Frame, {
+  return /* @__PURE__ */ jsx12(Frame, {
     title,
     width,
-    children: /* @__PURE__ */ jsx10(Box8, {
+    children: /* @__PURE__ */ jsx12(Box9, {
       flexDirection: "column",
-      children: rows.map((row) => /* @__PURE__ */ jsx10(SkillRow, {
+      children: rows.map((row) => /* @__PURE__ */ jsx12(SkillRow, {
         row,
         width: width - 2,
         names
@@ -2007,6 +2263,75 @@ async function doctorReport(nearest, server) {
     failed: checks.some((check) => !check.ok)
   };
 }
+// src/errors.ts
+function isUnauthorized(error) {
+  if (!(error instanceof Error))
+    return false;
+  const data = error.data;
+  if (data?.code === "UNAUTHORIZED" || data?.httpStatus === 401)
+    return true;
+  return error.message.startsWith("Not logged in") || error.message.startsWith("Session is no longer valid");
+}
+
+class CliError extends Error {
+  why;
+  next;
+  code;
+  constructor(what, detail = {}) {
+    super(what);
+    this.name = "CliError";
+    this.why = detail.why;
+    this.next = detail.next;
+    this.code = detail.code ?? EXIT.failed;
+  }
+}
+var EXIT = {
+  ok: 0,
+  failed: 1,
+  usage: 2,
+  session: 3
+};
+var EXIT_CODES = [
+  [EXIT.ok, "done"],
+  [
+    EXIT.failed,
+    "something did not land: a failed install, a pending pull request"
+  ],
+  [EXIT.usage, "the command line was wrong; the last line says the spelling"],
+  [EXIT.session, "needs a session: run `yourskills login`"]
+];
+var LOGIN = "yourskills login";
+function describeError(error) {
+  if (error instanceof CliError) {
+    return {
+      lines: shape(error.message, error.why, error.next),
+      code: error.code
+    };
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  if (isUnauthorized(error)) {
+    return {
+      lines: shape("you are not signed in", message.startsWith("Session") ? "the registry no longer accepts the token on this machine" : "the catalog needs a session, and there is no token on this machine", LOGIN),
+      code: EXIT.session
+    };
+  }
+  if (/fetch failed|ECONNREFUSED|ENOTFOUND|timed? ?out/i.test(message)) {
+    return {
+      lines: shape("could not reach the registry", message, "check your connection, then run the same command again"),
+      code: EXIT.failed
+    };
+  }
+  return { lines: shape(message), code: EXIT.failed };
+}
+function shape(what, why, next) {
+  const lines = [what];
+  if (why)
+    lines.push(`  ${why}`);
+  if (next)
+    lines.push(`  ${next}`);
+  return lines;
+}
+
 // src/hooks/adapters.ts
 import { homedir as homedir3 } from "node:os";
 import { join as join6 } from "node:path";
@@ -2023,7 +2348,8 @@ var UPDATE_CHECK_ENTRY = {
   kind: "update-check",
   event: "SessionStart",
   matcher: "startup|resume",
-  command: `${BINARY} hook session-start`
+  command: `${BINARY} hook session-start`,
+  timeout: 120
 };
 var USAGE_ENTRY = {
   kind: "usage",
@@ -2061,57 +2387,294 @@ function agentForEvent(kind, event) {
   const owner = HOOK_ADAPTERS.find((adapter) => adapter.entries.some((entry) => entry.kind === kind && entry.event === event));
   return owner?.agent ?? "unknown";
 }
-// src/hooks/ensure.ts
-import { existsSync as existsSync3 } from "node:fs";
-
-// src/usage/queue.ts
-import { mkdirSync as mkdirSync3 } from "node:fs";
-import { appendFile, readFile as readFile3, rm, stat, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+// ../../packages/bundles/src/drift.ts
+var SHORT_SHA = 7;
+function namesSameCommit(prefix, full) {
+  const short = prefix.trim().toLowerCase();
+  const long = full.trim().toLowerCase();
+  if (short === long)
+    return true;
+  return short.length >= SHORT_SHA && long.startsWith(short);
+}
 
-// ../../node_modules/.bun/@trpc+client@11.18.0+acc6907a906fa511/node_modules/@trpc/client/dist/objectSpread2-BvkFp-_Y.mjs
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function")
-    for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key;i < n; i++) {
-      key = keys[i];
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, {
-          get: ((k) => from[k]).bind(null, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
+// src/installed/installed.ts
+var shortRef = (ref) => ref.slice(0, SHORT_SHA);
+function installedRows(nearest) {
+  return Object.values(nearest.manifest.skills).map((entry) => ({
+    name: entry.name,
+    ref: entry.ref,
+    bundle: entry.bundle ?? null,
+    scope: nearest.manifest.scope
+  })).sort((a, b) => a.name.localeCompare(b.name));
+}
+function columns(rows) {
+  const names = Math.max(...rows.map((r) => r.name.length));
+  const bundles = Math.max(...rows.map((r) => (r.bundle ?? "-").length));
+  return rows.map((row) => ({
+    mark: "none",
+    text: `${row.name.padEnd(names)}  ${shortRef(row.ref)}`,
+    note: `${(row.bundle ?? "-").padEnd(bundles)}  ${row.scope}`
+  }));
+}
+function installedReport(nearest) {
+  const rows = installedRows(nearest);
+  const lines = rows.length === 0 ? [
+    {
+      mark: "none",
+      text: "Nothing installed. Run `yourskills bundle <name>` or `yourskills add <skill>`.",
+      note: nearest.path
     }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-  value: mod,
-  enumerable: true
-}) : target, mod));
-var require_typeof = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.72.2/node_modules/@oxc-project/runtime/src/helpers/typeof.js"(exports, module) {
-  function _typeof$2(o) {
-    "@babel/helpers - typeof";
-    return module.exports = _typeof$2 = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(o$1) {
-      return typeof o$1;
-    } : function(o$1) {
-      return o$1 && typeof Symbol == "function" && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
-    }, module.exports.__esModule = true, module.exports["default"] = module.exports, _typeof$2(o);
-  }
-  module.exports = _typeof$2, module.exports.__esModule = true, module.exports["default"] = module.exports;
-} });
-var require_toPrimitive = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.72.2/node_modules/@oxc-project/runtime/src/helpers/toPrimitive.js"(exports, module) {
-  var _typeof$1 = require_typeof()["default"];
-  function toPrimitive$1(t, r) {
-    if (_typeof$1(t) != "object" || !t)
-      return t;
-    var e = t[Symbol.toPrimitive];
+  ] : columns(rows);
+  return {
+    title: "installed",
+    lines,
+    json: {
+      manifest: nearest.path,
+      scope: nearest.manifest.scope,
+      skills: rows
+    },
+    ...rows.length === 0 ? {
+      next: {
+        command: "yourskills browse",
+        why: "pick something to install"
+      }
+    } : {}
+  };
+}
+// src/installed/outdated.ts
+function hasMoved(installed, available) {
+  return !(namesSameCommit(available, installed) || namesSameCommit(installed, available));
+}
+function drift(manifest, pins, catalog) {
+  const byExternalId = new Map(catalog.map((row) => [row.externalId, row]));
+  const byName = new Map(catalog.map((row) => [row.name, row]));
+  const moved = [];
+  const unknown = [];
+  for (const entry of Object.values(manifest.skills)) {
+    const row = byExternalId.get(entry.externalId) ?? byName.get(entry.name);
+    if (!row) {
+      unknown.push(entry.name);
+      continue;
+    }
+    const pin = entry.bundle ? pins.find((p) => p.bundle === entry.bundle && p.skillId === row.id) : undefined;
+    const available = pin?.pinnedSha ?? row.currentSha;
+    if (!hasMoved(entry.ref, available))
+      continue;
+    moved.push({
+      name: entry.name,
+      bundle: entry.bundle ?? null,
+      installed: entry.ref,
+      available,
+      deprecated: pin?.deprecated ?? row.status === "deprecated"
+    });
+  }
+  moved.sort((a, b) => a.name.localeCompare(b.name));
+  return { moved, unknown };
+}
+async function driftNow(client, nearest) {
+  const [pins, catalog] = await Promise.all([
+    client.bundles.pins.query(),
+    client.skills.list.query({})
+  ]);
+  return drift(nearest.manifest, pins, catalog);
+}
+async function outdatedReport(client, nearest, quiet = false) {
+  let report;
+  try {
+    report = await driftNow(client, nearest);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      title: "outdated",
+      lines: [
+        { mark: "fail", text: "Could not reach the registry.", note: message }
+      ],
+      json: { manifest: nearest.path, error: message },
+      silent: quiet
+    };
+  }
+  const lines = report.moved.map((row) => ({
+    mark: "pending",
+    text: `${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}`,
+    note: [row.bundle ?? "-", row.deprecated ? "[deprecated]" : ""].filter(Boolean).join("  ")
+  }));
+  for (const name of report.unknown) {
+    lines.push({
+      mark: "fail",
+      text: name,
+      note: "no longer in your registry"
+    });
+  }
+  const current = report.moved.length === 0 && report.unknown.length === 0;
+  if (current && !quiet) {
+    lines.push({
+      mark: "ok",
+      text: "Everything is at the ref your registry pins."
+    });
+  }
+  return {
+    title: "outdated",
+    lines,
+    json: {
+      manifest: nearest.path,
+      outdated: report.moved,
+      unknown: report.unknown
+    },
+    silent: quiet && current,
+    ...report.moved.length > 0 ? {
+      next: {
+        command: "yourskills update --all",
+        why: "install what moved"
+      }
+    } : {}
+  };
+}
+// src/hooks/emit.ts
+function describe(outcome) {
+  switch (outcome.kind) {
+    case "quiet":
+      return [];
+    case "signed-out":
+      return [
+        "yourskills: your sign-in has expired, so your skills are no longer kept up to date.",
+        "  run: yourskills login"
+      ];
+    case "behind": {
+      const lines = [
+        `yourskills: ${count(outcome.moved.length, "skill")} ${outcome.moved.length === 1 ? "has" : "have"} a newer version in your registry (autoUpdate is off)`
+      ];
+      for (const row of outcome.moved) {
+        lines.push(`  ${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}${row.deprecated ? "  [deprecated]" : ""}`);
+      }
+      lines.push("  run: yourskills update --all");
+      return lines;
+    }
+    case "updated": {
+      const { applied, failed } = outcome;
+      const lines = [
+        applied.length > 0 ? `yourskills: updated ${count(applied.length, "skill")} to what your registry pins; ${applied.length === 1 ? "it is" : "they are"} live in this session.` : `yourskills: could not update ${count(failed.length, "skill")}`
+      ];
+      for (const row of applied) {
+        lines.push(`  ${row.name}  ${row.from} -> ${row.to}`);
+      }
+      for (const row of failed) {
+        lines.push(`  ${row.name}  failed: ${row.message}`);
+      }
+      if (applied.length > 0)
+        lines.push(`  recorded in ${outcome.manifest}`);
+      if (failed.length > 0)
+        lines.push("  run: yourskills doctor");
+      return lines;
+    }
+  }
+}
+function describeForModel(outcome) {
+  switch (outcome.kind) {
+    case "quiet":
+      return [];
+    case "signed-out":
+      return [
+        "yourskills: the user's session with the skills registry has expired, so installed skills are no longer being updated. The user has been told to run `yourskills login`; it is their call."
+      ];
+    case "behind": {
+      const lines = [
+        `yourskills: ${count(outcome.moved.length, "installed skill")} ${outcome.moved.length === 1 ? "is" : "are"} behind the registry. Automatic updates are off; the user has been told and it is their call whether to run \`yourskills update --all\`.`
+      ];
+      for (const row of outcome.moved) {
+        lines.push(`  ${row.name}  installed ${shortRef(row.installed)}, registry pins ${shortRef(row.available)}${row.deprecated ? "  [deprecated]" : ""}`);
+      }
+      return lines;
+    }
+    case "updated": {
+      const { applied, failed } = outcome;
+      const lines = [];
+      if (applied.length > 0) {
+        lines.push(`yourskills updated ${count(applied.length, "installed skill")} on disk at the start of this session. The contents changed: re-read a skill before relying on what you remember of it.`);
+        for (const row of applied) {
+          lines.push(`  ${row.name}  ${row.from} -> ${row.to}`);
+        }
+        lines.push(`  recorded in ${outcome.manifest}`);
+      }
+      if (failed.length > 0) {
+        lines.push(`yourskills could not update ${count(failed.length, "installed skill")}; the version on disk is unchanged. The user has been told.`);
+        for (const row of failed) {
+          lines.push(`  ${row.name}  ${row.message}`);
+        }
+      }
+      return lines;
+    }
+  }
+}
+function count(n, noun) {
+  return `${n} ${noun}${n === 1 ? "" : "s"}`;
+}
+function emit(outcome) {
+  const lines = describe(outcome);
+  if (lines.length === 0)
+    return;
+  const installed = outcome.kind === "updated" && outcome.applied.length > 0;
+  console.log(JSON.stringify({
+    systemMessage: lines.join(`
+`),
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: describeForModel(outcome).join(`
+`),
+      ...installed ? { reloadSkills: true } : {}
+    }
+  }));
+}
+// src/hooks/ensure.ts
+import { existsSync as existsSync3 } from "node:fs";
+
+// src/usage/queue.ts
+import { mkdirSync as mkdirSync3 } from "node:fs";
+import { appendFile, readFile as readFile3, rm, stat, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join7 } from "node:path";
+
+// ../../node_modules/.bun/@trpc+client@11.18.0+acc6907a906fa511/node_modules/@trpc/client/dist/objectSpread2-BvkFp-_Y.mjs
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function")
+    for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key;i < n; i++) {
+      key = keys[i];
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, {
+          get: ((k) => from[k]).bind(null, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+    }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+  value: mod,
+  enumerable: true
+}) : target, mod));
+var require_typeof = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.72.2/node_modules/@oxc-project/runtime/src/helpers/typeof.js"(exports, module) {
+  function _typeof$2(o) {
+    "@babel/helpers - typeof";
+    return module.exports = _typeof$2 = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(o$1) {
+      return typeof o$1;
+    } : function(o$1) {
+      return o$1 && typeof Symbol == "function" && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+    }, module.exports.__esModule = true, module.exports["default"] = module.exports, _typeof$2(o);
+  }
+  module.exports = _typeof$2, module.exports.__esModule = true, module.exports["default"] = module.exports;
+} });
+var require_toPrimitive = __commonJS({ "../../node_modules/.pnpm/@oxc-project+runtime@0.72.2/node_modules/@oxc-project/runtime/src/helpers/toPrimitive.js"(exports, module) {
+  var _typeof$1 = require_typeof()["default"];
+  function toPrimitive$1(t, r) {
+    if (_typeof$1(t) != "object" || !t)
+      return t;
+    var e = t[Symbol.toPrimitive];
     if (e !== undefined) {
       var i = e.call(t, r || "default");
       if (_typeof$1(i) != "object")
@@ -2879,10 +3442,10 @@ function dataLoader(batchLoader) {
 }
 function allAbortSignals(...signals) {
   const ac = new AbortController;
-  const count = signals.length;
+  const count2 = signals.length;
   let abortedCount = 0;
   const onAbort = () => {
-    if (++abortedCount === count)
+    if (++abortedCount === count2)
       ac.abort();
   };
   for (const signal of signals)
@@ -3457,6 +4020,55 @@ var import_awaitAsyncGenerator = __toESM(require_awaitAsyncGenerator(), 1);
 var import_wrapAsyncGenerator = __toESM(require_wrapAsyncGenerator(), 1);
 var import_objectSpread29 = __toESM(require_objectSpread2(), 1);
 
+// src/errors.ts
+function isUnauthorized2(error) {
+  if (!(error instanceof Error))
+    return false;
+  const data = error.data;
+  if (data?.code === "UNAUTHORIZED" || data?.httpStatus === 401)
+    return true;
+  return error.message.startsWith("Not logged in") || error.message.startsWith("Session is no longer valid");
+}
+var EXIT2 = {
+  ok: 0,
+  failed: 1,
+  usage: 2,
+  session: 3
+};
+var EXIT_CODES2 = [
+  [EXIT2.ok, "done"],
+  [
+    EXIT2.failed,
+    "something did not land: a failed install, a pending pull request"
+  ],
+  [EXIT2.usage, "the command line was wrong; the last line says the spelling"],
+  [EXIT2.session, "needs a session: run `yourskills login`"]
+];
+function closest(word, candidates, maxDistance = 2) {
+  let best;
+  for (const candidate of candidates) {
+    const distance = edits(word.toLowerCase(), candidate.toLowerCase());
+    if (distance <= maxDistance && (!best || distance < best.distance)) {
+      best = { word: candidate, distance };
+    }
+  }
+  return best?.word;
+}
+function edits(a, b) {
+  const rows = a.length + 1;
+  const cols = b.length + 1;
+  let previous = Array.from({ length: cols }, (_, j2) => j2);
+  for (let i = 1;i < rows; i++) {
+    const current = [i];
+    for (let j2 = 1;j2 < cols; j2++) {
+      const cost = a[i - 1] === b[j2 - 1] ? 0 : 1;
+      current[j2] = Math.min(previous[j2] + 1, current[j2 - 1] + 1, previous[j2 - 1] + cost);
+    }
+    previous = current;
+  }
+  return previous[cols - 1];
+}
+
 // src/client.ts
 async function createClient(server) {
   const { token, base } = await requireToken(server);
@@ -3638,17 +4250,25 @@ function addHooks(settings, entries) {
     const hooks = { ...next.hooks ?? {} };
     const groups = [...hooks[entry.event] ?? []];
     const ours = groups.findIndex((group) => group.matcher === entry.matcher && groupIsOurs(group));
+    const ourCommand = {
+      type: "command",
+      command: entry.command,
+      ...entry.timeout === undefined ? {} : { timeout: entry.timeout }
+    };
     if (ours === -1) {
-      groups.push({
-        matcher: entry.matcher,
-        hooks: [{ type: "command", command: entry.command }]
-      });
+      groups.push({ matcher: entry.matcher, hooks: [ourCommand] });
     } else {
       const group = groups[ours];
       const commands = [...group.hooks ?? []];
-      if (commands.some((hook) => hook.command === entry.command))
-        continue;
-      commands.push({ type: "command", command: entry.command });
+      const at = commands.findIndex((hook) => hook.command === entry.command);
+      if (at === -1) {
+        commands.push(ourCommand);
+      } else {
+        const existing = commands[at];
+        if (existing.timeout === entry.timeout)
+          continue;
+        commands[at] = { ...existing, ...ourCommand };
+      }
       groups[ours] = { ...group, hooks: commands };
     }
     hooks[entry.event] = groups;
@@ -3755,17 +4375,16 @@ async function registerInto(adapter) {
   return { agent: adapter.agent, path, entries: wanted };
 }
 function linesFor(registered) {
+  const agents2 = registered.map((r) => r.agent).join(", ");
   const lines = [
-    "yourskills registered its update-check hook so your agent can tell you when an installed skill has moved:"
+    `+ yourskills will check your skills once a day, when ${agents2} starts, and update what moved`
   ];
-  for (const { agent, path, entries } of registered) {
-    for (const entry of entries) {
-      lines.push(`  ${agent}  ${entry.event}(${entry.matcher})  ${path}`);
-    }
+  for (const { agent, path } of registered) {
+    lines.push(`  ${agent}  ${path}`);
   }
-  lines.push("  undo any time with `yourskills hooks uninstall`");
+  lines.push("  undo with: yourskills hooks uninstall");
   if (!trackingDisabledByEnv()) {
-    lines.push("  usage counting stays off; `yourskills hooks install --track` turns it on");
+    lines.push("  usage counting stays off; turn it on with: yourskills hooks install --track");
   }
   return lines;
 }
@@ -3865,8 +4484,12 @@ async function installInto(adapter, optedIn) {
       result.installed.push(entry.kind);
   }
   const merged = addHooks(file.settings, wanted);
-  if (serialiseSettings(merged, file.indent) !== serialiseSettings(file.settings, file.indent)) {
+  const changed = serialiseSettings(merged, file.indent) !== serialiseSettings(file.settings, file.indent);
+  if (changed)
     await writeSettingsFile(path, merged, file.indent);
+  if (changed && result.already.length > 0) {
+    result.repaired = result.already;
+    result.already = [];
   }
   return result;
 }
@@ -3887,6 +4510,13 @@ function linesFor2(result) {
       note: result.path ?? ""
     });
   }
+  for (const kind of result.repaired ?? []) {
+    lines.push({
+      mark: "ok",
+      text: `${result.agent}  ${kind}`,
+      note: `updated  ${result.path ?? ""}`.trim()
+    });
+  }
   for (const kind of result.already) {
     lines.push({
       mark: "ok",
@@ -4048,141 +4678,116 @@ async function hooksStatus() {
     json: { track: optedIn, agents: agents2 }
   };
 }
-// ../../packages/bundles/src/drift.ts
-var SHORT_SHA = 7;
-function namesSameCommit(prefix, full) {
-  const short = prefix.trim().toLowerCase();
-  const long = full.trim().toLowerCase();
-  if (short === long)
+// src/hooks/session.ts
+var CHECK_BUDGET_MS = 5000;
+var UPDATE_BUDGET_MS = 90000;
+var DAY_MS = 86400000;
+function updateCheckDue(last, now = Date.now()) {
+  if (!last)
     return true;
-  return short.length >= SHORT_SHA && long.startsWith(short);
+  const at = Date.parse(last);
+  return Number.isNaN(at) || now - at >= DAY_MS;
 }
-
-// src/installed/installed.ts
-var shortRef = (ref) => ref.slice(0, SHORT_SHA);
-function installedRows(nearest) {
-  return Object.values(nearest.manifest.skills).map((entry) => ({
-    name: entry.name,
-    ref: entry.ref,
-    bundle: entry.bundle ?? null,
-    scope: nearest.manifest.scope
-  })).sort((a, b) => a.name.localeCompare(b.name));
+function withBudget(work, ms) {
+  return Promise.race([
+    work,
+    new Promise((resolve3) => {
+      const timer = setTimeout(() => resolve3(undefined), ms);
+      timer.unref?.();
+    })
+  ]);
 }
-function columns(rows) {
-  const names = Math.max(...rows.map((r) => r.name.length));
-  const bundles = Math.max(...rows.map((r) => (r.bundle ?? "-").length));
-  return rows.map((row) => ({
-    mark: "none",
-    text: `${row.name.padEnd(names)}  ${shortRef(row.ref)}`,
-    note: `${(row.bundle ?? "-").padEnd(bundles)}  ${row.scope}`
-  }));
+async function check(client, nearest) {
+  try {
+    const report = await driftNow(client, nearest);
+    return { ok: true, moved: report.moved };
+  } catch (error) {
+    return { ok: false, signedOut: isUnauthorized2(error) };
+  }
 }
-function installedReport(nearest) {
-  const rows = installedRows(nearest);
-  const lines = rows.length === 0 ? [
-    {
-      mark: "none",
-      text: "Nothing installed. Run `yourskills bundle <name>` or `yourskills add <skill>`.",
-      note: nearest.path
+async function applyUpdates(client, nearest, moved, deadline) {
+  const opts = { scope: nearest.scope };
+  const wanted = new Map(moved.map((row) => [row.name, row]));
+  const applied = [];
+  const failed = [];
+  const consume = async (label, stream) => {
+    try {
+      await drain(stream);
+    } catch (error) {
+      failed.push({
+        name: label,
+        message: error instanceof Error ? error.message : String(error)
+      });
     }
-  ] : columns(rows);
-  return {
-    title: "installed",
-    lines,
-    json: {
-      manifest: nearest.path,
-      scope: nearest.manifest.scope,
-      skills: rows
+  };
+  const drain = async (stream) => {
+    for await (const event of stream) {
+      if (event.kind === "installed") {
+        const row = wanted.get(event.location.skillName);
+        if (row) {
+          applied.push({
+            name: row.name,
+            from: shortRef(row.installed),
+            to: shortRef(row.available)
+          });
+        }
+      } else if (event.kind === "failed" && wanted.has(event.name)) {
+        failed.push({ name: event.name, message: event.message });
+      }
     }
   };
+  const bundles = [
+    ...new Set(moved.map((row) => row.bundle).filter((name) => !!name))
+  ].sort();
+  const loose = moved.filter((row) => !row.bundle).map((row) => row.name).sort();
+  for (const bundle of bundles) {
+    if (Date.now() > deadline)
+      break;
+    await consume(bundle, installBundle(client, bundle, opts));
+  }
+  if (loose.length > 0 && Date.now() <= deadline) {
+    await consume(loose.join(", "), install(client, loose, opts));
+  }
+  if (applied.length === 0 && failed.length === 0)
+    return { kind: "quiet" };
+  return { kind: "updated", applied, failed, manifest: nearest.path };
 }
-// src/installed/outdated.ts
-function hasMoved(installed, available) {
-  return !(namesSameCommit(available, installed) || namesSameCommit(installed, available));
-}
-function drift(manifest, pins, catalog) {
-  const byExternalId = new Map(catalog.map((row) => [row.externalId, row]));
-  const byName = new Map(catalog.map((row) => [row.name, row]));
-  const moved = [];
-  const unknown = [];
-  for (const entry of Object.values(manifest.skills)) {
-    const row = byExternalId.get(entry.externalId) ?? byName.get(entry.name);
-    if (!row) {
-      unknown.push(entry.name);
-      continue;
-    }
-    const pin = entry.bundle ? pins.find((p) => p.bundle === entry.bundle && p.skillId === row.id) : undefined;
-    const available = pin?.pinnedSha ?? row.currentSha;
-    if (!hasMoved(entry.ref, available))
-      continue;
-    moved.push({
-      name: entry.name,
-      bundle: entry.bundle ?? null,
-      installed: entry.ref,
-      available,
-      deprecated: pin?.deprecated ?? row.status === "deprecated"
-    });
+async function sessionStart(now = new Date) {
+  const config = await readConfig();
+  if (!updateCheckDue(config.lastUpdateCheck, now.getTime())) {
+    return { kind: "quiet" };
   }
-  moved.sort((a, b) => a.name.localeCompare(b.name));
-  return { moved, unknown };
-}
-async function outdatedReport(client, nearest, quiet = false) {
-  let pins;
-  let catalog;
+  await writeConfig({ ...config, lastUpdateCheck: now.toISOString() });
+  if (!config.token)
+    return { kind: "quiet" };
+  let client;
+  let nearest;
   try {
-    [pins, catalog] = await Promise.all([
-      client.bundles.pins.query(),
-      client.skills.list.query({})
-    ]);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      title: "outdated",
-      lines: [
-        { mark: "fail", text: "Could not reach the registry.", note: message }
-      ],
-      json: { manifest: nearest.path, error: message },
-      silent: quiet
-    };
-  }
-  const report = drift(nearest.manifest, pins, catalog);
-  const lines = report.moved.map((row) => ({
-    mark: "pending",
-    text: `${row.name}  ${shortRef(row.installed)} -> ${shortRef(row.available)}`,
-    note: [row.bundle ?? "-", row.deprecated ? "[deprecated]" : ""].filter(Boolean).join("  ")
-  }));
-  for (const name of report.unknown) {
-    lines.push({
-      mark: "fail",
-      text: name,
-      note: "no longer in your registry"
-    });
-  }
-  const current = report.moved.length === 0 && report.unknown.length === 0;
-  if (current && !quiet) {
-    lines.push({
-      mark: "ok",
-      text: "Everything is at the ref your registry pins."
-    });
-  }
-  return {
-    title: "outdated",
-    lines,
-    json: {
-      manifest: nearest.path,
-      outdated: report.moved,
-      unknown: report.unknown
-    },
-    silent: quiet && current
-  };
+    client = await createClient();
+    nearest = await nearestManifest();
+  } catch {
+    return { kind: "quiet" };
+  }
+  if (Object.keys(nearest.manifest.skills).length === 0)
+    return { kind: "quiet" };
+  const found = await withBudget(check(client, nearest), CHECK_BUDGET_MS);
+  if (!found)
+    return { kind: "quiet" };
+  if (!found.ok)
+    return found.signedOut ? { kind: "signed-out" } : { kind: "quiet" };
+  if (found.moved.length === 0)
+    return { kind: "quiet" };
+  if (config.autoUpdate === false) {
+    return { kind: "behind", moved: found.moved, manifest: nearest.path };
+  }
+  return applyUpdates(client, nearest, found.moved, Date.now() + UPDATE_BUDGET_MS);
 }
+
 // src/hooks/run.ts
 function isHookEventName(value) {
   return value === "session-start" || value === "post-tool-use";
 }
 var STDIN_BUDGET_MS = 2000;
-var SESSION_BUDGET_MS = 5000;
-var DAY_MS = 86400000;
 async function readStdin() {
   if (process.stdin.isTTY)
     return {};
@@ -4235,46 +4840,19 @@ async function queueInvocation(payload, now = new Date) {
   await appendEvent(event);
   return event;
 }
-function updateCheckDue(last, now = Date.now()) {
-  if (!last)
-    return true;
-  const at = Date.parse(last);
-  return Number.isNaN(at) || now - at >= DAY_MS;
-}
-async function sessionStart() {
-  await flushQuietly();
-  const config = await readConfig();
-  if (!updateCheckDue(config.lastUpdateCheck))
-    return;
-  await writeConfig({ ...config, lastUpdateCheck: new Date().toISOString() });
-  const client = await createClient();
-  const nearest = await nearestManifest();
-  const report = await outdatedReport(client, nearest, true);
-  if (!report.silent && report.lines.length > 0) {
-    const moved = report.json.outdated?.length ?? 0;
-    if (moved > 0) {
-      console.log(`yourskills: ${moved} skill(s) behind your registry — run \`yourskills update\``);
-    }
-  }
-}
 async function runHook(event) {
   try {
     const payload = await readStdin();
     if (event === "post-tool-use")
       await queueInvocation(payload);
     else
-      await withBudget(sessionStart(), SESSION_BUDGET_MS);
+      await runSessionStart();
   } catch {}
   process.exitCode = 0;
 }
-function withBudget(work, ms) {
-  return Promise.race([
-    work,
-    new Promise((resolve3) => {
-      const timer = setTimeout(() => resolve3(undefined), ms);
-      timer.unref?.();
-    })
-  ]);
+async function runSessionStart() {
+  await flushQuietly();
+  emit(await sessionStart());
 }
 // src/org/org.ts
 var authBase2 = (base) => `${base.replace(/\/$/, "")}/api/auth`;
@@ -4386,68 +4964,138 @@ async function orgSwitchReport(name, server) {
   };
 }
 // src/report.ts
+function nextLine(next) {
+  return `next  ${next.command}  ${next.why}`;
+}
 function plainLine(line2, glyph) {
   const head = line2.mark === "none" ? "" : `${glyph[line2.mark]} `;
   return `${head}${line2.text}${line2.note ? `  ${line2.note}` : ""}`;
 }
 // src/shell/commands.ts
-function paletteGroups() {
-  return [
-    {
-      group: "Catalog",
-      items: [
-        { value: "catalog.bundles", label: "browse bundles", hint: "browse" },
-        { value: "catalog.skills", label: "browse skills", hint: "list" },
-        { value: "catalog.search", label: "search", hint: "search <query>" }
-      ]
-    },
-    {
-      group: "Installed",
-      items: [
-        { value: "installed.list", label: "list installed", hint: "installed" },
-        {
-          value: "installed.update",
-          label: "update all",
-          hint: "update --all"
-        },
-        { value: "installed.outdated", label: "outdated", hint: "outdated" },
-        { value: "installed.remove", label: "remove", hint: "remove <skill>" }
-      ]
-    },
-    {
-      group: "Account",
-      items: [
-        { value: "account.login", label: "login", hint: "login" },
-        { value: "account.logout", label: "logout", hint: "logout" },
-        { value: "account.whoami", label: "whoami", hint: "whoami" },
-        { value: "account.org", label: "switch org", hint: "org <name>" }
-      ]
-    },
-    {
-      group: "Setup",
-      items: [
-        {
-          value: "setup.scope",
-          label: "scope",
-          hint: "config set scope project"
-        },
-        {
-          value: "setup.agents",
-          label: "agents",
-          hint: "config set agents <name>"
-        },
-        { value: "setup.doctor", label: "doctor", hint: "doctor" }
-      ]
+function count2(n, one, many = `${one}s`) {
+  return `${n} ${n === 1 ? one : many}`;
+}
+function describe2(value, facts) {
+  switch (value) {
+    case undefined:
+      return "";
+    case "catalog.bundles":
+      return "browse the bundles your registry publishes, and install one";
+    case "catalog.skills":
+      return "browse every skill in your registry, and install any of them";
+    case "catalog.search":
+      return "filter the same catalog by name and description";
+    case "installed.list":
+      return `show the ${count2(facts.skills, "skill")} recorded in ${facts.manifest}`;
+    case "installed.update": {
+      const scope = updateScope(facts.bundles, facts.loose);
+      if (scope === "")
+        return "nothing is tracked here to update";
+      return `re-install ${scope} at what the registry blesses today`;
     }
-  ];
+    case "installed.outdated":
+      return `check your ${count2(facts.skills, "installed skill")} against the registry — reads only, changes nothing`;
+    case "installed.remove":
+      return `pick which of the ${count2(facts.skills, "skill")} to delete from this machine; it asks before it does`;
+    case "account.login":
+      return "sign in with a code you enter in your browser";
+    case "account.logout":
+      return "forget the token on this machine and revoke it server-side";
+    case "account.whoami":
+      return "ask the server who this token belongs to";
+    case "account.org":
+      return "list the organizations you can switch this machine to";
+    case "setup.scope":
+      return `where installs land: ${facts.scope} right now`;
+    case "setup.agents":
+      return "which agents a skill is written for when it is installed";
+    case "setup.doctor":
+      return "check the stock CLI, the manifest and the session in one pass";
+  }
+}
+var CATALOG = [
+  { value: "catalog.bundles", label: "browse bundles", hint: "browse" },
+  { value: "catalog.skills", label: "browse skills", hint: "list" },
+  { value: "catalog.search", label: "search", hint: "search <query>" }
+];
+var INSTALLED = {
+  list: { value: "installed.list", label: "list installed", hint: "installed" },
+  update: {
+    value: "installed.update",
+    label: "update all",
+    hint: "update --all"
+  },
+  outdated: {
+    value: "installed.outdated",
+    label: "outdated",
+    hint: "outdated"
+  },
+  remove: {
+    value: "installed.remove",
+    label: "remove",
+    hint: "remove <skill>"
+  }
+};
+var ACCOUNT = {
+  login: { value: "account.login", label: "login", hint: "login" },
+  logout: { value: "account.logout", label: "logout", hint: "logout" },
+  whoami: { value: "account.whoami", label: "whoami", hint: "whoami" },
+  org: { value: "account.org", label: "switch org", hint: "org <name>" }
+};
+var SETUP = [
+  { value: "setup.scope", label: "scope", hint: "config set scope project" },
+  { value: "setup.agents", label: "agents", hint: "config set agents <name>" },
+  { value: "setup.doctor", label: "doctor", hint: "doctor" }
+];
+function paletteGroups(facts) {
+  const groups = [];
+  if (facts.signedIn)
+    groups.push({ group: "Catalog", items: CATALOG });
+  const installed = [];
+  if (facts.skills > 0) {
+    installed.push(INSTALLED.list);
+    if (facts.signedIn)
+      installed.push(INSTALLED.update, INSTALLED.outdated);
+    installed.push(INSTALLED.remove);
+  }
+  if (installed.length > 0)
+    groups.push({ group: "Installed", items: installed });
+  groups.push({
+    group: "Account",
+    items: facts.signedIn ? [ACCOUNT.logout, ACCOUNT.whoami, ACCOUNT.org] : [ACCOUNT.login]
+  });
+  groups.push({ group: "Setup", items: SETUP });
+  return groups;
+}
+// src/shell/facts.ts
+import { existsSync as existsSync5 } from "node:fs";
+async function paletteFacts(scope, server) {
+  const [account, nearest, config] = await Promise.all([
+    localAccount(server),
+    nearestManifest(scope),
+    readConfig()
+  ]);
+  const skills = Object.keys(nearest.manifest.skills).length;
+  return {
+    signedIn: account.signedIn,
+    email: account.email,
+    server: account.server,
+    firstRun: !account.signedIn && skills === 0 && !config.welcomed,
+    agentsOnDisk: HOOK_ADAPTERS.filter((adapter) => existsSync5(adapter.home())).map((adapter) => adapter.agent),
+    scope: nearest.scope,
+    manifest: nearest.path,
+    skills,
+    bundles: Object.keys(nearest.manifest.bundles).length,
+    loose: looseSkills(nearest.manifest).length
+  };
 }
 // src/shell/screens/home.tsx
-import { Box as Box10, Text as Text12, useApp as useApp7, useInput as useInput3 } from "ink";
-import { useCallback as useCallback3, useEffect as useEffect8, useMemo as useMemo3, useRef, useState as useState8 } from "react";
+import { Box as Box14, Text as Text16, useApp as useApp7, useInput as useInput8 } from "ink";
+import { useCallback as useCallback3, useEffect as useEffect9, useMemo as useMemo4, useRef, useState as useState11 } from "react";
 // src/screens.tsx
-import { Box as Box9, Text as Text11, useApp as useApp6 } from "ink";
-import { useEffect as useEffect7, useState as useState7 } from "react";
-import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+import { Box as Box10, Text as Text12, useApp as useApp6, useInput as useInput5 } from "ink";
+import { useEffect as useEffect7, useState as useState8 } from "react";
+import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 var MARKS = {
   ok: { glyph: mark.ok, color: "green" },
   fail: { glyph: mark.fail, color: tone.danger },
@@ -4458,16 +5106,16 @@ function ReportRow({ line: line2, width }) {
   const { glyph, color } = MARKS[line2.mark];
   const head = line2.mark === "none" ? "" : `${glyph} `;
   const room = width - FRAME_CHROME - head.length;
-  return /* @__PURE__ */ jsxs10(Text11, {
+  return /* @__PURE__ */ jsxs12(Text12, {
     children: [
-      head ? /* @__PURE__ */ jsx11(Text11, {
+      head ? /* @__PURE__ */ jsx13(Text12, {
         color,
         children: head
       }) : null,
-      /* @__PURE__ */ jsx11(Text11, {
+      /* @__PURE__ */ jsx13(Text12, {
         children: clip(line2.text, room)
       }),
-      line2.note ? /* @__PURE__ */ jsx11(Text11, {
+      line2.note ? /* @__PURE__ */ jsx13(Text12, {
         dimColor: true,
         children: clip(`  ${line2.note}`, Math.max(room - line2.text.length, 0))
       }) : null
@@ -4479,11 +5127,14 @@ function ReportScreen({
   load,
   onError,
   onReport,
-  exitWhenDone = true
+  exitWhenDone = true,
+  onBack,
+  working = "Working...",
+  onNext
 }) {
   const { exit } = useApp6();
   const width = useFrameWidth();
-  const [report, setReport] = useState7(null);
+  const [report, setReport] = useState8(null);
   useEffect7(() => {
     let live = true;
     load().then((result) => {
@@ -4503,29 +5154,632 @@ function ReportScreen({
     if (report && exitWhenDone)
       exit();
   }, [report, exit, exitWhenDone]);
-  return /* @__PURE__ */ jsx11(Frame, {
+  const next = report?.next;
+  useInput5((input) => {
+    if (input === "n" && next)
+      onNext?.(next.command);
+  }, { isActive: Boolean(onNext && next) });
+  return /* @__PURE__ */ jsxs12(Frame, {
+    title,
+    width,
+    children: [
+      report ? /* @__PURE__ */ jsxs12(Box10, {
+        flexDirection: "column",
+        children: [
+          report.lines.map((line2) => /* @__PURE__ */ jsx13(ReportRow, {
+            line: line2,
+            width
+          }, `${line2.mark}:${line2.text}`)),
+          next ? /* @__PURE__ */ jsxs12(Text12, {
+            children: [
+              /* @__PURE__ */ jsx13(Text12, {
+                dimColor: true,
+                children: "next  "
+              }),
+              /* @__PURE__ */ jsx13(Text12, {
+                color: tone.primary,
+                children: next.command
+              }),
+              /* @__PURE__ */ jsx13(Text12, {
+                dimColor: true,
+                children: clip(`  ${next.why}`, width - FRAME_CHROME)
+              })
+            ]
+          }) : null
+        ]
+      }) : /* @__PURE__ */ jsxs12(Text12, {
+        children: [
+          /* @__PURE__ */ jsx13(Spinner, {}),
+          /* @__PURE__ */ jsx13(Text12, {
+            dimColor: true,
+            children: ` ${working}`
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsx13(Back, {
+        width,
+        onBack,
+        extra: onNext && next ? [["n", "run next"]] : []
+      })
+    ]
+  });
+}
+
+// src/args.ts
+var COMMAND_WORDS = [
+  "browse",
+  "login",
+  "logout",
+  "whoami",
+  "org",
+  "list",
+  "search",
+  "bundle",
+  "add",
+  "install",
+  "remove",
+  "update",
+  "installed",
+  "outdated",
+  "doctor",
+  "config",
+  "hooks",
+  "help",
+  "version"
+];
+function configCommand(rest) {
+  const [action, key, ...value] = rest;
+  if (action === undefined || action === "get") {
+    return { kind: "config", action: "get", ...key ? { key } : {} };
+  }
+  if (action !== "set") {
+    return {
+      kind: "error",
+      message: `config takes get or set, not ${action}: yourskills config get [key]`
+    };
+  }
+  if (!key) {
+    return {
+      kind: "error",
+      message: "config set needs a key: yourskills config set <key> <value>"
+    };
+  }
+  if (value.length === 0) {
+    return {
+      kind: "error",
+      message: `config set needs a value: yourskills config set ${key} <value>`
+    };
+  }
+  return { kind: "config", action: "set", key, value: value.join(" ") };
+}
+function hooksCommand(rest, agent, track) {
+  const action = rest[0] ?? "status";
+  if (action !== "install" && action !== "uninstall" && action !== "status") {
+    return {
+      kind: "error",
+      message: `hooks takes install, uninstall or status, not ${action}`
+    };
+  }
+  return {
+    kind: "hooks",
+    action,
+    ...agent ? { agent } : {},
+    ...track === undefined ? {} : { track }
+  };
+}
+function parseArgv(args, interactive = true) {
+  const opts = {};
+  const positional = [];
+  let plain = !interactive;
+  let json = false;
+  let all = false;
+  let quiet = false;
+  let server;
+  let track;
+  const done = (command2) => ({
+    command: command2,
+    output: { plain, json },
+    ...server ? { server } : {}
+  });
+  for (let i = 0;i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "-h" || arg === "--help")
+      return done({ kind: "help" });
+    if (arg === "-v" || arg === "--version")
+      return done({ kind: "version" });
+    if (arg === "--plain") {
+      plain = true;
+    } else if (arg === "--json") {
+      json = true;
+      plain = true;
+    } else if (arg === "-g" || arg === "--global") {
+      opts.scope = "global";
+    } else if (arg === "-p" || arg === "--project") {
+      opts.scope = "project";
+    } else if (arg === "--all") {
+      all = true;
+    } else if (arg === "-q" || arg === "--quiet") {
+      quiet = true;
+    } else if (arg === "--track") {
+      track = true;
+    } else if (arg === "--no-track") {
+      track = false;
+    } else if (arg === "--server") {
+      const value = args[++i];
+      if (!value)
+        return done({ kind: "error", message: "--server requires a URL" });
+      server = value;
+    } else if (arg === "-a" || arg === "--agent") {
+      const value = args[++i];
+      if (!value)
+        return done({
+          kind: "error",
+          message: "--agent requires an agent name"
+        });
+      opts.agents = [...opts.agents ?? [], value];
+    } else if (arg.startsWith("-")) {
+      return done({
+        kind: "error",
+        message: `unknown option ${arg}`,
+        next: "yourskills --help"
+      });
+    } else {
+      positional.push(arg);
+    }
+  }
+  const [command, ...rest] = positional;
+  switch (command) {
+    case undefined:
+      return done(plain ? { kind: "help" } : { kind: "home" });
+    case "help":
+      return done({ kind: "help" });
+    case "version":
+      return done({ kind: "version" });
+    case "browse":
+      return done(plain ? {
+        kind: "error",
+        message: "browse needs a terminal; use `list` or `search` instead"
+      } : { kind: "browse" });
+    case "login":
+      return done({ kind: "login" });
+    case "logout":
+      return done({ kind: "logout" });
+    case "whoami":
+      return done({ kind: "whoami" });
+    case "list":
+      return done({ kind: "list" });
+    case "search":
+      return done(rest.length > 0 ? { kind: "search", query: rest.join(" ") } : {
+        kind: "error",
+        message: "search needs a query: yourskills search <query>"
+      });
+    case "add":
+      return done(rest.length > 0 ? { kind: "add", names: rest, opts } : {
+        kind: "error",
+        message: "add needs at least one skill: yourskills add <skill...>"
+      });
+    case "install":
+      return done(rest.length > 0 ? { kind: "add", names: rest, opts } : { kind: "install", opts });
+    case "remove":
+      return done(rest.length > 0 ? { kind: "remove", names: rest, opts } : {
+        kind: "error",
+        message: "remove needs at least one skill: yourskills remove <skill...>"
+      });
+    case "installed":
+      return done({ kind: "installed" });
+    case "outdated":
+      return done({ kind: "outdated", ...quiet ? { quiet: true } : {} });
+    case "doctor":
+      return done({ kind: "doctor" });
+    case "org":
+      return done(rest[0] ? { kind: "org", name: rest[0] } : { kind: "org" });
+    case "config":
+      return done(configCommand(rest));
+    case "hooks":
+      return done(hooksCommand(rest, opts.agents?.[0], track));
+    case "hook": {
+      const event = rest[0];
+      return done(event && isHookEventName(event) ? { kind: "hook", event } : {
+        kind: "error",
+        message: "hook takes session-start or post-tool-use"
+      });
+    }
+    case "bundle":
+      return done(rest[0] ? { kind: "bundle", name: rest[0], opts } : {
+        kind: "error",
+        message: "bundle needs a name: yourskills bundle <name>"
+      });
+    case "update":
+      return done({
+        kind: "update",
+        ...rest[0] ? { bundle: rest[0] } : {},
+        ...all ? { all: true } : {},
+        opts
+      });
+    default: {
+      const guess = closest(command, COMMAND_WORDS);
+      return done({
+        kind: "error",
+        message: `unknown command ${command}`,
+        ...guess ? { why: `did you mean ${guess}?`, next: `yourskills ${guess}` } : { next: "yourskills --help" }
+      });
+    }
+  }
+}
+
+// src/shell/typed.ts
+var RUNNABLE = new Set([
+  "browse",
+  "login",
+  "logout",
+  "whoami",
+  "org",
+  "list",
+  "search",
+  "add",
+  "bundle",
+  "install",
+  "remove",
+  "update",
+  "installed",
+  "outdated",
+  "doctor",
+  "config",
+  "hooks"
+]);
+function typedCommand(query) {
+  const words = query.trim().split(/\s+/).filter(Boolean);
+  if (words.length === 0)
+    return null;
+  if (words[0] === "yourskills")
+    words.shift();
+  if (words.length === 0)
+    return null;
+  const { command } = parseArgv(words, true);
+  if (command.kind !== "error" && !RUNNABLE.has(command.kind))
+    return null;
+  return { command, text: words.join(" ") };
+}
+function runnable(typed) {
+  return typed !== null && typed.command.kind !== "error";
+}
+function count3(n, one, many = `${one}s`) {
+  return `${n} ${n === 1 ? one : many}`;
+}
+function where2(scope, facts) {
+  return (scope ?? facts.scope) === "project" ? "into this project" : "everywhere on this computer";
+}
+function describeCommand(command, facts) {
+  switch (command.kind) {
+    case "add":
+      return `install ${count3(command.names.length, "skill")} ${where2(command.opts.scope, facts)}: ${command.names.join(", ")}`;
+    case "bundle":
+      return `install the bundle ${command.name} ${where2(command.opts.scope, facts)}, at the refs your registry pins today`;
+    case "install":
+      return facts.skills > 0 ? `re-install the ${count3(facts.skills, "skill")} recorded in ${facts.manifest}, at their recorded refs` : "nothing is recorded here to re-install";
+    case "update": {
+      if (command.bundle)
+        return `re-install ${command.bundle} at what the registry blesses today`;
+      const scope = updateScope(facts.bundles, command.all ? facts.loose : 0);
+      return scope === "" ? "nothing is tracked here to update" : `re-install ${scope} at what the registry blesses today`;
+    }
+    case "remove":
+      return `delete ${command.names.join(", ")} from disk and from ${facts.manifest} (asks first)`;
+    case "installed":
+      return describe2("installed.list", facts);
+    case "outdated":
+      return describe2("installed.outdated", facts);
+    case "doctor":
+      return describe2("setup.doctor", facts);
+    case "whoami":
+      return describe2("account.whoami", facts);
+    case "logout":
+      return describe2("account.logout", facts);
+    case "login":
+      return describe2("account.login", facts);
+    case "org":
+      return command.name ? `switch this machine to the organization ${command.name}` : describe2("account.org", facts);
+    case "config":
+      return command.action === "set" ? `set ${command.key} to ${command.value} in your config file` : command.key ? `show the stored ${command.key}` : "show every stored setting";
+    case "hooks":
+      return command.action === "install" ? "register our hooks in your agents' settings, so skills stay updated" : command.action === "uninstall" ? "remove our hooks from your agents' settings, leaving every other hook alone" : "show which agents carry our hooks, and where";
+    case "list":
+      return describe2("catalog.skills", facts);
+    case "search":
+      return `open the catalog filtered on "${command.query}"`;
+    case "browse":
+      return describe2("catalog.bundles", facts);
+    case "error":
+      return command.why ? `${command.message}, ${command.why}` : command.message;
+    case "home":
+    case "help":
+    case "version":
+    case "hook":
+      return "";
+  }
+}
+
+// src/shell/screens/keys.tsx
+import { Box as Box11, Text as Text13 } from "ink";
+import { jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
+var KEYS = [
+  ["^ v", "move the cursor", "move, or scroll"],
+  ["enter", "run the highlighted row", "confirm the layer's action"],
+  ["tab", "complete the prompt from the row", "switch tab in the browser"],
+  ["space", "types into the prompt", "mark a row in a list"],
+  ["n", "types into the prompt", "run the next step a report suggests"],
+  ["esc", "clear the prompt, then quit", "back one layer"],
+  ["x", "types into the prompt", "back, where there is no prompt"],
+  ["?", "this", "this"],
+  ["ctrl-c", "quit now", "quit now"]
+];
+function KeysScreen({ onBack }) {
+  const width = useFrameWidth();
+  const interior = width - FRAME_CHROME;
+  const key = 8;
+  const half = Math.floor((interior - key) / 2);
+  return /* @__PURE__ */ jsxs13(Frame, {
+    title: "keys",
+    width,
+    children: [
+      /* @__PURE__ */ jsxs13(Box11, {
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsxs13(Text13, {
+            children: [
+              /* @__PURE__ */ jsx14(Text13, {
+                dimColor: true,
+                children: "".padEnd(key)
+              }),
+              /* @__PURE__ */ jsx14(Text13, {
+                dimColor: true,
+                children: "at the prompt".padEnd(half)
+              }),
+              /* @__PURE__ */ jsx14(Text13, {
+                dimColor: true,
+                children: "in a layer"
+              })
+            ]
+          }),
+          KEYS.map(([k, root, layer]) => /* @__PURE__ */ jsxs13(Text13, {
+            children: [
+              /* @__PURE__ */ jsx14(Text13, {
+                color: tone.primary,
+                children: k.padEnd(key)
+              }),
+              /* @__PURE__ */ jsx14(Text13, {
+                children: clip(root, half - 2).padEnd(half)
+              }),
+              /* @__PURE__ */ jsx14(Text13, {
+                children: clip(layer, interior - key - half)
+              })
+            ]
+          }, k))
+        ]
+      }),
+      /* @__PURE__ */ jsx14(Back, {
+        width,
+        onBack
+      })
+    ]
+  });
+}
+
+// src/shell/screens/picker.tsx
+import { Box as Box12, Text as Text14, useInput as useInput6 } from "ink";
+import { useEffect as useEffect8, useMemo as useMemo3, useState as useState9 } from "react";
+import { jsx as jsx15, jsxs as jsxs14 } from "react/jsx-runtime";
+function PickScreen({
+  title,
+  rows: rows2,
+  empty,
+  verb,
+  onPick,
+  onBack
+}) {
+  const width = useFrameWidth();
+  const [query, setQuery] = useState9("");
+  const [cursor, setCursor] = useState9(0);
+  const [picked, setPicked] = useState9(new Set);
+  const visible = useMemo3(() => {
+    if (query.length === 0)
+      return rows2;
+    const q = query.toLowerCase();
+    return rows2.filter((row) => row.name.toLowerCase().includes(q) || (row.description ?? "").toLowerCase().includes(q));
+  }, [rows2, query]);
+  useEffect8(() => {
+    setCursor((c) => Math.max(0, Math.min(c, visible.length - 1)));
+  }, [visible.length]);
+  useInput6((input, key) => {
+    if (key.upArrow) {
+      setCursor((c) => Math.max(0, c - 1));
+    } else if (key.downArrow) {
+      setCursor((c) => Math.min(visible.length - 1, c + 1));
+    } else if (key.return) {
+      const names2 = picked.size > 0 ? [...picked] : visible[cursor] ? [visible[cursor].name] : [];
+      if (names2.length > 0)
+        onPick(names2);
+    } else if (key.escape) {
+      if (query.length > 0)
+        setQuery("");
+      else
+        onBack();
+    } else if (key.backspace || key.delete) {
+      setQuery((q) => q.slice(0, -1));
+      setCursor(0);
+    } else if (input === " ") {
+      const row = visible[cursor];
+      if (!row)
+        return;
+      setPicked((current) => {
+        const next = new Set(current);
+        if (next.has(row.name))
+          next.delete(row.name);
+        else
+          next.add(row.name);
+        return next;
+      });
+    } else if (input && !key.ctrl && !key.meta) {
+      setQuery((q) => q + input);
+      setCursor(0);
+    }
+  });
+  const names = nameWidth(rows2);
+  return /* @__PURE__ */ jsx15(Frame, {
     title,
     width,
-    children: report ? /* @__PURE__ */ jsx11(Box9, {
+    children: /* @__PURE__ */ jsxs14(Box12, {
       flexDirection: "column",
-      children: report.lines.map((line2) => /* @__PURE__ */ jsx11(ReportRow, {
-        line: line2,
+      children: [
+        /* @__PURE__ */ jsxs14(Box12, {
+          children: [
+            /* @__PURE__ */ jsx15(Text14, {
+              color: tone.primary,
+              children: "> "
+            }),
+            /* @__PURE__ */ jsx15(SearchInput, {
+              value: query,
+              placeholder: "type to filter"
+            })
+          ]
+        }),
+        /* @__PURE__ */ jsx15(Divider, {
+          width
+        }),
+        rows2.length === 0 ? /* @__PURE__ */ jsx15(Text14, {
+          dimColor: true,
+          children: empty
+        }) : visible.length === 0 ? /* @__PURE__ */ jsx15(Text14, {
+          dimColor: true,
+          children: `Nothing matches "${query}".`
+        }) : visible.map((row, i) => /* @__PURE__ */ jsx15(SkillRow, {
+          row,
+          width: width - 2,
+          names,
+          selectable: true,
+          cursor: i === cursor,
+          selected: picked.has(row.name)
+        }, row.name)),
+        /* @__PURE__ */ jsx15(Divider, {
+          width
+        }),
+        /* @__PURE__ */ jsxs14(Box12, {
+          children: [
+            picked.size > 0 ? /* @__PURE__ */ jsx15(Text14, {
+              color: tone.notice,
+              children: `${mark.selected} ${picked.size} marked   `
+            }) : null,
+            /* @__PURE__ */ jsx15(Hints, {
+              hints: [
+                ["^v", "move"],
+                ["space", "mark"],
+                ["enter", verb],
+                ["esc", query ? "clear" : "back"]
+              ]
+            })
+          ]
+        })
+      ]
+    })
+  });
+}
+
+// src/shell/screens/welcome.tsx
+import { Box as Box13, Text as Text15, useInput as useInput7 } from "ink";
+import { useState as useState10 } from "react";
+import { jsx as jsx16, jsxs as jsxs15 } from "react/jsx-runtime";
+function WelcomeScreen({
+  agents: agents2,
+  onStart,
+  onSkip
+}) {
+  const width = useFrameWidth();
+  const interior = width - FRAME_CHROME;
+  const [choice, setChoice] = useState10("start");
+  useInput7((_input, key) => {
+    if (key.upArrow || key.downArrow) {
+      setChoice((c) => c === "start" ? "skip" : "start");
+    } else if (key.return) {
+      if (choice === "start")
+        onStart();
+      else
+        onSkip();
+    } else if (key.escape) {
+      onSkip();
+    }
+  });
+  const found = agents2.length > 0 ? `found on this machine: ${agents2.join(", ")}` : "none found yet; the catalog will ask";
+  const steps = [
+    ["1", "sign in", "a code you enter in your browser"],
+    ["2", "pick your tools", found],
+    ["3", "get skills", "the bundle your team uses"]
+  ];
+  const row = (label, hint, active) => {
+    const gap = Math.max(interior - 2 - label.length - hint.length, 1);
+    return /* @__PURE__ */ jsxs15(Text15, {
+      children: [
+        /* @__PURE__ */ jsx16(Text15, {
+          color: tone.primary,
+          children: `${active ? mark.cursor : " "} `
+        }),
+        /* @__PURE__ */ jsx16(Text15, {
+          bold: active,
+          color: active ? tone.primary : undefined,
+          children: label
+        }),
+        /* @__PURE__ */ jsx16(Text15, {
+          dimColor: true,
+          children: `${" ".repeat(gap)}${hint}`
+        })
+      ]
+    });
+  };
+  return /* @__PURE__ */ jsxs15(Frame, {
+    title: "yourskills",
+    width,
+    children: [
+      /* @__PURE__ */ jsxs15(Box13, {
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsx16(Text15, {
+            children: "Welcome. Three steps, about a minute."
+          }),
+          /* @__PURE__ */ jsx16(Blank, {}),
+          steps.map(([n, what, how]) => /* @__PURE__ */ jsxs15(Text15, {
+            children: [
+              /* @__PURE__ */ jsx16(Text15, {
+                color: tone.primary,
+                children: `${n}  `
+              }),
+              /* @__PURE__ */ jsx16(Text15, {
+                children: what.padEnd(16)
+              }),
+              /* @__PURE__ */ jsx16(Text15, {
+                dimColor: true,
+                children: clip(how, interior - 19)
+              })
+            ]
+          }, n)),
+          /* @__PURE__ */ jsx16(Blank, {}),
+          row("start", "", choice === "start"),
+          row("skip, I know what I am doing", "yourskills login", choice === "skip")
+        ]
+      }),
+      /* @__PURE__ */ jsx16(Divider, {
         width
-      }, `${line2.mark}:${line2.text}`))
-    }) : /* @__PURE__ */ jsxs10(Text11, {
-      children: [
-        /* @__PURE__ */ jsx11(Spinner, {}),
-        /* @__PURE__ */ jsx11(Text11, {
-          dimColor: true,
-          children: " Working..."
-        })
-      ]
-    })
+      }),
+      /* @__PURE__ */ jsx16(Hints, {
+        hints: [
+          ["enter", choice === "start" ? "start" : "skip"],
+          ["esc", "skip"]
+        ]
+      })
+    ]
   });
 }
 
 // src/shell/screens/home.tsx
-import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
+import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
 function failure(title, error) {
   const message = error instanceof Error ? error.message : String(error);
   return {
@@ -4549,23 +5803,88 @@ function identityReport(who) {
     json: { ...who }
   };
 }
+function hostOf(server) {
+  try {
+    return new URL(server).host;
+  } catch {
+    return server;
+  }
+}
+function removeArgv(names, opts) {
+  return `yourskills remove ${names.join(" ")}${opts.scope === "project" ? " --project" : ""}`;
+}
+function AccountLine({ facts, width }) {
+  const right = `${facts.scope}  ${facts.skills} installed`;
+  const head = facts.signedIn ? facts.email ?? "signed in" : "not signed in";
+  const room = Math.max(width - FRAME_CHROME - right.length - 2, 12);
+  const tail = facts.signedIn ? `  ${hostOf(facts.server)}` : " — the catalog needs a session";
+  const spare = room - 2 - head.length;
+  return /* @__PURE__ */ jsxs16(Box14, {
+    width: width - FRAME_CHROME,
+    justifyContent: "space-between",
+    children: [
+      /* @__PURE__ */ jsxs16(Text16, {
+        children: [
+          /* @__PURE__ */ jsx17(Text16, {
+            color: facts.signedIn ? "green" : tone.notice,
+            children: facts.signedIn ? mark.ok : mark.fail
+          }),
+          /* @__PURE__ */ jsx17(Text16, {
+            color: facts.signedIn ? undefined : tone.notice,
+            children: ` ${clip(head, room - 2)}`
+          }),
+          spare >= tail.length ? /* @__PURE__ */ jsx17(Text16, {
+            dimColor: true,
+            children: tail
+          }) : null
+        ]
+      }),
+      /* @__PURE__ */ jsx17(Text16, {
+        dimColor: true,
+        children: right
+      })
+    ]
+  });
+}
+var RUN = "run";
 function HomeScreen({
   opts,
+  facts: initial,
+  reload,
   server,
   openClient,
   onError,
-  onSummary
+  onSummary,
+  onWelcomed = async () => {
+    return;
+  }
 }) {
   const { exit } = useApp7();
   const width = useFrameWidth();
-  const groups = useMemo3(() => paletteGroups(), []);
-  const [query, setQuery] = useState8("");
-  const [cursor, setCursor] = useState8(0);
-  const [route, setRoute] = useState8(null);
-  const [client, setClient] = useState8(null);
-  const [refused, setRefused] = useState8(null);
-  const rows2 = useMemo3(() => flattenCommands(filterCommands(groups, query)), [groups, query]);
-  useEffect8(() => {
+  const [facts, setFacts] = useState11(initial);
+  const groups = useMemo4(() => paletteGroups(facts), [facts]);
+  const [query, setQuery] = useState11("");
+  const [cursor, setCursor] = useState11(0);
+  const [route, setRoute] = useState11(null);
+  const [client, setClient] = useState11(null);
+  const [refused, setRefused] = useState11(null);
+  const [welcome, setWelcome] = useState11(initial.firstRun);
+  const [wizard, setWizard] = useState11(false);
+  const typed = useMemo4(() => typedCommand(query), [query]);
+  const visible = useMemo4(() => {
+    const filtered = filterCommands(groups, query);
+    if (!runnable(typed))
+      return filtered;
+    return [
+      {
+        group: "Run",
+        items: [{ value: RUN, label: typed.text, hint: "enter to run" }]
+      },
+      ...filtered
+    ];
+  }, [groups, query, typed]);
+  const rows2 = useMemo4(() => flattenCommands(visible), [visible]);
+  useEffect9(() => {
     setCursor((c) => Math.max(0, Math.min(c, rows2.length - 1)));
   }, [rows2.length]);
   const held = useRef(null);
@@ -4573,9 +5892,10 @@ function HomeScreen({
     held.current ??= await openClient();
     return held.current;
   }, [openClient]);
-  const answering = useCallback3((title, load) => ({
+  const answering = useCallback3((title, working, load) => ({
     kind: "report",
     title,
+    working,
     load: async () => {
       try {
         return await load();
@@ -4584,77 +5904,239 @@ function HomeScreen({
       }
     }
   }), []);
-  const routeFor = useCallback3((value) => {
-    switch (value) {
-      case "catalog.bundles":
-      case "catalog.skills":
-      case "catalog.search":
+  const signOut = useCallback3(async () => {
+    await logout();
+    held.current = null;
+    setClient(null);
+    return {
+      title: "logout",
+      lines: [{ mark: "ok", text: "Logged out." }],
+      json: { ok: true }
+    };
+  }, []);
+  const routeForCommand = useCallback3(async (command) => {
+    const plan = describeCommand(command, facts);
+    switch (command.kind) {
+      case "login":
+        return { kind: "login" };
+      case "browse":
         return { kind: "browse" };
-      case "installed.list":
-        return answering("installed", async () => installedReport(await nearestManifest(opts.scope)));
-      case "installed.update":
+      case "list":
+        return { kind: "browse", tab: "skills" };
+      case "search":
+        return { kind: "browse", tab: "skills", query: command.query };
+      case "add": {
+        const resolved = await resolveInstallOptions(command.opts);
         return {
           kind: "install",
-          title: "update",
+          title: "add",
+          plan,
           stream: async function* stream() {
-            const nearest = await nearestManifest(opts.scope);
-            yield* updateTracked(await connect(), nearest.manifest, opts, true);
+            yield* install(await connect(), command.names, resolved);
           }
         };
-      case "installed.outdated":
-        return answering("outdated", async () => outdatedReport(await connect(), await nearestManifest(opts.scope)));
-      case "installed.remove":
-        return answering("remove", async () => {
-          const report = installedReport(await nearestManifest(opts.scope));
+      }
+      case "bundle": {
+        const resolved = await resolveInstallOptions(command.opts);
+        return {
+          kind: "install",
+          title: `bundle: ${command.name}`,
+          plan,
+          stream: async function* stream() {
+            yield* installBundle(await connect(), command.name, resolved);
+          }
+        };
+      }
+      case "install": {
+        const resolved = await resolveInstallOptions(command.opts);
+        const nearest = await nearestManifest(resolved.scope);
+        const empty2 = nothingTracked(nearest, "install");
+        if (empty2)
+          return answering("install", plan, async () => empty2);
+        return {
+          kind: "install",
+          title: "install",
+          plan,
+          stream: () => reinstall(nearest.manifest, resolved)
+        };
+      }
+      case "update": {
+        const resolved = await resolveInstallOptions(command.opts);
+        if (command.bundle) {
+          const name = command.bundle;
           return {
-            ...report,
-            title: "remove",
-            lines: [
-              {
-                mark: "none",
-                text: "Run `yourskills remove <skill>` to delete one."
-              },
-              ...report.lines
-            ]
+            kind: "install",
+            title: `update: ${name}`,
+            plan,
+            stream: async function* stream() {
+              yield* update(await connect(), name, resolved);
+            }
           };
-        });
+        }
+        const nearest = await nearestManifest(resolved.scope);
+        const all = command.all ?? false;
+        const empty2 = nothingTracked(nearest, "update", all);
+        if (empty2)
+          return answering("update", plan, async () => empty2);
+        return {
+          kind: "install",
+          title: "update",
+          plan,
+          stream: async function* stream() {
+            yield* updateTracked(await connect(), nearest.manifest, resolved, all);
+          }
+        };
+      }
+      case "remove": {
+        const resolved = await resolveInstallOptions(command.opts);
+        return {
+          kind: "confirm",
+          names: command.names,
+          nearest: await nearestManifest(resolved.scope),
+          opts: resolved
+        };
+      }
+      case "installed":
+        return answering("installed", plan, async () => installedReport(await nearestManifest(opts.scope)));
+      case "outdated":
+        return answering("outdated", plan, async () => outdatedReport(await connect(), await nearestManifest(opts.scope)));
+      case "doctor":
+        return answering("doctor", plan, async () => doctorReport(await nearestManifest(opts.scope), server));
+      case "org":
+        return answering("org", plan, () => command.name ? orgSwitchReport(command.name, server) : orgListReport(server));
+      case "config":
+        return answering("config", plan, () => command.action === "get" ? configGet(command.key) : configSet(command.key, command.value));
+      case "whoami":
+        return answering("whoami", plan, async () => identityReport(await whoami(server)));
+      case "logout":
+        return answering("logout", plan, signOut);
+      case "hooks":
+        return answering("hooks", plan, () => command.action === "install" ? hooksInstall({
+          ...command.agent ? { agent: command.agent } : {},
+          ...command.track === undefined ? {} : { track: command.track }
+        }) : command.action === "uninstall" ? hooksUninstall(command.agent ? { agent: command.agent } : {}) : hooksStatus());
+      case "error":
+      case "home":
+      case "help":
+      case "version":
+      case "hook":
+        return null;
+    }
+  }, [answering, connect, facts, opts, server, signOut]);
+  const routeFor = useCallback3(async (value) => {
+    switch (value) {
+      case "catalog.bundles":
+        return { kind: "browse" };
+      case "catalog.skills":
+      case "catalog.search":
+        return { kind: "browse", tab: "skills" };
+      case "installed.list":
+        return routeForCommand({ kind: "installed" });
+      case "installed.update":
+        return routeForCommand({ kind: "update", all: true, opts: {} });
+      case "installed.outdated":
+        return routeForCommand({ kind: "outdated" });
+      case "installed.remove": {
+        const nearest = await nearestManifest(opts.scope);
+        return {
+          kind: "pick",
+          rows: installedRows(nearest).map((row) => ({
+            name: row.name,
+            description: `${row.bundle ?? "loose"}  ${shortRef(row.ref)}`
+          }))
+        };
+      }
       case "account.login":
         return { kind: "login" };
       case "account.logout":
-        return answering("logout", async () => {
-          await logout();
-          held.current = null;
-          setClient(null);
-          return {
-            title: "logout",
-            lines: [{ mark: "ok", text: "Logged out." }],
-            json: { ok: true }
-          };
-        });
+        return routeForCommand({ kind: "logout" });
       case "account.whoami":
-        return answering("whoami", async () => identityReport(await whoami(server)));
+        return routeForCommand({ kind: "whoami" });
       case "account.org":
-        return answering("org", () => orgListReport(server));
+        return routeForCommand({ kind: "org" });
       case "setup.scope":
-        return answering("scope", () => configGet("scope"));
+        return routeForCommand({
+          kind: "config",
+          action: "get",
+          key: "scope"
+        });
       case "setup.agents":
-        return answering("agents", () => configGet("agents"));
+        return routeForCommand({
+          kind: "config",
+          action: "get",
+          key: "agents"
+        });
       case "setup.doctor":
-        return answering("doctor", async () => doctorReport(await nearestManifest(opts.scope), server));
+        return routeForCommand({ kind: "doctor" });
     }
-  }, [answering, connect, opts, server]);
+  }, [opts.scope, routeForCommand]);
+  const open = useCallback3((pending, title) => {
+    pending.then((next) => {
+      if (next)
+        setRoute(next);
+    }).catch((error) => {
+      setRoute(answering(title, "", async () => failure(title, error)));
+    });
+  }, [answering]);
+  const runText = useCallback3((text) => {
+    const parsed = typedCommand(text);
+    if (!runnable(parsed))
+      return;
+    open(routeForCommand(parsed.command), parsed.text);
+  }, [open, routeForCommand]);
+  const current = rows2[cursor];
   const activate = useCallback3(() => {
     const item = rows2[cursor];
     if (!item)
       return;
     item.onSelect?.();
-    setRoute(routeFor(item.value));
-  }, [rows2, cursor, routeFor]);
+    if (item.value === RUN) {
+      if (runnable(typed))
+        open(routeForCommand(typed.command), typed.text);
+      return;
+    }
+    open(routeFor(item.value), item.label);
+  }, [rows2, cursor, typed, open, routeFor, routeForCommand]);
+  const complete = useCallback3(() => {
+    const item = rows2[cursor]?.value === RUN ? rows2[cursor + 1] : rows2[cursor];
+    if (!item?.hint)
+      return;
+    const bare = item.hint.replace(/<[^>]+>/g, "").trimEnd();
+    setQuery(item.hint.includes("<") ? `${bare} ` : bare);
+    setCursor(0);
+  }, [rows2, cursor]);
   const back = useCallback3(() => {
     setRoute(null);
     setRefused(null);
-  }, []);
-  useEffect8(() => {
+    setQuery("");
+    setCursor(0);
+    reload().then(setFacts).catch(() => {
+      return;
+    });
+  }, [reload]);
+  const afterLogin = useCallback3(() => {
+    if (!wizard) {
+      back();
+      return;
+    }
+    setWizard(false);
+    setRefused(null);
+    reload().then((next) => {
+      setFacts(next);
+      setRoute({ kind: "browse" });
+    }).catch(() => setRoute(null));
+  }, [wizard, back, reload]);
+  const leaveWelcome = useCallback3((start) => {
+    setWelcome(false);
+    onWelcomed().catch(() => {
+      return;
+    });
+    if (start) {
+      setWizard(true);
+      setRoute({ kind: "login" });
+    }
+  }, [onWelcomed]);
+  useEffect9(() => {
     if (route?.kind !== "browse" || client || refused)
       return;
     let live = true;
@@ -4669,14 +6151,15 @@ function HomeScreen({
       live = false;
     };
   }, [route, client, refused, connect]);
-  const browsing = route?.kind === "browse" && client !== null;
-  useInput3((input, key) => {
+  useInput8((input, key) => {
     if (key.upArrow) {
       setCursor((c) => Math.max(0, c - 1));
     } else if (key.downArrow) {
       setCursor((c) => Math.min(rows2.length - 1, c + 1));
     } else if (key.return) {
       activate();
+    } else if (key.tab) {
+      complete();
     } else if (key.escape) {
       if (query.length > 0)
         setQuery("");
@@ -4685,104 +6168,192 @@ function HomeScreen({
     } else if (key.backspace || key.delete) {
       setQuery((q) => q.slice(0, -1));
       setCursor(0);
+    } else if (input === "?" && query.length === 0) {
+      setRoute({ kind: "keys" });
     } else if (input && !key.ctrl && !key.meta) {
       setQuery((q) => q + input);
       setCursor(0);
     }
-  }, { isActive: route === null });
-  useInput3((_input, key) => {
-    if (key.escape)
-      back();
-  }, { isActive: route !== null && !browsing });
+  }, { isActive: route === null && !welcome });
+  if (welcome) {
+    return /* @__PURE__ */ jsx17(WelcomeScreen, {
+      agents: facts.agentsOnDisk,
+      onStart: () => leaveWelcome(true),
+      onSkip: () => leaveWelcome(false)
+    });
+  }
   if (route?.kind === "login") {
-    return /* @__PURE__ */ jsx12(LoginScreen, {
+    return /* @__PURE__ */ jsx17(LoginScreen, {
       onError,
-      onDone: back
+      onDone: afterLogin,
+      onBack: back
+    });
+  }
+  if (route?.kind === "keys") {
+    return /* @__PURE__ */ jsx17(KeysScreen, {
+      onBack: back
     });
   }
   if (route?.kind === "report") {
-    return /* @__PURE__ */ jsx12(ReportScreen, {
+    return /* @__PURE__ */ jsx17(ReportScreen, {
       title: route.title,
       load: route.load,
+      working: route.working,
       onError,
-      exitWhenDone: false
+      exitWhenDone: false,
+      onBack: back,
+      onNext: runText
     });
   }
   if (route?.kind === "install") {
-    return /* @__PURE__ */ jsx12(Installer, {
+    return /* @__PURE__ */ jsx17(Installer, {
       title: route.title,
       stream: route.stream,
+      plan: route.plan,
       exitWhenDone: false,
-      onDone: onSummary
+      onDone: onSummary,
+      onBack: back
+    });
+  }
+  if (route?.kind === "pick") {
+    return /* @__PURE__ */ jsx17(PickScreen, {
+      title: "remove",
+      rows: route.rows,
+      empty: "Nothing installed here.",
+      verb: "remove",
+      onPick: (names) => {
+        open(routeForCommand({ kind: "remove", names, opts: {} }), "remove");
+      },
+      onBack: back
+    });
+  }
+  if (route?.kind === "confirm") {
+    const { names, nearest, opts: resolved } = route;
+    const lines = names.map((name) => {
+      const entry = nearest.manifest.skills[name];
+      return entry ? {
+        mark: "fail",
+        text: name,
+        note: entry.agents.length > 0 ? entry.agents.join(", ") : ""
+      } : {
+        mark: "none",
+        text: name,
+        note: "not installed here, nothing to delete"
+      };
+    });
+    const known = names.filter((name) => nearest.manifest.skills[name]);
+    return /* @__PURE__ */ jsx17(ConfirmScreen, {
+      title: "remove",
+      headline: `You are about to delete ${known.length === 1 ? "1 skill" : `${known.length} skills`}`,
+      lines,
+      notes: [
+        `The list of what is installed is updated too: ${nearest.path}`,
+        `Nothing on ${hostOf(facts.server)} changes.`
+      ],
+      yes: "delete them",
+      no: "keep them",
+      argv: removeArgv(names, resolved),
+      onYes: () => setRoute(answering("remove", describeCommand({ kind: "remove", names, opts: resolved }, facts), () => removeSkills(names, nearest.manifest, nearest.path, resolved))),
+      onNo: back
     });
   }
   if (route?.kind === "browse") {
     if (refused) {
-      return /* @__PURE__ */ jsx12(Frame, {
+      return /* @__PURE__ */ jsxs16(Frame, {
         title: "browse",
         width,
-        children: /* @__PURE__ */ jsxs11(Box10, {
-          flexDirection: "column",
-          children: [
-            /* @__PURE__ */ jsxs11(Text12, {
-              children: [
-                /* @__PURE__ */ jsx12(Text12, {
-                  color: tone.danger,
-                  children: mark.fail
-                }),
-                /* @__PURE__ */ jsx12(Text12, {
-                  children: ` ${refused}`
-                })
-              ]
-            }),
-            /* @__PURE__ */ jsx12(Text12, {
-              dimColor: true,
-              children: "Pick `login` from the palette, then try again."
-            })
-          ]
-        })
+        children: [
+          /* @__PURE__ */ jsxs16(Box14, {
+            flexDirection: "column",
+            children: [
+              /* @__PURE__ */ jsxs16(Text16, {
+                children: [
+                  /* @__PURE__ */ jsx17(Text16, {
+                    color: tone.danger,
+                    children: mark.fail
+                  }),
+                  /* @__PURE__ */ jsx17(Text16, {
+                    children: ` ${refused}`
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx17(Text16, {
+                dimColor: true,
+                children: "Pick `login` from the palette, then try again."
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsx17(Back, {
+            width,
+            onBack: back
+          })
+        ]
       });
     }
     if (!client) {
-      return /* @__PURE__ */ jsx12(Frame, {
+      return /* @__PURE__ */ jsxs16(Frame, {
         title: "browse",
         width,
-        children: /* @__PURE__ */ jsxs11(Text12, {
-          children: [
-            /* @__PURE__ */ jsx12(Spinner, {}),
-            /* @__PURE__ */ jsx12(Text12, {
-              dimColor: true,
-              children: " Connecting..."
-            })
-          ]
-        })
+        children: [
+          /* @__PURE__ */ jsxs16(Text16, {
+            children: [
+              /* @__PURE__ */ jsx17(Spinner, {}),
+              /* @__PURE__ */ jsx17(Text16, {
+                dimColor: true,
+                children: " Connecting..."
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsx17(Back, {
+            width,
+            onBack: back
+          })
+        ]
       });
     }
-    return /* @__PURE__ */ jsx12(BrowserScreen, {
+    return /* @__PURE__ */ jsx17(BrowserScreen, {
       client,
       opts,
       onError,
       onSummary,
-      onExit: back
+      onExit: back,
+      ...route.tab ? { initialTab: route.tab } : {},
+      ...route.query ? { initialQuery: route.query } : {}
     });
   }
-  return /* @__PURE__ */ jsxs11(Frame, {
+  const description = current?.value === RUN && runnable(typed) ? describeCommand(typed.command, facts) : current ? describe2(current.value, facts) : typed ? describeCommand(typed.command, facts) : "";
+  const empty = typed?.command.kind === "error" && typed.command.next ? `${mark.fail} ${typed.command.message}  try: ${typed.command.next.replace(/^yourskills /, "")}` : "No matching commands.";
+  return /* @__PURE__ */ jsxs16(Frame, {
     title: "yourskills",
     width,
     children: [
-      /* @__PURE__ */ jsx12(CommandPalette, {
-        groups,
+      /* @__PURE__ */ jsx17(AccountLine, {
+        facts,
+        width
+      }),
+      /* @__PURE__ */ jsx17(Divider, {
+        width
+      }),
+      /* @__PURE__ */ jsx17(CommandPalette, {
+        groups: visible,
         query,
         cursor,
-        width
+        width,
+        emptyMessage: empty
       }),
-      /* @__PURE__ */ jsx12(Divider, {
+      /* @__PURE__ */ jsx17(Divider, {
         width
       }),
-      /* @__PURE__ */ jsx12(Hints, {
+      /* @__PURE__ */ jsx17(Text16, {
+        dimColor: true,
+        children: clip(description, width - FRAME_CHROME)
+      }),
+      /* @__PURE__ */ jsx17(Hints, {
         hints: [
           ["^v", "move"],
-          ["enter", "open"],
+          ["tab", "complete"],
+          ["enter", current?.value === RUN ? "run" : "open"],
+          ["?", "keys"],
           ["esc", query ? "clear" : "quit"]
         ]
       })
@@ -4790,6 +6361,27 @@ function HomeScreen({
   });
 }
 // src/args.ts
+var COMMAND_WORDS2 = [
+  "browse",
+  "login",
+  "logout",
+  "whoami",
+  "org",
+  "list",
+  "search",
+  "bundle",
+  "add",
+  "install",
+  "remove",
+  "update",
+  "installed",
+  "outdated",
+  "doctor",
+  "config",
+  "hooks",
+  "help",
+  "version"
+];
 var HELP = `yourskills — install skills from your organization's registry
 
 Usage: yourskills <command> [options]
@@ -4815,9 +6407,9 @@ Commands:
   outdated                Report skills whose registry pin has moved
   doctor                  Check the server, the session, the agents, the manifest
   config get [key]        Show the stored settings, or one of them
-  config set <key> <val>  Set one: scope, agents, server, track
+  config set <key> <val>  Set one: scope, agents, server, track, autoUpdate
   hooks status            Show which agents carry our hooks, and where
-  hooks install           Register them: an update check, and usage if opted in
+  hooks install           Register them: the session update, and usage if opted in
   hooks uninstall         Remove ours, leaving every other hook alone
 
 Options:
@@ -4836,8 +6428,15 @@ Options:
 
 Environment:
   YOURSKILLS_URL          Registry base URL (default api.yourskills.store)
-  YOURSKILLS_NO_TRACK     Set to 1 to disable usage counting outright`;
-function configCommand(rest) {
+  YOURSKILLS_NO_TRACK     Set to 1 to disable usage counting outright
+  YOURSKILLS_DEBUG        Set to 1 to print the stack behind an error
+
+Exit codes:
+  0                       Done
+  1                       Something did not land: a failed install, a pending pull request
+  2                       The command line was wrong; the last line says the spelling
+  3                       Needs a session: run yourskills login`;
+function configCommand2(rest) {
   const [action, key, ...value] = rest;
   if (action === undefined || action === "get") {
     return { kind: "config", action: "get", ...key ? { key } : {} };
@@ -4862,7 +6461,7 @@ function configCommand(rest) {
   }
   return { kind: "config", action: "set", key, value: value.join(" ") };
 }
-function hooksCommand(rest, agent, track) {
+function hooksCommand2(rest, agent, track) {
   const action = rest[0] ?? "status";
   if (action !== "install" && action !== "uninstall" && action !== "status") {
     return {
@@ -4877,7 +6476,7 @@ function hooksCommand(rest, agent, track) {
     ...track === undefined ? {} : { track }
   };
 }
-function parseArgv(args, interactive = true) {
+function parseArgv2(args, interactive = true) {
   const opts = {};
   const positional = [];
   let plain = !interactive;
@@ -4928,7 +6527,11 @@ function parseArgv(args, interactive = true) {
         });
       opts.agents = [...opts.agents ?? [], value];
     } else if (arg.startsWith("-")) {
-      return done({ kind: "error", message: `Unknown option: ${arg}` });
+      return done({
+        kind: "error",
+        message: `unknown option ${arg}`,
+        next: "yourskills --help"
+      });
     } else {
       positional.push(arg);
     }
@@ -4980,9 +6583,9 @@ function parseArgv(args, interactive = true) {
     case "org":
       return done(rest[0] ? { kind: "org", name: rest[0] } : { kind: "org" });
     case "config":
-      return done(configCommand(rest));
+      return done(configCommand2(rest));
     case "hooks":
-      return done(hooksCommand(rest, opts.agents?.[0], track));
+      return done(hooksCommand2(rest, opts.agents?.[0], track));
     case "hook": {
       const event = rest[0];
       return done(event && isHookEventName(event) ? { kind: "hook", event } : {
@@ -5002,8 +6605,14 @@ function parseArgv(args, interactive = true) {
         ...all ? { all: true } : {},
         opts
       });
-    default:
-      return done({ kind: "error", message: `Unknown command: ${command}` });
+    default: {
+      const guess = closest(command, COMMAND_WORDS2);
+      return done({
+        kind: "error",
+        message: `unknown command ${command}`,
+        ...guess ? { why: `did you mean ${guess}?`, next: `yourskills ${guess}` } : { next: "yourskills --help" }
+      });
+    }
   }
 }
 
@@ -5021,9 +6630,9 @@ async function createClient2(server) {
 }
 
 // src/screens.tsx
-import { Box as Box11, Text as Text13, useApp as useApp8 } from "ink";
-import { useEffect as useEffect9, useState as useState9 } from "react";
-import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
+import { Box as Box15, Text as Text17, useApp as useApp8, useInput as useInput9 } from "ink";
+import { useEffect as useEffect10, useState as useState12 } from "react";
+import { jsx as jsx18, jsxs as jsxs17 } from "react/jsx-runtime";
 var HELP_COLUMN = 26;
 function WhoamiScreen({
   load,
@@ -5031,8 +6640,8 @@ function WhoamiScreen({
 }) {
   const { exit } = useApp8();
   const width = useFrameWidth();
-  const [who, setWho] = useState9(null);
-  useEffect9(() => {
+  const [who, setWho] = useState12(null);
+  useEffect10(() => {
     let live = true;
     load().then((result) => {
       if (!live)
@@ -5048,13 +6657,13 @@ function WhoamiScreen({
     };
   }, [load, exit, onError]);
   if (!who) {
-    return /* @__PURE__ */ jsx13(Frame, {
+    return /* @__PURE__ */ jsx18(Frame, {
       title: "whoami",
       width,
-      children: /* @__PURE__ */ jsxs12(Text13, {
+      children: /* @__PURE__ */ jsxs17(Text17, {
         children: [
-          /* @__PURE__ */ jsx13(Spinner, {}),
-          /* @__PURE__ */ jsx13(Text13, {
+          /* @__PURE__ */ jsx18(Spinner, {}),
+          /* @__PURE__ */ jsx18(Text17, {
             dimColor: true,
             children: " Checking session..."
           })
@@ -5062,44 +6671,44 @@ function WhoamiScreen({
       })
     });
   }
-  return /* @__PURE__ */ jsx13(Frame, {
+  return /* @__PURE__ */ jsx18(Frame, {
     title: "whoami",
     width,
-    children: /* @__PURE__ */ jsxs12(Box11, {
+    children: /* @__PURE__ */ jsxs17(Box15, {
       flexDirection: "column",
       children: [
-        /* @__PURE__ */ jsxs12(Text13, {
+        /* @__PURE__ */ jsxs17(Text17, {
           children: [
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               dimColor: true,
               children: "user    "
             }),
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               children: who.user
             })
           ]
         }),
-        /* @__PURE__ */ jsxs12(Text13, {
+        /* @__PURE__ */ jsxs17(Text17, {
           children: [
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               dimColor: true,
               children: "org     "
             }),
-            who.org ? /* @__PURE__ */ jsx13(Text13, {
+            who.org ? /* @__PURE__ */ jsx18(Text17, {
               children: who.org
-            }) : /* @__PURE__ */ jsx13(Text13, {
+            }) : /* @__PURE__ */ jsx18(Text17, {
               color: tone.notice,
               children: "none — set an active organization in the web UI"
             })
           ]
         }),
-        /* @__PURE__ */ jsxs12(Text13, {
+        /* @__PURE__ */ jsxs17(Text17, {
           children: [
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               dimColor: true,
               children: "server  "
             }),
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               color: tone.primary,
               children: who.server
             })
@@ -5115,17 +6724,17 @@ function NoticeScreen({
 }) {
   const { exit } = useApp8();
   const width = useFrameWidth();
-  useEffect9(exit, [exit]);
-  return /* @__PURE__ */ jsx13(Frame, {
+  useEffect10(exit, [exit]);
+  return /* @__PURE__ */ jsx18(Frame, {
     title,
     width,
-    children: /* @__PURE__ */ jsxs12(Text13, {
+    children: /* @__PURE__ */ jsxs17(Text17, {
       children: [
-        /* @__PURE__ */ jsx13(Text13, {
+        /* @__PURE__ */ jsx18(Text17, {
           color: "green",
           children: mark.ok
         }),
-        /* @__PURE__ */ jsx13(Text13, {
+        /* @__PURE__ */ jsx18(Text17, {
           children: ` ${message}`
         })
       ]
@@ -5142,16 +6751,16 @@ function ReportRow2({ line: line2, width }) {
   const { glyph, color } = MARKS2[line2.mark];
   const head = line2.mark === "none" ? "" : `${glyph} `;
   const room = width - FRAME_CHROME - head.length;
-  return /* @__PURE__ */ jsxs12(Text13, {
+  return /* @__PURE__ */ jsxs17(Text17, {
     children: [
-      head ? /* @__PURE__ */ jsx13(Text13, {
+      head ? /* @__PURE__ */ jsx18(Text17, {
         color,
         children: head
       }) : null,
-      /* @__PURE__ */ jsx13(Text13, {
+      /* @__PURE__ */ jsx18(Text17, {
         children: clip(line2.text, room)
       }),
-      line2.note ? /* @__PURE__ */ jsx13(Text13, {
+      line2.note ? /* @__PURE__ */ jsx18(Text17, {
         dimColor: true,
         children: clip(`  ${line2.note}`, Math.max(room - line2.text.length, 0))
       }) : null
@@ -5163,12 +6772,15 @@ function ReportScreen2({
   load,
   onError,
   onReport,
-  exitWhenDone = true
+  exitWhenDone = true,
+  onBack,
+  working = "Working...",
+  onNext
 }) {
   const { exit } = useApp8();
   const width = useFrameWidth();
-  const [report, setReport] = useState9(null);
-  useEffect9(() => {
+  const [report, setReport] = useState12(null);
+  useEffect10(() => {
     let live = true;
     load().then((result) => {
       if (!live)
@@ -5183,28 +6795,58 @@ function ReportScreen2({
       live = false;
     };
   }, [load, onError, onReport]);
-  useEffect9(() => {
+  useEffect10(() => {
     if (report && exitWhenDone)
       exit();
   }, [report, exit, exitWhenDone]);
-  return /* @__PURE__ */ jsx13(Frame, {
+  const next = report?.next;
+  useInput9((input) => {
+    if (input === "n" && next)
+      onNext?.(next.command);
+  }, { isActive: Boolean(onNext && next) });
+  return /* @__PURE__ */ jsxs17(Frame, {
     title,
     width,
-    children: report ? /* @__PURE__ */ jsx13(Box11, {
-      flexDirection: "column",
-      children: report.lines.map((line2) => /* @__PURE__ */ jsx13(ReportRow2, {
-        line: line2,
-        width
-      }, `${line2.mark}:${line2.text}`))
-    }) : /* @__PURE__ */ jsxs12(Text13, {
-      children: [
-        /* @__PURE__ */ jsx13(Spinner, {}),
-        /* @__PURE__ */ jsx13(Text13, {
-          dimColor: true,
-          children: " Working..."
-        })
-      ]
-    })
+    children: [
+      report ? /* @__PURE__ */ jsxs17(Box15, {
+        flexDirection: "column",
+        children: [
+          report.lines.map((line2) => /* @__PURE__ */ jsx18(ReportRow2, {
+            line: line2,
+            width
+          }, `${line2.mark}:${line2.text}`)),
+          next ? /* @__PURE__ */ jsxs17(Text17, {
+            children: [
+              /* @__PURE__ */ jsx18(Text17, {
+                dimColor: true,
+                children: "next  "
+              }),
+              /* @__PURE__ */ jsx18(Text17, {
+                color: tone.primary,
+                children: next.command
+              }),
+              /* @__PURE__ */ jsx18(Text17, {
+                dimColor: true,
+                children: clip(`  ${next.why}`, width - FRAME_CHROME)
+              })
+            ]
+          }) : null
+        ]
+      }) : /* @__PURE__ */ jsxs17(Text17, {
+        children: [
+          /* @__PURE__ */ jsx18(Spinner, {}),
+          /* @__PURE__ */ jsx18(Text17, {
+            dimColor: true,
+            children: ` ${working}`
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsx18(Back, {
+        width,
+        onBack,
+        extra: onNext && next ? [["n", "run next"]] : []
+      })
+    ]
   });
 }
 function numberedLines(text) {
@@ -5214,26 +6856,26 @@ function numberedLines(text) {
 function HelpScreen({ text }) {
   const { exit } = useApp8();
   const width = useFrameWidth();
-  useEffect9(exit, [exit]);
-  return /* @__PURE__ */ jsx13(Frame, {
+  useEffect10(exit, [exit]);
+  return /* @__PURE__ */ jsx18(Frame, {
     title: "yourskills",
     width,
-    children: /* @__PURE__ */ jsx13(Box11, {
+    children: /* @__PURE__ */ jsx18(Box15, {
       flexDirection: "column",
       children: numberedLines(text).map(({ id, line: line2 }) => {
         if (line2.length === 0)
-          return /* @__PURE__ */ jsx13(Blank, {}, id);
+          return /* @__PURE__ */ jsx18(Blank, {}, id);
         if (!line2.startsWith("  "))
-          return /* @__PURE__ */ jsx13(Text13, {
+          return /* @__PURE__ */ jsx18(Text17, {
             children: clip(line2, width - FRAME_CHROME)
           }, id);
-        return /* @__PURE__ */ jsxs12(Text13, {
+        return /* @__PURE__ */ jsxs17(Text17, {
           children: [
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               color: tone.primary,
               children: line2.slice(0, HELP_COLUMN)
             }),
-            /* @__PURE__ */ jsx13(Text13, {
+            /* @__PURE__ */ jsx18(Text17, {
               dimColor: true,
               children: clip(line2.slice(HELP_COLUMN), width - FRAME_CHROME - HELP_COLUMN)
             })
@@ -5246,7 +6888,7 @@ function HelpScreen({ text }) {
 // package.json
 var package_default = {
   name: "yourskills",
-  version: "0.1.2",
+  version: "0.1.3",
   description: "Browse, install and keep up to date the agent skills and bundles your team publishes on yourskills.",
   license: "UNLICENSED",
   homepage: "https://yourskills.store",
@@ -5303,7 +6945,7 @@ var package_default = {
 var VERSION = package_default.version ?? "0.0.0-dev";
 
 // src/main.tsx
-import { jsx as jsx14 } from "react/jsx-runtime";
+import { jsx as jsx19 } from "react/jsx-runtime";
 function applySummary(summary) {
   if (summary.pending.length > 0 || summary.failed > 0)
     process.exitCode = 1;
@@ -5314,7 +6956,7 @@ var PLAIN_MARKS = {
   pending: mark.pending,
   none: ""
 };
-function emit(report, output) {
+function emit2(report, output) {
   if (report.failed)
     process.exitCode = 1;
   if (output.json) {
@@ -5325,6 +6967,8 @@ function emit(report, output) {
     return;
   for (const line2 of report.lines)
     console.log(plainLine(line2, PLAIN_MARKS));
+  if (report.next)
+    console.log(nextLine(report.next));
 }
 function toRows(skills) {
   return skills.map((s) => ({
@@ -5354,15 +6998,6 @@ function catalogReport(title, skills) {
     json: { skills }
   };
 }
-async function resolveInstallOptions(opts) {
-  const { scope, manifestPath } = await resolveScope({ flag: opts.scope });
-  const path = scope === "project" && manifestPath ? manifestPath : manifestPathFor(scope);
-  return {
-    scope,
-    agents: await resolveAgents(opts.agents),
-    manifest: { path, scope }
-  };
-}
 var INVITES_HOOKS = new Set([
   "login",
   "add",
@@ -5388,22 +7023,6 @@ async function prepare(command) {
 function nearestFor(opts) {
   return nearestManifest(opts.scope);
 }
-function nothingTracked(nearest, kind, all = false) {
-  const has = kind === "install" ? Object.keys(nearest.manifest.skills).length > 0 : Object.keys(nearest.manifest.bundles).length > 0 || all && looseSkills(nearest.manifest).length > 0;
-  if (has)
-    return null;
-  return {
-    title: kind,
-    lines: [
-      {
-        mark: "none",
-        text: kind === "install" ? "Nothing recorded to install. Run `yourskills bundle <name>` first." : "No bundles tracked here. Run `yourskills bundle <name>` first.",
-        note: nearest.path
-      }
-    ],
-    json: { manifest: nearest.path, skills: [], bundles: [] }
-  };
-}
 async function runPlain(command, output, server) {
   switch (command.kind) {
     case "help":
@@ -5412,12 +7031,25 @@ async function runPlain(command, output, server) {
     case "version":
       console.log(VERSION);
       return;
+    case "error":
+      throw new CliError(command.message, {
+        ...command.why ? { why: command.why } : {},
+        ...command.next ? { next: command.next } : {},
+        code: EXIT.usage
+      });
     case "home":
     case "browse":
-    case "error":
-      throw new Error(command.kind === "error" ? command.message : `${command.kind === "home" ? "the palette" : "browse"} needs a terminal`);
+      throw new CliError(`${command.kind === "home" ? "the palette" : "browse"} needs a terminal`, {
+        why: "stdout is not a terminal, so there is nothing to draw the frame into",
+        next: "yourskills list, or yourskills search <query>",
+        code: EXIT.usage
+      });
     case "login":
-      throw new Error("login needs a terminal. Sign in on a machine that has one; the token is then copied from ~/.config/yourskills/config.json.");
+      throw new CliError("login needs a terminal", {
+        why: "the device code has to be read by a person",
+        next: "sign in on a machine with a terminal, then copy ~/.config/yourskills/config.json",
+        code: EXIT.usage
+      });
     case "logout":
       await logout();
       console.log("Logged out.");
@@ -5432,7 +7064,7 @@ async function runPlain(command, output, server) {
     case "search": {
       const client = await createClient2(server);
       const skills = command.kind === "list" ? await client.skills.list.query({}) : await client.skills.search.query({ q: command.query });
-      emit(catalogReport(command.kind === "list" ? "skills" : `search: ${command.query}`, skills), output);
+      emit2(catalogReport(command.kind === "list" ? "skills" : `search: ${command.query}`, skills), output);
       return;
     }
     case "add":
@@ -5445,7 +7077,7 @@ async function runPlain(command, output, server) {
       const nearest = await nearestFor(command.opts);
       const empty = nothingTracked(nearest, "install");
       if (empty) {
-        emit(empty, output);
+        emit2(empty, output);
         return;
       }
       applySummary(await installPlain(reinstall(nearest.manifest, command.opts)));
@@ -5459,7 +7091,7 @@ async function runPlain(command, output, server) {
       const nearest = await nearestFor(command.opts);
       const empty = nothingTracked(nearest, "update", command.all ?? false);
       if (empty) {
-        emit(empty, output);
+        emit2(empty, output);
         return;
       }
       applySummary(await installPlain(updateTracked(await createClient2(server), nearest.manifest, command.opts, command.all ?? false)));
@@ -5467,26 +7099,26 @@ async function runPlain(command, output, server) {
     }
     case "remove": {
       const nearest = await nearestFor(command.opts);
-      emit(await removeSkills(command.names, nearest.manifest, nearest.path, command.opts), output);
+      emit2(await removeSkills(command.names, nearest.manifest, nearest.path, command.opts), output);
       return;
     }
     case "installed":
-      emit(installedReport(await nearestManifest()), output);
+      emit2(installedReport(await nearestManifest()), output);
       return;
     case "outdated":
-      emit(await outdatedReport(await createClient2(server), await nearestManifest(), command.quiet ?? false), output);
+      emit2(await outdatedReport(await createClient2(server), await nearestManifest(), command.quiet ?? false), output);
       return;
     case "doctor":
-      emit(await doctorReport(await nearestManifest(), server), output);
+      emit2(await doctorReport(await nearestManifest(), server), output);
       return;
     case "org":
-      emit(command.name ? await orgSwitchReport(command.name, server) : await orgListReport(server), output);
+      emit2(command.name ? await orgSwitchReport(command.name, server) : await orgListReport(server), output);
       return;
     case "config":
-      emit(command.action === "get" ? await configGet(command.key) : await configSet(command.key, command.value), output);
+      emit2(command.action === "get" ? await configGet(command.key) : await configSet(command.key, command.value), output);
       return;
     case "hooks":
-      emit(await hooksReport(command), output);
+      emit2(await hooksReport(command), output);
       return;
     case "hook":
       await runHook(command.event);
@@ -5504,13 +7136,13 @@ function hooksReport(command) {
   return hooksStatus();
 }
 async function screenFor(command, fail, summarise, report, server) {
-  const gate = (title, build) => /* @__PURE__ */ jsx14(AuthGate, {
+  const gate = (title, build) => /* @__PURE__ */ jsx19(AuthGate, {
     title,
     build,
     connect: () => createClient2(server),
     onError: fail
   });
-  const local = (title, load) => /* @__PURE__ */ jsx14(ReportScreen2, {
+  const local = (title, load) => /* @__PURE__ */ jsx19(ReportScreen2, {
     title,
     load,
     onError: fail,
@@ -5518,40 +7150,44 @@ async function screenFor(command, fail, summarise, report, server) {
   });
   switch (command.kind) {
     case "help":
-      return /* @__PURE__ */ jsx14(HelpScreen, {
+      return /* @__PURE__ */ jsx19(HelpScreen, {
         text: HELP
       });
     case "version":
-      return /* @__PURE__ */ jsx14(NoticeScreen, {
+      return /* @__PURE__ */ jsx19(NoticeScreen, {
         title: "version",
         message: VERSION
       });
     case "error":
-      throw new Error(command.message);
+      throw new CliError(command.message, {
+        ...command.why ? { why: command.why } : {},
+        ...command.next ? { next: command.next } : {},
+        code: EXIT.usage
+      });
     case "login":
-      return /* @__PURE__ */ jsx14(LoginScreen, {
+      return /* @__PURE__ */ jsx19(LoginScreen, {
         onError: fail
       });
     case "logout":
       await logout();
-      return /* @__PURE__ */ jsx14(NoticeScreen, {
+      return /* @__PURE__ */ jsx19(NoticeScreen, {
         title: "logout",
         message: "Logged out."
       });
     case "whoami":
-      return gate("whoami", () => /* @__PURE__ */ jsx14(WhoamiScreen, {
+      return gate("whoami", () => /* @__PURE__ */ jsx19(WhoamiScreen, {
         load: () => whoami(server),
         onError: fail
       }));
     case "list":
-      return gate("skills", (client) => /* @__PURE__ */ jsx14(CatalogScreen, {
+      return gate("skills", (client) => /* @__PURE__ */ jsx19(CatalogScreen, {
         title: "skills",
         load: async () => toRows(await client.skills.list.query({})),
         onError: fail
       }));
     case "search": {
       const q = command.query;
-      return gate(`search: ${q}`, (client) => /* @__PURE__ */ jsx14(CatalogScreen, {
+      return gate(`search: ${q}`, (client) => /* @__PURE__ */ jsx19(CatalogScreen, {
         title: `search: ${q}`,
         load: async () => toRows(await client.skills.search.query({ q })),
         onError: fail
@@ -5559,17 +7195,27 @@ async function screenFor(command, fail, summarise, report, server) {
     }
     case "home": {
       const opts = await resolveInstallOptions({});
-      return /* @__PURE__ */ jsx14(HomeScreen, {
+      const reload = () => paletteFacts(opts.scope, server);
+      return /* @__PURE__ */ jsx19(HomeScreen, {
         opts,
+        facts: await reload(),
+        reload,
         server,
         openClient: () => createClient2(server),
         onError: fail,
-        onSummary: summarise
+        onSummary: summarise,
+        onWelcomed: async () => {
+          const config = await readConfig();
+          await writeConfig({
+            ...config,
+            welcomed: new Date().toISOString()
+          });
+        }
       });
     }
     case "browse": {
       const opts = await resolveInstallOptions({});
-      return gate("browse", (client) => /* @__PURE__ */ jsx14(BrowserScreen, {
+      return gate("browse", (client) => /* @__PURE__ */ jsx19(BrowserScreen, {
         client,
         opts,
         onError: fail,
@@ -5577,13 +7223,13 @@ async function screenFor(command, fail, summarise, report, server) {
       }));
     }
     case "add":
-      return gate("add", (client) => /* @__PURE__ */ jsx14(Installer, {
+      return gate("add", (client) => /* @__PURE__ */ jsx19(Installer, {
         title: "add",
         stream: () => install(client, command.names, command.opts),
         onDone: summarise
       }));
     case "bundle":
-      return gate(`bundle: ${command.name}`, (client) => /* @__PURE__ */ jsx14(Installer, {
+      return gate(`bundle: ${command.name}`, (client) => /* @__PURE__ */ jsx19(Installer, {
         title: `bundle: ${command.name}`,
         stream: () => installBundle(client, command.name, command.opts),
         onDone: summarise
@@ -5593,7 +7239,7 @@ async function screenFor(command, fail, summarise, report, server) {
       const empty = nothingTracked(nearest, "install");
       if (empty)
         return local("install", async () => empty);
-      return /* @__PURE__ */ jsx14(Installer, {
+      return /* @__PURE__ */ jsx19(Installer, {
         title: "install",
         stream: () => reinstall(nearest.manifest, command.opts),
         onDone: summarise
@@ -5602,7 +7248,7 @@ async function screenFor(command, fail, summarise, report, server) {
     case "update": {
       if (command.bundle) {
         const name = command.bundle;
-        return gate(`update: ${name}`, (client) => /* @__PURE__ */ jsx14(Installer, {
+        return gate(`update: ${name}`, (client) => /* @__PURE__ */ jsx19(Installer, {
           title: `update: ${name}`,
           stream: () => update(client, name, command.opts),
           onDone: summarise
@@ -5612,8 +7258,10 @@ async function screenFor(command, fail, summarise, report, server) {
       const empty = nothingTracked(nearest, "update", command.all ?? false);
       if (empty)
         return local("update", async () => empty);
-      return gate("update", (client) => /* @__PURE__ */ jsx14(Installer, {
+      const scope = updateScope(Object.keys(nearest.manifest.bundles).length, command.all ? looseSkills(nearest.manifest).length : 0);
+      return gate("update", (client) => /* @__PURE__ */ jsx19(Installer, {
         title: "update",
+        plan: `updating ${scope} to what the registry blesses today`,
         stream: () => updateTracked(client, nearest.manifest, command.opts, command.all ?? false),
         onDone: summarise
       }));
@@ -5633,14 +7281,15 @@ async function screenFor(command, fail, summarise, report, server) {
     case "hook":
       throw new Error("hooks are not interactive");
     case "outdated":
-      return gate("outdated", (client) => /* @__PURE__ */ jsx14(ReportScreen2, {
+      return gate("outdated", (client) => /* @__PURE__ */ jsx19(ReportScreen2, {
         title: "outdated",
+        working: "Checking what you have installed against the registry...",
         load: async () => outdatedReport(client, await nearestManifest(), command.quiet),
         onError: fail,
         onReport: report
       }));
     case "org":
-      return gate("org", () => /* @__PURE__ */ jsx14(ReportScreen2, {
+      return gate("org", () => /* @__PURE__ */ jsx19(ReportScreen2, {
         title: "org",
         load: () => command.name ? orgSwitchReport(command.name, server) : orgListReport(server),
         onError: fail,
@@ -5674,7 +7323,7 @@ function isEntrypoint() {
 }
 if (isEntrypoint()) {
   const interactive = Boolean(process.stdout.isTTY);
-  const parsed = parseArgv(process.argv.slice(2), interactive);
+  const parsed = parseArgv2(process.argv.slice(2), interactive);
   const { output, server } = parsed;
   try {
     const command = await prepare(parsed.command);
@@ -5688,7 +7337,13 @@ if (isEntrypoint()) {
           console.log(line2);
     }
   } catch (error) {
-    console.error(`error: ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
+    const { lines, code } = describeError(error);
+    const [what, ...rest] = lines;
+    console.error(`${mark.fail} ${what}`);
+    for (const line2 of rest)
+      console.error(line2);
+    if (process.env.YOURSKILLS_DEBUG === "1" && error instanceof Error)
+      console.error(error.stack);
+    process.exit(code);
   }
 }