@floomhq/floom 1.0.25 → 1.0.27

package/README.md

@@ -4,6 +4,7 @@ Sync AI skills across agents and machines. Publish from your terminal, then add
 
 ```bash
 npm install -g @floomhq/floom
+floom init my-skill.md
 floom init my-skill
 floom login
 floom publish my-skill
@@ -21,9 +22,9 @@ The package is designed for `npx -y @floomhq/floom ...`. Global installs expose
 
 ## Commands
 
-- `npx -y @floomhq/floom login` — sign in with Google. Use `--provider github` for GitHub. New accounts are created on first login. Token stored at `~/.floom/config.json`.
+- `npx -y @floomhq/floom login` — sign in with Google. New accounts are created on first login. Token stored at `~/.floom/config.json`.
 - `npx -y @floomhq/floom init [path]` — create a starter skill folder at `<path>/SKILL.md`. Passing an existing-style `file.md` path still creates that Markdown file.
-- `npx -y @floomhq/floom publish <path>` — upload a skill folder or Markdown file. Folder packages use `<slug>/SKILL.md` plus optional `references/`, `examples/`, `scripts/`, and `assets/`. Optional `--public` / `--private` / `--unlisted`, `--type knowledge|instruction|workflow|skill`, `--installs-as <target>`, `--skill-version <label>`, and `--update [slug-or-url]`.
+- `npx -y @floomhq/floom publish <path>` — upload a skill folder or Markdown file. Folder packages use `<slug>/SKILL.md` plus optional `references/`, `examples/`, `scripts/`, and `assets/`. Optional `--public` / `--private` / `--unlisted`, `--type knowledge|instruction|workflow|skill`, `--installs-as <target>`, and `--skill-version <label>`.
 - `npx -y @floomhq/floom share <slug>` — email-share one of your skills. Optional `--add <email>`, `--remove <email>`, and `--list`.
 - `npx -y @floomhq/floom list` — show your published skills. Optional `--json`.
 - `npx -y @floomhq/floom add <url-or-slug>` — fetch a skill into `~/.claude/skills/<slug>/SKILL.md` with supporting package files. Optional `--target claude|codex`, `--setup` to connect the agent, and `--force` to replace an existing local copy.
@@ -32,8 +33,8 @@ The package is designed for `npx -y @floomhq/floom ...`. Global installs expose
 - `npx -y @floomhq/floom setup` — add Floom usage guidance to `CLAUDE.md` or `AGENTS.md`. Optional `--target claude|codex`, `--dry-run`, `--yes`.
 - `npx -y @floomhq/floom connect` — alias for setup.
 - `npx -y @floomhq/floom mcp` — print MCP setup commands for supported agent CLIs.
-- `npx -y @floomhq/floom sync` — pull your published, saved, and subscribed library skills into Claude or Codex. Optional `--target claude|codex`.
-- `npx -y @floomhq/floom watch` — run sync repeatedly. Optional `--interval <seconds>`; minimum `10`.
+- `npx -y @floomhq/floom sync` — preview: pull your published, saved, and subscribed library skills into Claude or Codex. Optional `--target claude|codex`.
+- `npx -y @floomhq/floom watch` — preview: run sync repeatedly. Optional `--interval <seconds>`; minimum `10`.
 - `npx -y @floomhq/floom library list` — list public starter libraries. Optional `--json`.
 - `npx -y @floomhq/floom library create <slug> --name <name>` — create a personal or starter library. Optional `--public` / `--private` / `--unlisted`.
 - `npx -y @floomhq/floom library add <library> <skill> [--folder <path>] [--tags a,b]` — add a skill to a library.
@@ -74,7 +75,7 @@ version: 0.1.0
 
 Override the API host with `FLOOM_API_URL` (defaults to `https://floom.dev`).
 
-`floom sync` and `floom watch` pull published, saved, and subscribed library skills. They store a machine-local manifest at `~/.floom/sync-manifest.json`.
+`floom sync` and `floom watch` are v1 preview commands for published, saved, and subscribed library skills. They store a machine-local manifest at `~/.floom/sync-manifest.json`.
 The manifest records hashes for files Floom previously wrote. Sync writes missing files only.
 Remote updates, existing untracked files, and locally edited tracked files are skipped as conflicts.
 Symlinks are never followed. To replace a local skill manually, run `floom add <url-or-slug> --force`.

package/dist/cli.js

@@ -11,6 +11,7 @@ import { info } from "./info.js";
 import { deleteSkill } from "./delete.js";
 import { doctor } from "./doctor.js";
 import { sync } from "./sync.js";
+import { watchPush } from "./push-watch.js";
 import { printMcpSetup } from "./mcp.js";
 import { setupAgent } from "./setup.js";
 import { search } from "./search.js";
@@ -20,6 +21,7 @@ import { libraryAddSkill, libraryCreate, libraryList, libraryRemoveSkill, librar
 import { c, symbols } from "./ui.js";
 import { printError, FloomError } from "./errors.js";
 import { CLI_VERSION } from "./version.js";
+import { TARGET_HINT, isAgentTarget } from "./targets.js";
 const PKG = { name: "@floomhq/floom", version: CLI_VERSION };
 const V1_NOT_AVAILABLE = "Not available in Floom Version 1.";
 const CLI_COMMAND = "npx -y @floomhq/floom";
@@ -71,9 +73,7 @@ function commandUsage() {
    ${c.dim("Skills")}
      ${c.cyan("add")} ${c.dim("<url>")}          Install a skill into the local agent skills folder
                        ${c.dim("Alias: install")}
-                       ${c.dim("Flags: --target claude|codex (default: claude), --setup, --force, --json")}
-     ${c.cyan("update")} ${c.dim("<url>")}       Refresh or migrate a local skill
-                       ${c.dim("Flags: --target claude|codex (default: claude), --json")}
+                       ${c.dim(`Flags: --target ${TARGET_HINT} (default: claude), --setup, --force`)}
      ${c.cyan("search")} ${c.dim("<query>")}     Find public skills and libraries
      ${c.cyan("info")} ${c.dim("<url>")}         Show skill metadata
 
@@ -83,7 +83,7 @@ function commandUsage() {
      ${c.cyan("scan")} ${c.dim("<path>")}        Check for secrets, injection, exfiltration
      ${c.cyan("publish")} ${c.dim("<path>")}     Scan, publish, and print a share link
                        ${c.dim("Flags: --public, --private, --type knowledge|instruction|workflow|skill")}
-                       ${c.dim("       --skill-version <label>, --update [slug-or-url]")}
+                       ${c.dim("       --skill-version <label>")}
      ${c.cyan("share")} ${c.dim("<slug>")}       Email-share one of your skills
                        ${c.dim("Flags: --add <email>, --remove <email>, --list")}
 
@@ -98,22 +98,19 @@ function commandUsage() {
    ${c.dim("Agent setup")}
      ${c.cyan("setup")}              Configure Claude Code or Codex instructions
                        ${c.dim("Alias: connect")}
-                       ${c.dim("Flags: --target claude|codex, --yes, --dry-run")}
+                       ${c.dim(`Flags: --target ${TARGET_HINT}, --yes, --dry-run`)}
      ${c.cyan("doctor")}             Troubleshoot auth, API, and local folders
-                       ${c.dim("Flags: --target claude|codex (default: claude), --json")}
+                       ${c.dim(`Flags: --target ${TARGET_HINT} (default: claude)`)}
 
    ${c.dim("Advanced")}
      ${c.cyan("library")}            Create, browse, and subscribe to libraries
                        ${c.dim("Alias: lib")}
      ${c.cyan("move")} ${c.dim("<slug> --folder <path>")}  Place a saved skill in a local folder
      ${c.cyan("mcp")}                Print optional MCP setup guidance
-     ${c.cyan("sync")}               Pull published, saved, and library skills
-                       ${c.dim("Flags: --target claude|codex (default: claude)")}
-     ${c.cyan("watch")}              Run a polling sync loop
-                       ${c.dim("Flags: --target claude|codex (default: claude), --interval <seconds>")}
-     ${c.cyan("agent-prompt")}       Print the one-line agent instruction
-                       ${c.dim("Alias: paste")}
-                       ${c.dim("Flags: --target claude|codex (default: claude)")}
+     ${c.cyan("sync")}               Preview pull of published, saved, and library skills
+                       ${c.dim(`Flags: --target ${TARGET_HINT} (default: claude)`)}
+     ${c.cyan("watch")}              Preview polling sync loop
+                       ${c.dim(`Flags: --push, --no-yolo, --target ${TARGET_HINT}`)}
 
  ${c.bold("Examples")}
    ${c.cyan("npx -y @floomhq/floom add")} ${c.dim("https://floom.dev/s/ffas93ud --setup")}
@@ -129,120 +126,6 @@ function commandUsage() {
 `;
     process.stdout.write(out);
 }
-function subcommandUsage(cmd) {
-    const key = cmd === "install" ? "add" : cmd === "rm" ? "delete" : cmd === "connect" ? "setup" : cmd === "paste" ? "agent-prompt" : cmd;
-    const usageByCommand = {
-        add: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} add`)} ${c.dim("<url-or-slug> [flags]")}
-
-Install a Floom skill into a local agent skills folder.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Install for Claude Code or Codex. Default: claude.
-  ${c.cyan("--setup")}                Add Floom guidance to the matching agent instructions file.
-  ${c.cyan("--force")}                Replace the local copy when remote content differs.
-  ${c.cyan("--json")}                 Print machine-readable install output.
-
-${c.bold("Examples")}
-  ${c.cyan(`${CLI_COMMAND} add https://floom.dev/s/ffas93ud --setup`)}
-  ${c.cyan(`${CLI_COMMAND} add ffas93ud --target codex --json`)}
-`,
-        update: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} update`)} ${c.dim("<url-or-slug> [flags]")}
-
-Refresh or migrate one local skill through the same installer as add.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Update Claude Code or Codex local skills. Default: claude.
-  ${c.cyan("--setup")}                Also refresh agent setup instructions.
-  ${c.cyan("--json")}                 Print machine-readable install output.
-`,
-        doctor: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} doctor`)} ${c.dim("[flags]")}
-
-Diagnose auth, API reachability, PATH collisions, MCP setup, and local skills folders.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Check Claude Code or Codex paths. Default: claude.
-  ${c.cyan("--json")}                 Print structured checks for scripts.
-`,
-        login: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} login`)} ${c.dim("[flags]")}
-
-Sign in through browser OAuth.
-
-${c.bold("Flags")}
-  ${c.cyan("--provider")} ${c.dim("google|github")}   OAuth provider. Default: google.
-`,
-        publish: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} publish`)} ${c.dim("<path> [flags]")}
-
-Scan and publish a Markdown skill file or skill folder. Prints a Floom share URL.
-
-${c.bold("Flags")}
-  ${c.cyan("--public")} | ${c.cyan("--private")} | ${c.cyan("--unlisted")}   Set visibility. Default: unlisted.
-  ${c.cyan("--type")} ${c.dim("knowledge|instruction|workflow|skill")}
-  ${c.cyan("--installs-as")} ${c.dim("claude_skill|memory|rule|codex_instruction|opencode_instruction|cursor_rule|other")}
-  ${c.cyan("--skill-version")} ${c.dim("<label>")}
-  ${c.cyan("--update")} ${c.dim("[slug-or-url]")}
-`,
-        init: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} init`)} ${c.dim("[path] [flags]")}
-
-Create a starter skill folder with SKILL.md.
-
-${c.bold("Flags")}
-  ${c.cyan("--template")} ${c.dim(`generic|${INIT_TEMPLATES.filter((t) => t !== "generic").join("|")}`)}
-`,
-        sync: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} sync`)} ${c.dim("[flags]")}
-
-Pull published, saved, and subscribed library skills.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Sync into Claude Code or Codex skills. Default: claude.
-`,
-        watch: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} watch`)} ${c.dim("[flags]")}
-
-Poll sync on an interval.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Watch Claude Code or Codex skills. Default: claude.
-  ${c.cyan("--interval")} ${c.dim("<seconds>")}    Poll interval. Minimum: 10.
-`,
-        setup: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} setup`)} ${c.dim("[flags]")}
-
-Add Floom guidance to CLAUDE.md or AGENTS.md.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Configure Claude Code or Codex.
-  ${c.cyan("--file")} ${c.dim("<path>")}           Write a specific instructions file.
-  ${c.cyan("--yes")}                  Write without prompting.
-  ${c.cyan("--dry-run")}              Preview the change only.
-`,
-        search: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} search`)} ${c.dim("<query> [flags]")}
-
-Find public skills and libraries.
-
-${c.bold("Flags")}
-  ${c.cyan("--library")} ${c.dim("<slug>")}        Limit search to one library.
-  ${c.cyan("--type")} ${c.dim("knowledge|instruction|workflow|skill")}
-  ${c.cyan("--json")}                 Print machine-readable results.
-`,
-        info: `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} info`)} ${c.dim("<url-or-slug> [flags]")}
-
-Show public skill metadata.
-
-${c.bold("Flags")}
-  ${c.cyan("--json")}                 Print machine-readable metadata.
-`,
-        "agent-prompt": `${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} agent-prompt`)} ${c.dim("[flags]")}
-
-Print the one-line instruction to paste into your agent.
-
-${c.bold("Flags")}
-  ${c.cyan("--target")} ${c.dim("claude|codex")}   Print the right local skills path. Default: claude.
-`,
-    };
-    const body = key ? usageByCommand[key] : undefined;
-    if (!body)
-        return false;
-    process.stdout.write(`${body}\n`);
-    return true;
-}
 const ASSET_TYPES = new Set(["knowledge", "instruction", "workflow", "skill"]);
 const INSTALL_TARGETS = new Set([
     "claude_skill",
@@ -263,25 +146,8 @@ function readFlagValue(argv, index, flag) {
         throw new FloomError(`Missing value for ${flag}.`);
     return { value, nextIndex: index + 1 };
 }
-function parseLoginArgs(argv) {
-    let provider = "google";
-    for (let i = 0; i < argv.length; i += 1) {
-        const a = argv[i] ?? "";
-        if (a === "--provider" || a.startsWith("--provider=")) {
-            const { value, nextIndex } = readFlagValue(argv, i, "--provider");
-            if (value !== "google" && value !== "github") {
-                throw new FloomError("Invalid --provider.", "Use google or github.");
-            }
-            provider = value;
-            i = nextIndex;
-            continue;
-        }
-        throw new FloomError(`Unknown flag or argument: ${a}`, `Try \`${CLI_COMMAND} login --provider github\`.`);
-    }
-    return { provider };
-}
 function parseFlags(argv) {
-    const out = { visibility: "unlisted", update: false, rest: [] };
+    const out = { update: false, rest: [] };
     let visibilityFlag = null;
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i] ?? "";
@@ -295,15 +161,15 @@ function parseFlags(argv) {
         }
         else if (a === "--update" || a.startsWith("--update=")) {
             out.update = true;
-            if (a.startsWith("--update=")) {
-                out.updateSlug = a.slice("--update=".length);
+            const inline = a.startsWith("--update=") ? a.slice("--update=".length) : undefined;
+            const next = argv[i + 1];
+            const value = inline ?? (next && !next.startsWith("--") ? next : undefined);
+            if (value) {
+                out.updateSlug = value;
+                if (!inline)
+                    i += 1;
             }
             else {
-                const next = argv[i + 1];
-                if (out.rest.length > 0 && next && !next.startsWith("--")) {
-                    out.updateSlug = next;
-                    i += 1;
-                }
             }
         }
         else if (a === "--share" || a.startsWith("--share=")) {
@@ -405,6 +271,11 @@ function parseInitArgs(argv) {
     }
     return { ...(file ? { file } : {}), ...(template ? { template } : {}) };
 }
+function parseTargetFlag(value) {
+    if (isAgentTarget(value))
+        return value;
+    throw new FloomError("Invalid --target.", `Use ${TARGET_HINT}.`);
+}
 function parseListFlags(argv) {
     const out = { json: false };
     for (const a of argv) {
@@ -425,10 +296,7 @@ function parseSyncFlags(argv) {
         const a = argv[i] ?? "";
         if (a === "--target" || a.startsWith("--target=")) {
             const { value, nextIndex } = readFlagValue(argv, i, "--target");
-            if (value !== "claude" && value !== "codex") {
-                throw new FloomError("Invalid --target.", "Use claude or codex.");
-            }
-            out.target = value;
+            out.target = parseTargetFlag(value);
             i = nextIndex;
         }
         else if (a.startsWith("--")) {
@@ -459,15 +327,11 @@ function parseAddArgs(argv) {
     let target;
     let setup = false;
     let force = false;
-    let json = false;
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i] ?? "";
         if (a === "--target" || a.startsWith("--target=")) {
             const { value, nextIndex } = readFlagValue(argv, i, "--target");
-            if (value !== "claude" && value !== "codex") {
-                throw new FloomError("Invalid --target.", "Use `claude` or `codex`.");
-            }
-            target = value;
+            target = parseTargetFlag(value);
             i = nextIndex;
         }
         else if (a === "--setup") {
@@ -476,9 +340,6 @@ function parseAddArgs(argv) {
         else if (a === "--force") {
             force = true;
         }
-        else if (a === "--json") {
-            json = true;
-        }
         else if (a.startsWith("--")) {
             throw new FloomError(`Unknown flag: ${a}`, `Try \`${CLI_COMMAND} add <url-or-slug> --setup\`.`);
         }
@@ -491,10 +352,7 @@ function parseAddArgs(argv) {
     if (!slug) {
         throw new FloomError("Missing skill slug.", `Try: \`${CLI_COMMAND} add <url-or-slug> --setup\``);
     }
-    if (json && setup) {
-        throw new FloomError("Cannot combine --json with --setup.", "Run the install first, then run `npx -y @floomhq/floom setup --target claude --yes`.");
-    }
-    return target ? { slug, target, setup, force, json } : { slug, setup, force, json };
+    return target ? { slug, target, setup, force } : { slug, setup, force };
 }
 function parseSearchFlags(argv) {
     const out = { json: false };
@@ -558,10 +416,7 @@ function parseSetupFlags(argv) {
             out.yes = true;
         else if (a === "--target" || a.startsWith("--target=")) {
             const { value, nextIndex } = readFlagValue(argv, i, "--target");
-            if (value !== "claude" && value !== "codex") {
-                throw new FloomError("Invalid --target.", "Use `claude` or `codex`.");
-            }
-            out.target = value;
+            out.target = parseTargetFlag(value);
             i = nextIndex;
         }
         else if (a === "--file" || a.startsWith("--file=")) {
@@ -580,22 +435,16 @@ function parseSetupFlags(argv) {
     return out;
 }
 function parseDoctorFlags(argv) {
-    const out = { json: false };
+    const out = {};
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i] ?? "";
         if (a === "--target" || a.startsWith("--target=")) {
             const { value, nextIndex } = readFlagValue(argv, i, "--target");
-            if (value !== "claude" && value !== "codex") {
-                throw new FloomError("Invalid --target.", "Use `claude` or `codex`.");
-            }
-            out.target = value;
+            out.target = parseTargetFlag(value);
             i = nextIndex;
         }
-        else if (a === "--json") {
-            out.json = true;
-        }
         else if (a.startsWith("--")) {
-            throw new FloomError(`Unknown flag: ${a}`, `Try \`${CLI_COMMAND} doctor --target codex --json\`.`);
+            throw new FloomError(`Unknown flag: ${a}`, `Try \`${CLI_COMMAND} doctor --target codex\`.`);
         }
         else {
             throw new FloomError(`Unexpected argument: ${a}`, `Try \`${CLI_COMMAND} doctor --target claude\`.`);
@@ -743,7 +592,7 @@ async function runLibrary(argv) {
     }
 }
 function parseWatchFlags(argv) {
-    const out = { intervalSeconds: 60 };
+    const out = { intervalSeconds: 60, push: false, yolo: true, once: false, target: "claude" };
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i] ?? "";
         if (a === "--interval" || a.startsWith("--interval=")) {
@@ -755,50 +604,31 @@ function parseWatchFlags(argv) {
             out.intervalSeconds = interval;
             i = nextIndex;
         }
-        else if (a === "--target" || a.startsWith("--target=")) {
-            const { value, nextIndex } = readFlagValue(argv, i, "--target");
-            if (value !== "claude" && value !== "codex") {
-                throw new FloomError("Invalid --target.", "Use claude or codex.");
-            }
-            out.target = value;
-            i = nextIndex;
+        else if (a === "--push") {
+            out.push = true;
         }
-        else if (a.startsWith("--")) {
-            throw new FloomError(`Unknown flag: ${a}`, `Try \`${CLI_COMMAND} watch --target claude --interval 60\`.`);
+        else if (a === "--no-yolo") {
+            out.yolo = false;
         }
-        else {
-            throw new FloomError(`Unexpected argument: ${a}`, `Try \`${CLI_COMMAND} watch --target claude --interval 60\`.`);
+        else if (a === "--once") {
+            out.once = true;
         }
-    }
-    return out;
-}
-function notAvailable(feature) {
-    throw new FloomError(V1_NOT_AVAILABLE, `${feature} is planned for a later Floom release.`);
-}
-function parseAgentPromptFlags(argv) {
-    const out = {};
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i] ?? "";
-        if (a === "--target" || a.startsWith("--target=")) {
+        else if (a === "--target" || a.startsWith("--target=")) {
             const { value, nextIndex } = readFlagValue(argv, i, "--target");
-            if (value !== "claude" && value !== "codex") {
-                throw new FloomError("Invalid --target.", "Use `claude` or `codex`.");
-            }
-            out.target = value;
+            out.target = parseTargetFlag(value);
             i = nextIndex;
         }
         else if (a.startsWith("--")) {
-            throw new FloomError(`Unknown flag: ${a}`, `Try \`${CLI_COMMAND} agent-prompt --target codex\`.`);
+            throw new FloomError(`Unknown flag: ${a}`, `Try \`${CLI_COMMAND} watch --push --target claude\`.`);
         }
         else {
-            throw new FloomError(`Unexpected argument: ${a}`, `Try \`${CLI_COMMAND} agent-prompt --target claude\`.`);
+            throw new FloomError(`Unexpected argument: ${a}`, `Try \`${CLI_COMMAND} watch --push --target claude\`.`);
         }
     }
     return out;
 }
-function printAgentPrompt(target = "claude") {
-    const folder = target === "codex" ? "~/.codex/skills" : "~/.claude/skills";
-    process.stdout.write(`Use my installed Floom skills when they fit the task. Search ${folder} first.\n`);
+function notAvailable(feature) {
+    throw new FloomError(V1_NOT_AVAILABLE, `${feature} is planned for a later Floom release.`);
 }
 function parseSingleFileArg(argv, usageHint) {
     let file;
@@ -824,7 +654,7 @@ function sleep(ms, signal) {
         }, { once: true });
     });
 }
-async function watch(intervalSeconds, target) {
+async function watch(intervalSeconds) {
     const cfg = await readConfig();
     if (!cfg) {
         throw new FloomError("Not signed in.", `Run \`${CLI_COMMAND} login\` before \`${CLI_COMMAND} watch\`, or use \`${CLI_COMMAND} add <link>\` without an account.`);
@@ -841,9 +671,9 @@ async function watch(intervalSeconds, target) {
     };
     process.on("SIGINT", stop);
     process.on("SIGTERM", stop);
-    process.stdout.write(`${symbols.bullet}  Watching Floom sync for ${target ?? "claude"} every ${intervalSeconds}s. Press Ctrl-C to stop.\n`);
+    process.stdout.write(`${symbols.bullet}  Watching Floom sync every ${intervalSeconds}s. Press Ctrl-C to stop.\n`);
     while (!controller.signal.aborted) {
-        await sync({ spinner: false, quietUnchanged: true, ...(target ? { target } : {}) });
+        await sync({ spinner: false, quietUnchanged: true });
         await sleep(intervalSeconds * 1000, controller.signal);
     }
 }
@@ -863,9 +693,10 @@ async function main() {
             // never block on update-notifier
         }
     }
+    // Subcommand --help: any rest arg = --help/-h/help → show top-level usage.
+    // Subcommands are simple enough that one help screen is fine for Version 1.
     if (rest.includes("--help") || rest.includes("-h") || rest.includes("help")) {
-        if (!subcommandUsage(cmd))
-            commandUsage();
+        usage();
         return;
     }
     try {
@@ -887,7 +718,8 @@ async function main() {
                 process.stdout.write(`${CLI_VERSION}\n`);
                 return;
             case "login":
-                await login(parseLoginArgs(rest).provider);
+                rejectArgs(rest, `Try \`${CLI_COMMAND} login\`.`);
+                await login();
                 return;
             case "logout":
                 rejectArgs(rest, `Try \`${CLI_COMMAND} logout\`.`);
@@ -914,8 +746,8 @@ async function main() {
                 }
                 await publish({
                     file,
-                    visibility: flags.visibility,
                     update: flags.update,
+                    ...(flags.visibility ? { visibility: flags.visibility } : {}),
                     ...(flags.updateSlug ? { updateSlug: flags.updateSlug } : {}),
                     ...(flags.assetType ? { assetType: flags.assetType } : {}),
                     ...(flags.installsAs ? { installsAs: flags.installsAs } : {}),
@@ -970,20 +802,6 @@ async function main() {
                     ...(flags.target ? { target: flags.target } : {}),
                     setup: flags.setup,
                     force: flags.force,
-                    json: flags.json,
-                });
-                if (flags.setup) {
-                    await setupAgent({ target: flags.target ?? "claude", dryRun: false, yes: true });
-                }
-                return;
-            }
-            case "update": {
-                const flags = parseAddArgs(rest);
-                await install(flags.slug, {
-                    ...(flags.target ? { target: flags.target } : {}),
-                    setup: flags.setup,
-                    force: true,
-                    json: flags.json,
                 });
                 if (flags.setup) {
                     await setupAgent({ target: flags.target ?? "claude", dryRun: false, yes: true });
@@ -1001,7 +819,15 @@ async function main() {
             }
             case "watch": {
                 const flags = parseWatchFlags(rest);
-                await watch(flags.intervalSeconds, flags.target);
+                if (flags.push) {
+                    await watchPush(flags.intervalSeconds, {
+                        target: flags.target,
+                        yolo: flags.yolo,
+                        once: flags.once,
+                    });
+                    return;
+                }
+                await watch(flags.intervalSeconds);
                 return;
             }
             case "delete":
@@ -1033,13 +859,6 @@ async function main() {
                 rejectArgs(rest, `Try \`${CLI_COMMAND} mcp\`.`);
                 printMcpSetup();
                 return;
-            case "agent-prompt":
-            case "paste":
-                {
-                    const flags = parseAgentPromptFlags(rest);
-                    printAgentPrompt(flags.target);
-                }
-                return;
             case "doctor":
                 await doctor(parseDoctorFlags(rest));
                 return;

package/dist/config.js

@@ -5,7 +5,6 @@ export const CONFIG_DIR = join(homedir(), ".floom");
 export const CONFIG_PATH = join(CONFIG_DIR, "config.json");
 export const DEFAULT_API_URL = "https://floom.dev";
 export const DEFAULT_WEB_URL = "https://floom.dev";
-const REFRESH_SKEW_SECONDS = 5 * 60;
 export function getApiUrl() {
     return process.env.FLOOM_API_URL?.replace(/\/$/, "") ?? DEFAULT_API_URL;
 }
@@ -15,7 +14,7 @@ export function resolveApiUrl(cfg) {
 export function getWebUrl() {
     return process.env.FLOOM_WEB_URL?.replace(/\/$/, "") ?? DEFAULT_WEB_URL;
 }
-export async function readRawConfig() {
+export async function readConfig() {
     try {
         const buf = await readFile(process.env.FLOOM_CONFIG_PATH ?? CONFIG_PATH, "utf8");
         const parsed = JSON.parse(buf);
@@ -29,15 +28,6 @@ export async function readRawConfig() {
         throw e;
     }
 }
-export async function readConfig() {
-    const cfg = await readRawConfig();
-    if (!cfg)
-        return null;
-    if (!needsRefresh(cfg))
-        return cfg;
-    const refreshed = await refreshConfig(cfg);
-    return refreshed;
-}
 export async function writeConfig(cfg) {
     const targetPath = process.env.FLOOM_CONFIG_PATH ?? CONFIG_PATH;
     const targetDir = dirname(targetPath);
@@ -55,43 +45,3 @@ export async function deleteConfig() {
             throw e;
     }
 }
-export function needsRefresh(cfg) {
-    return !Number.isFinite(cfg.expiresAt) || cfg.expiresAt <= Math.floor(Date.now() / 1000) + REFRESH_SKEW_SECONDS;
-}
-export async function refreshConfig(cfg) {
-    const apiUrl = resolveApiUrl(cfg);
-    let res;
-    try {
-        res = await fetch(`${apiUrl}/api/v1/auth/refresh`, {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ refresh_token: cfg.refreshToken }),
-        });
-    }
-    catch {
-        return null;
-    }
-    if (!res.ok)
-        return null;
-    let data;
-    try {
-        data = (await res.json());
-    }
-    catch {
-        return null;
-    }
-    if (!data.access_token || !data.refresh_token)
-        return null;
-    const expiresAt = Number.isFinite(data.expires_at)
-        ? Number(data.expires_at)
-        : Math.floor(Date.now() / 1000) + (Number.isFinite(data.expires_in) ? Number(data.expires_in) : 3600);
-    const refreshed = {
-        apiUrl,
-        accessToken: data.access_token,
-        refreshToken: data.refresh_token,
-        expiresAt,
-        email: data.email ?? cfg.email ?? null,
-    };
-    await writeConfig(refreshed);
-    return refreshed;
-}