@workser/cli 0.2.6 → 0.2.7

package/dist/index.js

@@ -4404,6 +4404,73 @@ workser storage get <key> [dest]    # download an object (or print its URL)
 infrastructure on the project's own Neon branch, available only on dedicated tenancy
 in a supported region. They are different stores \u2014 a file put in one is not visible
 in the other. See \`reference/neon-backend.md\`.
+`
+  },
+  {
+    topic: "version-control",
+    title: "Saving, undoing & syncing your work",
+    summary: "Checkpoint before risky edits, restore when they go wrong, sync with Workser.",
+    commands: ["checkpoint", "restore", "sync"],
+    source: "skills/workser/reference/version-control.md",
+    body: `# Saving, undoing & syncing your work
+
+\`\`\`
+workser checkpoint ["what you're about to try"]  # save the folder as it stands now
+workser restore                                  # go back to the newest checkpoint
+workser restore --list                           # see the checkpoints you can go back to
+workser restore <ref>                            # go back to a specific one
+workser sync [--branch dev] [--app <id>]         # reconcile this folder with Workser
+\`\`\`
+
+## Why these exist instead of git
+
+This folder is a git repository, but **the history is Workser's**. There is no
+remote: code moves to and from Workser over its API as git bundles, using the
+same session everything else here uses. No credential is read, and the user's
+own git keys and identity are never touched.
+
+That is what makes any of this work on a computer with no access to the
+Workser-managed repository \u2014 which is every computer. Nobody has repo access;
+the API does.
+
+So the ordinary git verbs are wrong here, and these three replace them:
+
+| Instead of | Run |
+|---|---|
+| \`git stash\` | \`workser checkpoint\` |
+| \`git commit\` | \`workser checkpoint\` |
+| \`git reset --hard\` / \`git checkout .\` | \`workser restore\` |
+| \`git pull\` / \`git push\` | \`workser sync\` |
+
+Reading is always fine: \`git log\`, \`git diff\`, \`git show\`, \`git status\`.
+
+## Notes that matter
+
+- **Checkpoint before anything you might want to take back** \u2014 a refactor across
+  many files, a dependency upgrade, deleting something large. It costs a second.
+- **\`git stash\` is the one that actually loses work.** Workser publishes what is
+  on disk, so a deploy while your changes are stashed ships the version *without
+  them* \u2014 and if the run is stopped between \`stash\` and \`stash pop\`, the user
+  opens their folder and their work is gone. \`workser checkpoint\` has neither
+  failure mode.
+- **Restoring never discards anything.** The current state is saved first, then
+  the older state is restored on top. If you restore the wrong thing, restore
+  again. Say this to the user \u2014 it is the reason they can afford to say yes.
+- **These are the same checkpoints as the app's Undo button.** One history, not
+  two: a checkpoint you take here appears in Workser, and vice versa.
+- **\`sync\` pulls before it pushes.** If it reports \`diverged\`, both sides changed
+  and it stops rather than picking a winner \u2014 tell the user to resolve it in
+  Workser instead of forcing it.
+- **These three need the Workser app running on this computer**, because they
+  work with files. If you get \`needs_local_app\`, you are on a machine that only
+  has the CLI and a token \u2014 say so rather than looking for a workaround. Every
+  read-only command (\`projects\`, \`env\`, \`db\`, \`logs\`, \`status\`) still works.
+
+## Shipping is separate
+
+\`workser sync\` reconciles the folder. \`workser deploy\` puts it in front of
+users. Syncing does not deploy, and deploying does not require you to sync
+first \u2014 deploy publishes what is on disk. See \`reference/deploy.md\`.
 `
   }
 ];
@@ -4570,6 +4637,21 @@ function buildContext(opts) {
 function runTarget(ctx) {
   return ctx.runId || "current";
 }
+function requireLocalApp(ctx, what) {
+  if (ctx.mode === "daemon") return;
+  throw new WorkserError(
+    `\`workser ${what}\` works with the code in this folder, so it needs the Workser app running on this computer.
+
+This shell is talking to ${ctx.endpoint} instead of a local app.
+
+  \u2022 On your own computer: open Workser and try again.
+  \u2022 On a computer without Workser: install it from https://workser.ai/download,
+    sign in, and open this project \u2014 that is what puts the code here.
+
+Commands that only read your account (projects, env, db, logs, status) work as normal.`,
+    { code: "needs_local_app" }
+  );
+}
 function requireProject(ctx) {
   if (!ctx.projectId) {
     throw new WorkserError(
@@ -5521,6 +5603,7 @@ function registerDeploy(program3) {
     "which app to publish (default: the app this folder is linked to)"
   ).action(
     action(async ({ ctx, opts }) => {
+      requireLocalApp(ctx, "deploy");
       const projectId = requireProject(ctx);
       const dep = await api(ctx, `/v1/projects/${projectId}/deploy`, {
         body: {
@@ -5675,6 +5758,7 @@ function openUrl(url) {
 
 // src/commands/doctor.ts
 var import_picocolors13 = __toESM(require_picocolors(), 1);
+import { spawnSync } from "child_process";
 function registerDoctor(program3) {
   program3.command("doctor").description("Print the resolved endpoint, mode, token presence (masked), and current project").action(
     action(({ ctx, opts }) => {
@@ -5685,12 +5769,14 @@ function registerDoctor(program3) {
       const tokenSource = opts.token ? "--token" : process.env.WORKSER_TOKEN ? "$WORKSER_TOKEN" : session.token ? "session" : void 0;
       const endpointSource = opts.endpoint ? "--endpoint" : process.env.WORKSER_DAEMON_URL ? "$WORKSER_DAEMON_URL" : session.endpoint ? "session" : process.env.WORKSER_API_URL ? "$WORKSER_API_URL" : `cloud-default: ${env}`;
       const projectSource = opts.project ? "--project" : link?.projectId ? ".workser link" : session.defaultProjectId ? "session" : void 0;
+      const git = gitVersion();
       const report = {
         endpoint: ctx.endpoint,
         endpointSource,
         env,
         envIgnored,
         mode: ctx.mode,
+        git: { present: git !== null, version: git },
         token: {
           present: Boolean(ctx.token),
           masked: ctx.token ? maskToken(ctx.token) : null,
@@ -5718,6 +5804,20 @@ function registerDoctor(program3) {
           `  project:   ${ctx.projectId ?? import_picocolors13.default.dim("none")}` + (link?.name ? `  ${import_picocolors13.default.dim(`(${link.name})`)}` : "") + (projectSource ? import_picocolors13.default.dim(`  [${projectSource}]`) : "")
         );
         line(`  cwd:       ${ctx.cwd}`);
+        line(`  git:       ${git ?? import_picocolors13.default.dim("not on this shell's PATH")}`);
+        if (!git) {
+          line("");
+          line(
+            import_picocolors13.default.dim(
+              "  Workser brings its own git, so syncing and publishing still work."
+            )
+          );
+          line(
+            import_picocolors13.default.dim(
+              `  Only needed if you want to run git yourself here. ${GIT_INSTALL_HINT}`
+            )
+          );
+        }
         if (envIgnored) {
           line("");
           line(
@@ -5736,6 +5836,24 @@ function registerDoctor(program3) {
     })
   );
 }
+function gitVersion() {
+  try {
+    const res = spawnSync("git", ["--version"], {
+      encoding: "utf8",
+      timeout: 5e3,
+      // A macOS box with no Command Line Tools has a `git` SHIM that pops a GUI
+      // installer when run. Inheriting stdio would surface that dialog from a
+      // command the user expects to just print a report.
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    if (res.error || res.status !== 0) return null;
+    const out = (res.stdout || "").toString().trim();
+    return out || null;
+  } catch {
+    return null;
+  }
+}
+var GIT_INSTALL_HINT = process.platform === "darwin" ? "Install it with: xcode-select --install" : process.platform === "win32" ? "Install it from: https://git-scm.com/download/win" : "Install it with your package manager, e.g. apt install git";
 function maskToken(token) {
   if (token.length <= 8) return "\u2022".repeat(token.length);
   return `${token.slice(0, 3)}${"\u2022".repeat(Math.min(token.length - 6, 12))}${token.slice(-3)}`;
@@ -5863,6 +5981,7 @@ function registerVerify(program3) {
     "comma-separated subset, e.g. --only typecheck,build"
   ).action(
     action(async ({ ctx, opts }) => {
+      requireLocalApp(ctx, "verify");
       const only = opts.only ? String(opts.only).split(",").map((s) => s.trim()).filter(Boolean) : void 0;
       const res = await api(ctx, `/v1/verify`, {
         body: { cwd: ctx.cwd, ...only ? { only } : {} }
@@ -5890,8 +6009,139 @@ function printVerify(res) {
     );
 }
 
-// src/commands/workflow.ts
+// src/commands/checkpoint.ts
 var import_picocolors16 = __toESM(require_picocolors(), 1);
+function registerCheckpoint(program3) {
+  program3.command("checkpoint [label]").description(
+    "Save the current state of this folder so you can come back to it"
+  ).addHelpText(
+    "after",
+    "\nUse this before a risky change. To come back: `workser restore`.\nNever use `git stash` or `git commit` here \u2014 Workser owns this history.\n"
+  ).action(
+    action(async ({ ctx, args }) => {
+      requireLocalApp(ctx, "checkpoint");
+      const label = typeof args[0] === "string" ? args[0] : "";
+      const res = await api(ctx, `/v1/checkpoints`, {
+        body: { cwd: ctx.cwd, ...label ? { label } : {} }
+      });
+      ok(res, () => {
+        const p = res?.point;
+        success(`Saved a checkpoint${p?.label ? `: ${p.label}` : ""}`);
+        if (p?.ref) line(import_picocolors16.default.dim(`  ${p.ref.slice(0, 7)}`));
+        line(import_picocolors16.default.dim("  Come back to it with `workser restore`."));
+      });
+    })
+  );
+  const restore = program3.command("restore [ref]").description(
+    "Put this folder back to a saved checkpoint (default: the most recent)"
+  ).option("--list", "show the checkpoints you can go back to", false).action(
+    action(async ({ ctx, args, opts }) => {
+      requireLocalApp(ctx, "restore");
+      if (opts.list) {
+        const res2 = await api(ctx, `/v1/checkpoints`, {
+          query: { cwd: ctx.cwd }
+        });
+        const points = res2?.points ?? [];
+        return ok(res2, () => printPoints(points));
+      }
+      const ref = typeof args[0] === "string" ? args[0].trim() : "";
+      const res = await api(ctx, `/v1/undo`, {
+        body: { cwd: ctx.cwd, ...ref ? { ref } : {} }
+      });
+      ok(res, () => {
+        success(
+          `Put the folder back${res?.restoredTo ? ` to ${String(res.restoredTo).slice(0, 7)}` : ""}`
+        );
+        if (res?.filesChanged) {
+          line(
+            import_picocolors16.default.dim(
+              `  ${res.filesChanged} file${res.filesChanged === 1 ? "" : "s"} changed`
+            )
+          );
+        }
+        line(import_picocolors16.default.dim("  This is reversible: `workser restore` again."));
+      });
+    })
+  );
+  restore.command("list").description("Show the checkpoints you can go back to").action(
+    action(async ({ ctx }) => {
+      requireLocalApp(ctx, "restore list");
+      const res = await api(ctx, `/v1/checkpoints`, {
+        query: { cwd: ctx.cwd }
+      });
+      ok(res, () => printPoints(res?.points ?? []));
+    })
+  );
+}
+function printPoints(points) {
+  if (!points.length) {
+    info("No checkpoints yet for this folder.");
+    line(import_picocolors16.default.dim("  Take one with `workser checkpoint`."));
+    return;
+  }
+  line(import_picocolors16.default.bold("Checkpoints"));
+  for (const p of points) {
+    const when = p.at ? new Date(p.at).toLocaleString() : "";
+    line(
+      `  ${import_picocolors16.default.dim(p.ref.slice(0, 7))}  ${p.label}${when ? import_picocolors16.default.dim(`  ${when}`) : ""}`
+    );
+  }
+  line(
+    import_picocolors16.default.dim(
+      "\nGo back with `workser restore <ref>`, or just `workser restore` for the newest."
+    )
+  );
+}
+
+// src/commands/sync.ts
+var import_picocolors17 = __toESM(require_picocolors(), 1);
+function registerSync(program3) {
+  program3.command("sync").description(
+    "Reconcile this folder with the copy Workser holds (pull, then push)"
+  ).option("--branch <name>", "which branch to sync (default: this folder's)").option(
+    "--app <webAppId>",
+    "which app's code this folder holds (default: resolved from the folder)"
+  ).addHelpText(
+    "after",
+    "\nUse this instead of `git pull` / `git push` \u2014 this folder has no remote.\n"
+  ).action(
+    action(async ({ ctx, opts }) => {
+      requireLocalApp(ctx, "sync");
+      const projectId = requireProject(ctx);
+      const res = await api(ctx, `/v1/projects/${projectId}/git/sync`, {
+        body: {
+          cwd: ctx.cwd,
+          ...opts.branch ? { branch: opts.branch } : {},
+          ...opts.app ? { webAppId: opts.app } : {}
+        }
+      });
+      const refused = res?.ok === false || res?.state === "diverged";
+      ok(res, () => {
+        if (refused) {
+          warn(res?.message ?? "Couldn't sync this folder.");
+          if (res?.state === "diverged") {
+            line(
+              import_picocolors17.default.dim(
+                "  This folder and Workser's copy have both changed. Open Workser to resolve it."
+              )
+            );
+          }
+          return;
+        }
+        if (res?.state === "empty") {
+          line("Nothing to sync yet \u2014 there's no code here or on Workser.");
+          return;
+        }
+        success("Synced");
+        if (res?.ref) line(import_picocolors17.default.dim(`  ${String(res.ref).slice(0, 7)}`));
+      });
+      if (refused) process.exitCode = 1;
+    })
+  );
+}
+
+// src/commands/workflow.ts
+var import_picocolors18 = __toESM(require_picocolors(), 1);
 function registerWorkflow(program3) {
   const wf = program3.command("workflow").description("Create, run, and inspect workflow automations for the project");
   wf.command("list").description("List the project's workflows").action(
@@ -5899,10 +6149,10 @@ function registerWorkflow(program3) {
       const projectId = requireProject(ctx);
       const items = await api(ctx, `/v1/projects/${projectId}/workflows`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors16.default.dim("No workflows yet. `workser workflow create`."));
+        if (!items?.length) return line(import_picocolors18.default.dim("No workflows yet. `workser workflow create`."));
         for (const w of items) {
-          const status = w.is_active ? import_picocolors16.default.green("active") : import_picocolors16.default.dim("inactive");
-          line(`${w.id}  ${import_picocolors16.default.bold(w.name ?? "Untitled")}  ${status}`);
+          const status = w.is_active ? import_picocolors18.default.green("active") : import_picocolors18.default.dim("inactive");
+          line(`${w.id}  ${import_picocolors18.default.bold(w.name ?? "Untitled")}  ${status}`);
         }
       });
     })
@@ -5914,7 +6164,7 @@ function registerWorkflow(program3) {
       const res = await api(ctx, `/v1/projects/${projectId}/workflows`, {
         body: { name: args[0], ...extra }
       });
-      ok(res, () => line(`Created workflow ${import_picocolors16.default.bold(res.id)}.`));
+      ok(res, () => line(`Created workflow ${import_picocolors18.default.bold(res.id)}.`));
     })
   );
   wf.command("get <id>").description("Show a workflow's full definition").action(
@@ -5949,8 +6199,8 @@ function registerWorkflow(program3) {
     action(async ({ ctx, args }) => {
       const items = await api(ctx, `/v1/workflows/${args[0]}/executions`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors16.default.dim("No runs yet."));
-        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors16.default.dim(e.started_at ?? "")}`);
+        if (!items?.length) return line(import_picocolors18.default.dim("No runs yet."));
+        for (const e of items) line(`${e.id}  ${e.status ?? ""}  ${import_picocolors18.default.dim(e.started_at ?? "")}`);
       });
     })
   );
@@ -5958,15 +6208,15 @@ function registerWorkflow(program3) {
     action(async ({ ctx, args }) => {
       const items = await api(ctx, `/v1/node-types`, { query: { q: args[0] } });
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors16.default.dim("No matching node types."));
-        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors16.default.dim(n.category ?? "")}`);
+        if (!items?.length) return line(import_picocolors18.default.dim("No matching node types."));
+        for (const n of items) line(`${n.name ?? n.type}  ${import_picocolors18.default.dim(n.category ?? "")}`);
       });
     })
   );
 }
 
 // src/commands/app.ts
-var import_picocolors17 = __toESM(require_picocolors(), 1);
+var import_picocolors19 = __toESM(require_picocolors(), 1);
 function registerApp(program3) {
   const appCmd = program3.command("app").description("Connect and use third-party app integrations (Gmail, Slack, Stripe, ...)");
   appCmd.command("list").description("List connectable toolkits and this project's existing connections").option("--toolkit <slug>", "filter connections to one toolkit").action(
@@ -5979,8 +6229,8 @@ function registerApp(program3) {
       ok({ catalog, connections }, () => {
         const connected = new Set((connections ?? []).map((c) => c.toolkit ?? c.composio_app));
         for (const t of catalog ?? []) {
-          const status = connected.has(t.slug) ? import_picocolors17.default.green("connected") : import_picocolors17.default.dim("not connected");
-          line(`${t.slug}  ${import_picocolors17.default.bold(t.name ?? t.slug)}  ${status}`);
+          const status = connected.has(t.slug) ? import_picocolors19.default.green("connected") : import_picocolors19.default.dim("not connected");
+          line(`${t.slug}  ${import_picocolors19.default.bold(t.name ?? t.slug)}  ${status}`);
         }
       });
     })
@@ -5997,7 +6247,7 @@ function registerApp(program3) {
       });
       ok(
         res,
-        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors17.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
+        () => res.oauth_url ? line(`Open this URL to finish connecting: ${import_picocolors19.default.underline(res.oauth_url)}`) : line(`Connection ${res.connection_id} is ${res.status}.`)
       );
     })
   );
@@ -6015,8 +6265,8 @@ function registerApp(program3) {
       const projectId = requireProject(ctx);
       const items = await api(ctx, `/v1/projects/${projectId}/integrations/${args[0]}/tools`);
       ok(items, () => {
-        if (!items?.length) return line(import_picocolors17.default.dim("No tools found."));
-        for (const t of items) line(`${t.slug}  ${import_picocolors17.default.dim(t.description ?? "")}`);
+        if (!items?.length) return line(import_picocolors19.default.dim("No tools found."));
+        for (const t of items) line(`${t.slug}  ${import_picocolors19.default.dim(t.description ?? "")}`);
       });
     })
   );
@@ -6032,7 +6282,7 @@ function registerApp(program3) {
 }
 
 // src/commands/tool.ts
-var import_picocolors18 = __toESM(require_picocolors(), 1);
+var import_picocolors20 = __toESM(require_picocolors(), 1);
 function registerTool(program3) {
   const tool = program3.command("tool").description(
     "Computer-use tools: filesystem, shell, screenshot, input control, clipboard, notifications, basic browser"
@@ -6041,7 +6291,7 @@ function registerTool(program3) {
     action(async ({ ctx }) => {
       const tools = await api(ctx, "/v1/tool/list");
       ok(tools, () => {
-        if (!tools?.length) return line(import_picocolors18.default.dim("No tools available."));
+        if (!tools?.length) return line(import_picocolors20.default.dim("No tools available."));
         const byCategory = /* @__PURE__ */ new Map();
         for (const t of tools) {
           const list = byCategory.get(t.category) ?? [];
@@ -6049,9 +6299,9 @@ function registerTool(program3) {
           byCategory.set(t.category, list);
         }
         for (const [category, items] of byCategory) {
-          line(import_picocolors18.default.bold(category) + ":");
+          line(import_picocolors20.default.bold(category) + ":");
           for (const t of items) {
-            line(`  ${t.name}  ${import_picocolors18.default.dim(t.description ?? "")}`);
+            line(`  ${t.name}  ${import_picocolors20.default.dim(t.description ?? "")}`);
           }
         }
       });
@@ -6069,7 +6319,7 @@ function registerTool(program3) {
 }
 
 // src/commands/memory.ts
-var import_picocolors19 = __toESM(require_picocolors(), 1);
+var import_picocolors21 = __toESM(require_picocolors(), 1);
 function registerMemory(program3) {
   const memory = program3.command("memory").description("Durable, cross-conversation project memory (shared with cloud agents on the same project)");
   memory.command("add <content>").description("Store something worth remembering across future conversations").option("--metadata <json>", "extra metadata for filtering, as a JSON string").option("--id <customId>", "custom id for dedup/updates").action(
@@ -6093,9 +6343,9 @@ function registerMemory(program3) {
       });
       ok(res, () => {
         const results = res?.results ?? res ?? [];
-        if (!results?.length) return line(import_picocolors19.default.dim("No matching memories."));
+        if (!results?.length) return line(import_picocolors21.default.dim("No matching memories."));
         for (const r of results) {
-          line(`${import_picocolors19.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
+          line(`${import_picocolors21.default.dim(r.id ?? "?")}  ${r.memory ?? r.content ?? ""}`);
         }
       });
     })
@@ -6112,7 +6362,7 @@ function registerMemory(program3) {
 }
 
 // src/commands/business.ts
-var import_picocolors20 = __toESM(require_picocolors(), 1);
+var import_picocolors22 = __toESM(require_picocolors(), 1);
 var RESOURCE_PATHS = {
   "business-config": "business-config",
   "business-settings": "business-settings",
@@ -6172,7 +6422,7 @@ function registerBusiness(program3) {
       const projectId = requireProject(ctx);
       const [resource] = args;
       const res = await api(ctx, businessPath(projectId, resource), { body: JSON.parse(opts.body) });
-      ok(res, () => line(`Created ${resource} ${import_picocolors20.default.bold(res?.id ?? "")}.`));
+      ok(res, () => line(`Created ${resource} ${import_picocolors22.default.bold(res?.id ?? "")}.`));
     })
   );
   biz.command("update <resource> <id>").description("Update a record by id (PATCH/PUT \u2014 matches the underlying route)").option("--body <json>", "changed fields as a JSON object string", "{}").action(
@@ -6214,7 +6464,7 @@ function businessPath(projectId, resource, subpath) {
 }
 
 // src/commands/artifact.ts
-var import_picocolors21 = __toESM(require_picocolors(), 1);
+var import_picocolors23 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync2, statSync } from "fs";
 import { resolve as resolve2, basename as basename3 } from "path";
 var KINDS = [
@@ -6280,7 +6530,7 @@ function registerArtifact(program3) {
       ok(
         res,
         () => success(
-          `Recorded ${import_picocolors21.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors21.default.dim(` (${res.kind})`) : ""}`
+          `Recorded ${import_picocolors23.default.bold(res?.title ?? "artifact")}${res?.kind ? import_picocolors23.default.dim(` (${res.kind})`) : ""}`
         )
       );
     })
@@ -6294,11 +6544,11 @@ function registerArtifact(program3) {
 }
 function printRun(run) {
   if (!run) return;
-  line(`  run      ${import_picocolors21.default.bold(run.runId)}`);
+  line(`  run      ${import_picocolors23.default.bold(run.runId)}`);
   if (run.taskId) line(`  task     ${run.taskId}`);
   if (run.conversationId) line(`  chat     ${run.conversationId}`);
   if (run.projectId) line(`  project  ${run.projectId}`);
-  if (run.cwd) line(`  folder   ${import_picocolors21.default.dim(run.cwd)}`);
+  if (run.cwd) line(`  folder   ${import_picocolors23.default.dim(run.cwd)}`);
 }
 
 // src/commands/image.ts
@@ -6372,7 +6622,7 @@ async function download(url, output) {
 }
 
 // src/commands/ask.ts
-var import_picocolors22 = __toESM(require_picocolors(), 1);
+var import_picocolors24 = __toESM(require_picocolors(), 1);
 var TYPES = [
   "input",
   "choice",
@@ -6423,7 +6673,7 @@ function registerAsk(program3) {
           code: "bad_request"
         });
       }
-      info(import_picocolors22.default.dim("Waiting for the user to answer\u2026"));
+      info(import_picocolors24.default.dim("Waiting for the user to answer\u2026"));
       const res = await api(ctx, `/v1/runs/${runTarget(ctx)}/ask`, {
         body: {
           type,
@@ -6449,12 +6699,12 @@ function deriveTitle(message) {
 function printAnswer(res) {
   if (!res) return;
   if (res.status === "answered") {
-    line(`  ${import_picocolors22.default.green("answered")}`);
+    line(`  ${import_picocolors24.default.green("answered")}`);
     const value = extract(res.response);
     if (value) line(`  ${value}`);
     return;
   }
-  line(`  ${import_picocolors22.default.yellow(res.status)}  ${import_picocolors22.default.dim(res.reason ?? "")}`);
+  line(`  ${import_picocolors24.default.yellow(res.status)}  ${import_picocolors24.default.dim(res.reason ?? "")}`);
 }
 function extract(response) {
   if (response == null) return "";
@@ -6473,7 +6723,7 @@ function extract(response) {
 }
 
 // src/commands/search.ts
-var import_picocolors23 = __toESM(require_picocolors(), 1);
+var import_picocolors25 = __toESM(require_picocolors(), 1);
 function registerSearch(program3) {
   program3.command("search <query>").description("Search the web (Google-grounded, server-side)").option("-n, --max-results <n>", "max results", "5").action(
     action(async ({ ctx, args, opts }) => {
@@ -6486,9 +6736,9 @@ function registerSearch(program3) {
           line("");
         }
         const results = res?.results ?? [];
-        if (!results.length) return line(import_picocolors23.default.dim("No results."));
+        if (!results.length) return line(import_picocolors25.default.dim("No results."));
         for (const r of results) {
-          line(`${r.title || import_picocolors23.default.dim("(untitled)")}  ${import_picocolors23.default.dim(r.url)}`);
+          line(`${r.title || import_picocolors25.default.dim("(untitled)")}  ${import_picocolors25.default.dim(r.url)}`);
         }
       });
     })
@@ -6496,7 +6746,7 @@ function registerSearch(program3) {
 }
 
 // src/commands/board.ts
-var import_picocolors24 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 
 // src/commands/record-step.ts
 async function recordEntityStep(ctx, opts) {
@@ -6535,7 +6785,7 @@ function registerBoard(program3) {
       }
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors24.default.dim("No cards on the Board yet."));
+          line(import_picocolors26.default.dim("No cards on the Board yet."));
           return;
         }
         for (const r of rows) line(formatRow(r));
@@ -6550,7 +6800,7 @@ function registerBoard(program3) {
         `/v1/projects/${projectId}/work-items/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors24.default.bold(row.title)}  ${import_picocolors24.default.dim(row.id)}`);
+        line(`${import_picocolors26.default.bold(row.title)}  ${import_picocolors26.default.dim(row.id)}`);
         line(`${statusTag(row.status)}  priority ${row.priority}`);
         if (row.ownerHuman) line(`owner: ${row.ownerHuman}`);
         if (row.labels?.length) line(`labels: ${row.labels.join(", ")}`);
@@ -6591,7 +6841,7 @@ ${row.description}`);
         refId: row?.id,
         output: { workItem: row }
       });
-      ok(row, () => line(`Created work item ${import_picocolors24.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created work item ${import_picocolors26.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   board.command("update <id>").description("Change fields on a card \u2014 pass only what changes").option("--title <text>", "new title").option("--description <text>", "new description").option("--status <value>", STATUSES.join(" | ")).option("--priority <value>", PRIORITIES.join(" | ")).option(
@@ -6625,7 +6875,7 @@ ${row.description}`);
         );
       }
       const row = await patchItem(ctx, projectId, String(args[0]), body);
-      ok(row, () => line(`Updated ${import_picocolors24.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
+      ok(row, () => line(`Updated ${import_picocolors26.default.bold(row.id)} \u2014 ${row.title} ${statusTag(row.status)}`));
     })
   );
   board.command("move <id> <status>").description(
@@ -6636,14 +6886,14 @@ ${row.description}`);
       const status = String(args[1]);
       assertStatus(status);
       const row = await patchItem(ctx, projectId, String(args[0]), { status });
-      ok(row, () => line(`Moved ${import_picocolors24.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
+      ok(row, () => line(`Moved ${import_picocolors26.default.bold(row.title)} \u2192 ${statusTag(row.status)}`));
     })
   );
   board.command("close <id>").description("Shorthand for `board move <id> done`").action(
     action(async ({ ctx, args }) => {
       const projectId = requireProject(ctx);
       const row = await patchItem(ctx, projectId, String(args[0]), { status: "done" });
-      ok(row, () => line(`Closed ${import_picocolors24.default.bold(row.title)} ${statusTag(row.status)}`));
+      ok(row, () => line(`Closed ${import_picocolors26.default.bold(row.title)} ${statusTag(row.status)}`));
     })
   );
 }
@@ -6676,23 +6926,23 @@ function assertPriority(value) {
   }
 }
 function formatRow(r) {
-  const labels = r.labels?.length ? import_picocolors24.default.dim(` [${r.labels.join(", ")}]`) : "";
-  const owner = r.ownerHuman ? import_picocolors24.default.dim(` @${r.ownerHuman}`) : "";
-  return `${import_picocolors24.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
+  const labels = r.labels?.length ? import_picocolors26.default.dim(` [${r.labels.join(", ")}]`) : "";
+  const owner = r.ownerHuman ? import_picocolors26.default.dim(` @${r.ownerHuman}`) : "";
+  return `${import_picocolors26.default.dim(r.id)}  ${statusTag(r.status)}  ${r.title}${labels}${owner}`;
 }
 function statusTag(status) {
   const label = status.padEnd(11);
-  if (status === "done") return import_picocolors24.default.green(label);
-  if (status === "in-progress") return import_picocolors24.default.yellow(label);
-  if (status === "in-review") return import_picocolors24.default.cyan(label);
-  return import_picocolors24.default.dim(label);
+  if (status === "done") return import_picocolors26.default.green(label);
+  if (status === "in-progress") return import_picocolors26.default.yellow(label);
+  if (status === "in-review") return import_picocolors26.default.cyan(label);
+  return import_picocolors26.default.dim(label);
 }
 function collect2(value, previous) {
   return [...previous, value];
 }
 
 // src/commands/decision.ts
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors27 = __toESM(require_picocolors(), 1);
 function registerDecision(program3) {
   const decision = program3.command("decision").description("Read and record the project's architecture decisions");
   decision.command("list").description("Every decision on record \u2014 read this before changing how something works").option("--limit <n>", "cap the number returned (newest first)").action(
@@ -6705,11 +6955,11 @@ function registerDecision(program3) {
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors25.default.dim("No decisions recorded yet."));
+          line(import_picocolors27.default.dim("No decisions recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors25.default.dim(r.id)}  ${import_picocolors25.default.dim(shortDate(r.createdAt))}  ${r.title}`);
+          line(`${import_picocolors27.default.dim(r.id)}  ${import_picocolors27.default.dim(shortDate(r.createdAt))}  ${r.title}`);
           line(`    ${truncate(r.decision, 100)}`);
         }
       });
@@ -6723,16 +6973,16 @@ function registerDecision(program3) {
         `/v1/projects/${projectId}/architecture-decisions/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors25.default.bold(row.title)}  ${import_picocolors25.default.dim(row.id)}`);
-        line(import_picocolors25.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors27.default.bold(row.title)}  ${import_picocolors27.default.dim(row.id)}`);
+        line(import_picocolors27.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
-${import_picocolors25.default.bold("Context")}
+${import_picocolors27.default.bold("Context")}
 ${row.context}`);
         line(`
-${import_picocolors25.default.bold("Decision")}
+${import_picocolors27.default.bold("Decision")}
 ${row.decision}`);
         if (row.consequences) line(`
-${import_picocolors25.default.bold("Consequences")}
+${import_picocolors27.default.bold("Consequences")}
 ${row.consequences}`);
       });
     })
@@ -6761,7 +7011,7 @@ ${row.consequences}`);
         refId: row?.id,
         output: { decision: row }
       });
-      ok(row, () => line(`Recorded decision ${import_picocolors25.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded decision ${import_picocolors27.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   const requirement = program3.command("requirement").description("Read and record the project's requirements");
@@ -6773,11 +7023,11 @@ ${row.consequences}`);
       rows = applyLimit(rows, opts.limit);
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors25.default.dim("No requirements recorded yet."));
+          line(import_picocolors27.default.dim("No requirements recorded yet."));
           return;
         }
         for (const r of rows) {
-          line(`${import_picocolors25.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
+          line(`${import_picocolors27.default.dim(r.id)}  ${r.status.padEnd(9)}  ${r.title}`);
         }
       });
     })
@@ -6790,8 +7040,8 @@ ${row.consequences}`);
         `/v1/projects/${projectId}/requirements/${args[0]}`
       );
       ok(row, () => {
-        line(`${import_picocolors25.default.bold(row.title)}  ${import_picocolors25.default.dim(row.id)}`);
-        line(import_picocolors25.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
+        line(`${import_picocolors27.default.bold(row.title)}  ${import_picocolors27.default.dim(row.id)}`);
+        line(import_picocolors27.default.dim(`${row.status} \xB7 ${shortDate(row.createdAt)}`));
         line(`
 ${row.body}`);
       });
@@ -6817,7 +7067,7 @@ ${row.body}`);
         refId: row?.id,
         output: { requirement: row }
       });
-      ok(row, () => line(`Recorded requirement ${import_picocolors25.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Recorded requirement ${import_picocolors27.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   requirement.command("update <id>").description(
@@ -6846,7 +7096,7 @@ ${row.body}`);
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated requirement ${import_picocolors25.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
+      ok(row, () => line(`Updated requirement ${import_picocolors27.default.bold(row.id)} \u2014 ${row.title} (${row.status})`));
     })
   );
 }
@@ -6869,7 +7119,7 @@ function shortDate(iso) {
 }
 
 // src/commands/doc.ts
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __toESM(require_picocolors(), 1);
 function registerDoc(program3) {
   const doc = program3.command("doc").description("Read and write project documents");
   doc.command("list").description("List the project's documents \u2014 check here before writing a new one").option("--work-item <id>", "the document linked to this card, if there is one").action(
@@ -6880,13 +7130,13 @@ function registerDoc(program3) {
       }) ?? [];
       ok(rows, () => {
         if (!rows.length) {
-          line(import_picocolors26.default.dim("No documents yet."));
+          line(import_picocolors28.default.dim("No documents yet."));
           return;
         }
         for (const r of rows) {
-          const link = r.workItemId ? import_picocolors26.default.dim(` \u21B3 ${r.workItemId}`) : "";
-          const file = r.filePath ? import_picocolors26.default.dim(`  ${r.filePath}`) : "";
-          line(`${import_picocolors26.default.dim(r.id)}  ${r.title}${link}${file}`);
+          const link = r.workItemId ? import_picocolors28.default.dim(` \u21B3 ${r.workItemId}`) : "";
+          const file = r.filePath ? import_picocolors28.default.dim(`  ${r.filePath}`) : "";
+          line(`${import_picocolors28.default.dim(r.id)}  ${r.title}${link}${file}`);
         }
       });
     })
@@ -6900,17 +7150,17 @@ function registerDoc(program3) {
       );
       if (opts.markdown) {
         ok({ id: row.id, title: row.title, filePath: row.filePath }, () => {
-          line(`${import_picocolors26.default.bold(row.title)}  ${import_picocolors26.default.dim(row.id)}`);
+          line(`${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.id)}`);
           line(
-            row.filePath ? `Read it at ${import_picocolors26.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors26.default.dim("This document has no markdown mirror on disk yet.")
+            row.filePath ? `Read it at ${import_picocolors28.default.bold(row.filePath)} (relative to the project folder).` : import_picocolors28.default.dim("This document has no markdown mirror on disk yet.")
           );
         });
         return;
       }
       ok(row, () => {
-        line(`${import_picocolors26.default.bold(row.title)}  ${import_picocolors26.default.dim(row.id)}`);
-        if (row.workItemId) line(import_picocolors26.default.dim(`linked to work item ${row.workItemId}`));
-        if (row.filePath) line(import_picocolors26.default.dim(`markdown mirror: ${row.filePath}`));
+        line(`${import_picocolors28.default.bold(row.title)}  ${import_picocolors28.default.dim(row.id)}`);
+        if (row.workItemId) line(import_picocolors28.default.dim(`linked to work item ${row.workItemId}`));
+        if (row.filePath) line(import_picocolors28.default.dim(`markdown mirror: ${row.filePath}`));
         line("");
         line(row.contentJson);
       });
@@ -6939,7 +7189,7 @@ function registerDoc(program3) {
         refId: row?.id,
         output: { document: row }
       });
-      ok(row, () => line(`Created document ${import_picocolors26.default.bold(row?.id ?? "")} \u2014 ${title}`));
+      ok(row, () => line(`Created document ${import_picocolors28.default.bold(row?.id ?? "")} \u2014 ${title}`));
     })
   );
   doc.command("update <id>").description("Revise an existing document rather than creating a second copy of it").option("--title <text>", "new title").option("--markdown <text>", "replace the body with this markdown").option("--content-json <json>", "replace the body with this rich-text content JSON").action(
@@ -6966,13 +7216,13 @@ function registerDoc(program3) {
           code: "bad_request"
         });
       }
-      ok(row, () => line(`Updated document ${import_picocolors26.default.bold(row.id)} \u2014 ${row.title}`));
+      ok(row, () => line(`Updated document ${import_picocolors28.default.bold(row.id)} \u2014 ${row.title}`));
     })
   );
 }
 
 // src/commands/design.ts
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 function registerDesign(program3) {
   const design = program3.command("design").description("Read the project's brand (colours, fonts, logo)");
   design.command("show").description("Show this project's brand \u2014 read it before writing any UI").option("--raw", "print the generated token files verbatim instead of a summary").action(
@@ -6986,11 +7236,11 @@ function registerDesign(program3) {
       if (opts.raw) {
         ok(files, () => {
           if (!files.length) {
-            line(import_picocolors27.default.dim("No brand set for this project."));
+            line(import_picocolors29.default.dim("No brand set for this project."));
             return;
           }
           for (const f of files) {
-            line(import_picocolors27.default.bold(f.path));
+            line(import_picocolors29.default.bold(f.path));
             line(f.contents);
             line("");
           }
@@ -7007,21 +7257,21 @@ function registerDesign(program3) {
       } : { hasBrand: false, colors: {}, fonts: {}, brand: {}, files: [] };
       ok(summary, () => {
         if (!tokens) {
-          line(import_picocolors27.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
+          line(import_picocolors29.default.dim("No brand set for this project \u2014 choose sensible styling yourself."));
           return;
         }
         for (const [name, value] of Object.entries(tokens.brand)) {
-          line(`${import_picocolors27.default.dim(name.padEnd(12))} ${value}`);
+          line(`${import_picocolors29.default.dim(name.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.color)) {
-          line(`${import_picocolors27.default.dim(`color.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors29.default.dim(`color.${name}`.padEnd(12))} ${value}`);
         }
         for (const [name, value] of Object.entries(tokens.font)) {
-          line(`${import_picocolors27.default.dim(`font.${name}`.padEnd(12))} ${value}`);
+          line(`${import_picocolors29.default.dim(`font.${name}`.padEnd(12))} ${value}`);
         }
         line("");
         line(
-          import_picocolors27.default.dim(
+          import_picocolors29.default.dim(
             `Generated into the working tree as ${files.map((f) => f.path).join(", ")} \u2014 wire those in, never edit them.`
           )
         );
@@ -7053,7 +7303,7 @@ function unwrap(group) {
 
 // src/index.ts
 var pkg = {
-  version: true ? "0.2.6" : "0.0.0-dev"
+  version: true ? "0.2.7" : "0.0.0-dev"
 };
 var program2 = new Command();
 program2.name("workser").description(
@@ -7086,6 +7336,8 @@ registerOpen(program2);
 registerDoctor(program2);
 registerAgent(program2);
 registerVerify(program2);
+registerCheckpoint(program2);
+registerSync(program2);
 registerWorkflow(program2);
 registerApp(program2);
 registerTool(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workser/cli",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Workser CLI — give your local AI agent native DevOps & infrastructure on Workser. The agent runs `workser …` to provision, deploy, and manage real apps.",
   "license": "MIT",
   "type": "module",

package/skills/workser/SKILL.md

@@ -5,19 +5,16 @@ description: Provision, deploy, and operate the current Workser app. Use when th
 
 # Workser — ship & run the current app from the terminal
 
-You have the `workser` CLI. It lets you act as the user's DevOps engineer for the
-**one project** Workser Orbit has linked to this directory: provision and browse its
-Neon Postgres database, deploy it, manage its env vars and bucket, provision auth,
-and read its logs — **on the user's own account**, through the Workser Orbit app
-(which handles auth and shows the user what you're doing).
-
-For writing code, keep using your normal tools. Use `workser` for the last mile.
+You have the `workser` CLI. Use it to operate the **one project** Workser Orbit has
+linked to this directory — infrastructure, config, shipping — **on the user's own
+account**, through the Orbit app, which handles auth and shows them what you're
+doing. For writing code, keep using your normal tools.
 
 ## Read one guide, not all of them
 
-This page is the index. The detail lives in the CLI itself — `workser help <topic>`
-prints one focused guide, about a screen long. Find your row, run that **one**
-command. Don't print them all; you are paying for every line you load.
+This page is the index. `workser help <topic>` prints one focused guide, about a
+screen long. Find your row, run that **one** command — you pay for every line you
+load.
 
 | You need to… | Commands | Run |
 | --- | --- | --- |
@@ -25,6 +22,7 @@ command. Don't print them all; you are paying for every line you load.
 | Follow the project's brand — colours, fonts, logo | `design …` | `workser help brand` |
 | Provision or query Postgres; list end users | `db …`, `auth …` | `workser help database` |
 | Deploy, set env vars, read logs, check a domain | `deploy`, `env …`, `logs`, `versions`, `domain`, `open` | `workser help deploy` |
+| Save work before a risky change, undo it, sync this folder | `checkpoint`, `restore`, `sync` | `workser help version-control` |
 | Put files in the project's bucket | `storage …` | `workser help storage` |
 | Read or write products, orders, customers, deals | `business …` | `workser help business` |
 | Use the project's own Neon buckets or functions | `neon …` | `workser help neon` |
@@ -35,9 +33,8 @@ command. Don't print them all; you are paying for every line you load.
 | Record finished output, or ask the user a question | `artifact …`, `ask` | `workser help deliverables` |
 | Control this machine — files, shell, screen, browser | `tool …` | `workser help computer-use` |
 
-`workser help` with no topic lists them. **The CLI is the source of truth** — it
-ships these guides itself, so they match the version you are running, and
-`workser <command> --help` is generated from the implementation.
+`workser help` lists them all; `workser <command> --help` gives exact flags. Both
+come from the CLI itself, so they match the version you are running.
 
 ## Orientation (no guide needed)
 
@@ -123,6 +120,8 @@ workser board close <id> --json             # 9. the Board now matches reality
   - `no_project` → no project is linked here; the user links it in Orbit.
   - `owner_only` → an owner action; tell the user to do it in Orbit, then continue.
   - `awaiting_approval` → user must approve in Orbit; then retry.
+  - `needs_local_app` → this machine has no Workser app, so folder commands
+    can't run. Say so; don't reach for `git` instead.
 
 Keep the user informed in plain language ("Provisioned a database and deployed —
 it's live at <url>"), not raw JSON.

package/skills/workser/reference/version-control.md

@@ -0,0 +1,66 @@
+---
+topic: version-control
+title: Saving, undoing & syncing your work
+summary: Checkpoint before risky edits, restore when they go wrong, sync with Workser.
+commands: [checkpoint, restore, sync]
+---
+
+# Saving, undoing & syncing your work
+
+```
+workser checkpoint ["what you're about to try"]  # save the folder as it stands now
+workser restore                                  # go back to the newest checkpoint
+workser restore --list                           # see the checkpoints you can go back to
+workser restore <ref>                            # go back to a specific one
+workser sync [--branch dev] [--app <id>]         # reconcile this folder with Workser
+```
+
+## Why these exist instead of git
+
+This folder is a git repository, but **the history is Workser's**. There is no
+remote: code moves to and from Workser over its API as git bundles, using the
+same session everything else here uses. No credential is read, and the user's
+own git keys and identity are never touched.
+
+That is what makes any of this work on a computer with no access to the
+Workser-managed repository — which is every computer. Nobody has repo access;
+the API does.
+
+So the ordinary git verbs are wrong here, and these three replace them:
+
+| Instead of | Run |
+|---|---|
+| `git stash` | `workser checkpoint` |
+| `git commit` | `workser checkpoint` |
+| `git reset --hard` / `git checkout .` | `workser restore` |
+| `git pull` / `git push` | `workser sync` |
+
+Reading is always fine: `git log`, `git diff`, `git show`, `git status`.
+
+## Notes that matter
+
+- **Checkpoint before anything you might want to take back** — a refactor across
+  many files, a dependency upgrade, deleting something large. It costs a second.
+- **`git stash` is the one that actually loses work.** Workser publishes what is
+  on disk, so a deploy while your changes are stashed ships the version *without
+  them* — and if the run is stopped between `stash` and `stash pop`, the user
+  opens their folder and their work is gone. `workser checkpoint` has neither
+  failure mode.
+- **Restoring never discards anything.** The current state is saved first, then
+  the older state is restored on top. If you restore the wrong thing, restore
+  again. Say this to the user — it is the reason they can afford to say yes.
+- **These are the same checkpoints as the app's Undo button.** One history, not
+  two: a checkpoint you take here appears in Workser, and vice versa.
+- **`sync` pulls before it pushes.** If it reports `diverged`, both sides changed
+  and it stops rather than picking a winner — tell the user to resolve it in
+  Workser instead of forcing it.
+- **These three need the Workser app running on this computer**, because they
+  work with files. If you get `needs_local_app`, you are on a machine that only
+  has the CLI and a token — say so rather than looking for a workaround. Every
+  read-only command (`projects`, `env`, `db`, `logs`, `status`) still works.
+
+## Shipping is separate
+
+`workser sync` reconciles the folder. `workser deploy` puts it in front of
+users. Syncing does not deploy, and deploying does not require you to sync
+first — deploy publishes what is on disk. See `reference/deploy.md`.