@floomhq/floom 1.0.4 → 1.0.6

package/README.md

@@ -7,6 +7,7 @@ npm install -g @floomhq/floom
 floom init my-skill.md
 floom login
 floom publish my-skill.md
+floom share my-skill --add teammate@example.com
 floom search review
 floom add awesome-skill
 floom setup --target claude --dry-run
@@ -21,6 +22,7 @@ Returns a shareable link like `https://floom.dev/s/ffas93ud`. Anyone with the UR
 - `floom login` — sign in with Google. New accounts are created on first login. Token stored at `~/.floom/config.json`.
 - `floom init [file.md]` — create a starter skill file.
 - `floom publish <file.md>` — upload a Markdown file. Optional `--public` / `--private` / `--unlisted`, `--type knowledge|instruction|workflow|skill`, `--installs-as <target>`, and `--version <label>`.
+- `floom share <slug>` — email-share one of your skills. Optional `--add <email>`, `--remove <email>`, and `--list`.
 - `floom list` — show your published skills. Optional `--json`.
 - `floom add <url-or-slug>` — fetch a skill into `~/.claude/skills/<slug>.md`.
 - `floom info <url-or-slug>` — show skill metadata. Optional `--json`.

package/dist/cli.js

@@ -15,6 +15,7 @@ import { printMcpSetup } from "./mcp.js";
 import { setupAgent } from "./setup.js";
 import { search } from "./search.js";
 import { scanSkill } from "./scan.js";
+import { share } from "./share.js";
 import { libraryAddSkill, libraryCreate, libraryList, libraryRemoveSkill, librarySubscribe, libraryUnsubscribe, moveSkill, } from "./library.js";
 import { c, symbols } from "./ui.js";
 import { printError, FloomError } from "./errors.js";
@@ -23,37 +24,40 @@ const PKG = { name: "@floomhq/floom", version: CLI_VERSION };
 const V1_NOT_AVAILABLE = "Not available in Floom Version 1.";
 function usage() {
     const out = `
- ${c.coral("       ________")}
- ${c.coral("      / ____/ /___  ____  ____ ___")}      ${c.dim(`v${CLI_VERSION}`)}
- ${c.coral("     / /_  / / __ \\/ __ \\/ __ `__ \\")}
- ${c.coral("    / __/ / / /_/ / /_/ / / / / / /")}
- ${c.coral("   /_/   /_/\\____/\\____/_/ /_/ /_/")}
+ ${c.blue("  ________                      ")}
+ ${c.blue(" / ____/ /___  ____  ____ ___  ")} ${c.dim(`v${CLI_VERSION}`)}
+ ${c.blue("/ /_  / / __ \\/ __ \\/ __ `__ \\ ")}
+ ${c.blue("/ __/ / / /_/ / /_/ / / / / / / ")}
+ ${c.blue("/_/   /_/\\____/\\____/_/ /_/ /_/  ")}
 
- ${c.bold("Share AI agent skills with a link.")}
- ${c.dim("Publish knowledge, instructions, and workflows from your terminal.")}
+ ${c.bold("Floom lets you share AI workflows with anyone.")}
+ ${c.dim("A skill is reusable knowledge, instructions, or a workflow for your AI agent.")}
+ ${c.dim("Examples: brand voice, PR review checklist, sales research workflow.")}
 
- ${c.bold("Do this next")}
-   ${c.dim("1. Add a skill someone sent you")}
-      ${c.cyan("npx -y @floomhq/floom add")} ${c.dim("https://floom.dev/s/ffas93ud --target claude")}
+ ${c.bold("You installed Floom. Copy one recipe:")}
 
-   ${c.dim("2. Publish your own skill")}
-      ${c.cyan("npx -y @floomhq/floom init")} ${c.dim("support-tone.md")}
-      ${c.dim("# edit support-tone.md")}
-      ${c.cyan("npx -y @floomhq/floom scan")} ${c.dim("support-tone.md")}
-      ${c.cyan("npx -y @floomhq/floom login")}
-      ${c.cyan("npx -y @floomhq/floom publish")} ${c.dim("support-tone.md --type instruction --public")}
+ ${c.bold("1. I received a Floom link")}
+    ${c.dim("Replace <skill-link> with the full Floom URL someone sent you:")}
+    ${c.cyan("npx -y @floomhq/floom add")} ${c.dim("<skill-link> --setup")}
+    ${c.dim('Then tell Claude Code: "Use my Floom skills when they fit this task."')}
 
-   ${c.dim("3. Tell your agent where skills land")}
-      ${c.cyan("npx -y @floomhq/floom setup")} ${c.dim("--target claude --yes")}
-      ${c.cyan("npx -y @floomhq/floom setup")} ${c.dim("--target codex --yes")}
+ ${c.bold("2. I want to make a share link")}
+    ${c.cyan("npx -y @floomhq/floom init")} ${c.dim("my-skill.md")}
+    ${c.dim("Write what your agent needs to know or do in my-skill.md.")}
+    ${c.cyan("npx -y @floomhq/floom login")}
+    ${c.cyan("npx -y @floomhq/floom publish")} ${c.dim("my-skill.md --public")}
+    ${c.dim("Floom scans it, prints a link, and copies the link when possible.")}
 
- ${c.bold("Safety")}
-   ${c.yellow("!")} ${c.dim("publish scans for API keys, prompt injection, and exfiltration.")}
+ ${c.bold("Good to know")}
+    ${symbols.ok} ${c.dim("No account is needed to add a shared skill.")}
+    ${symbols.ok} ${c.dim("Sign in only when you publish or manage your skills.")}
+    ${symbols.ok} ${c.dim("Every command prints success or the exact problem to fix.")}
 
- ${c.bold("More")}
-   ${c.cyan("floom commands")}    ${c.dim("Full command list")}
-   ${c.cyan("floom doctor")}      ${c.dim("Check auth, API, and local folders")}
-   ${c.dim("Docs")}           https://floom.dev
+ ${c.bold("Stuck?")}
+    ${c.cyan("npx -y @floomhq/floom doctor")}        ${c.dim("Find the problem")}
+    ${c.cyan("npx -y @floomhq/floom scan my-skill.md")} ${c.dim("Check a file before publishing")}
+    ${c.cyan("npx -y @floomhq/floom commands")}      ${c.dim("See every command")}
+    ${c.dim("Step-by-step guide")}                   https://floom.dev/docs/getting-started
 `;
     process.stdout.write(out);
 }
@@ -65,7 +69,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)")}
+                       ${c.dim("Flags: --target claude|codex (default: claude), --setup")}
      ${c.cyan("search")} ${c.dim("<query>")}     Find public skills and libraries
      ${c.cyan("info")} ${c.dim("<url>")}         Show skill metadata
 
@@ -75,6 +79,8 @@ function commandUsage() {
      ${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>")}
+     ${c.cyan("share")} ${c.dim("<slug>")}       Email-share one of your skills
+                       ${c.dim("Flags: --add <email>, --remove <email>, --list")}
 
    ${c.dim("Account")}
      ${c.cyan("login")}              Authenticate
@@ -184,6 +190,43 @@ function parseFlags(argv) {
     }
     return out;
 }
+function parseShareFlags(argv) {
+    const out = { list: false, add: [], remove: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i] ?? "";
+        if (a === "--list") {
+            out.list = true;
+        }
+        else if (a === "--add" || a.startsWith("--add=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--add");
+            out.add.push(value);
+            i = nextIndex;
+        }
+        else if (a === "--remove" || a.startsWith("--remove=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--remove");
+            out.remove.push(value);
+            i = nextIndex;
+        }
+        else if (a.startsWith("--")) {
+            throw new FloomError(`Unknown flag: ${a}`, "Try `floom share <slug> --add person@example.com`.");
+        }
+        else if (!out.slug) {
+            out.slug = a;
+        }
+        else {
+            throw new FloomError(`Unexpected argument: ${a}`, "Try `floom share <slug> --add person@example.com`.");
+        }
+    }
+    if (!out.slug)
+        throw new FloomError("Missing skill slug.", "Try `floom share <slug> --add person@example.com`.");
+    if (out.list && (out.add.length > 0 || out.remove.length > 0)) {
+        throw new FloomError("Conflicting share flags.", "Use --list by itself, or use --add/--remove.");
+    }
+    if (!out.list && out.add.length === 0 && out.remove.length === 0) {
+        throw new FloomError("Missing share action.", "Try `floom share <slug> --add person@example.com`.");
+    }
+    return out;
+}
 function parseInitArgs(argv) {
     let file;
     for (const a of argv) {
@@ -228,6 +271,7 @@ function parseInfoFlags(argv) {
 function parseAddArgs(argv) {
     let slug;
     let target;
+    let setup = false;
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i] ?? "";
         if (a === "--target" || a.startsWith("--target=")) {
@@ -238,19 +282,22 @@ function parseAddArgs(argv) {
             target = value;
             i = nextIndex;
         }
+        else if (a === "--setup") {
+            setup = true;
+        }
         else if (a.startsWith("--")) {
-            throw new FloomError(`Unknown flag: ${a}`, "Try `floom add <url-or-slug> --target claude`.");
+            throw new FloomError(`Unknown flag: ${a}`, "Try `floom add <url-or-slug> --setup`.");
         }
         else if (slug) {
-            throw new FloomError(`Unexpected argument: ${a}`, "Try `floom add <url-or-slug> --target claude`.");
+            throw new FloomError(`Unexpected argument: ${a}`, "Try `floom add <url-or-slug> --setup`.");
         }
         else
             slug = a;
     }
     if (!slug) {
-        throw new FloomError("Missing skill slug.", "Try: `floom add <url-or-slug> --target claude`");
+        throw new FloomError("Missing skill slug.", "Try: `floom add <url-or-slug> --setup`");
     }
-    return target ? { slug, target } : { slug };
+    return target ? { slug, target, setup } : { slug, setup };
 }
 function parseSearchFlags(argv) {
     const out = { json: false };
@@ -625,7 +672,16 @@ async function main() {
                 return;
             }
             case "share":
-                notAvailable("`floom share`");
+                {
+                    const flags = parseShareFlags(rest);
+                    if (flags.list) {
+                        await share({ slug: flags.slug ?? "", kind: "list" });
+                    }
+                    else {
+                        await share({ slug: flags.slug ?? "", kind: "patch", add: flags.add, remove: flags.remove });
+                    }
+                }
+                return;
             case "list": {
                 const flags = parseListFlags(rest);
                 await list(flags);
@@ -653,7 +709,13 @@ async function main() {
             case "add":
             case "install": {
                 const flags = parseAddArgs(rest);
-                await install(flags.slug, flags.target ? { target: flags.target } : {});
+                await install(flags.slug, {
+                    ...(flags.target ? { target: flags.target } : {}),
+                    setup: flags.setup,
+                });
+                if (flags.setup) {
+                    await setupAgent({ target: flags.target ?? "claude", dryRun: false, yes: true });
+                }
                 return;
             }
             case "sync":

package/dist/install.js

@@ -201,6 +201,12 @@ export async function install(slugInput, opts = {}) {
     process.stdout.write(`\n${symbols.ok}  [floom] ${action} ${c.bold(slug)}\n`);
     process.stdout.write(`   ${c.dim(target)}\n\n`);
     process.stdout.write(`   ${c.bold("Next")}\n`);
-    process.stdout.write(`   ${c.dim("1.")} Tell your agent to use ${c.bold(slug)} when it matches the task.\n`);
-    process.stdout.write(`   ${c.dim("2.")} One-time setup: ${c.cyan(setupCommand(targetAgent))}\n\n`);
+    if (opts.setup) {
+        process.stdout.write(`   ${c.dim("1.")} Floom is connecting ${targetAgent === "claude" ? "Claude Code" : "Codex"} now.\n`);
+        process.stdout.write(`   ${c.dim("2.")} Tell your agent to use ${c.bold(slug)} when it matches the task.\n\n`);
+    }
+    else {
+        process.stdout.write(`   ${c.dim("1.")} Tell your agent to use ${c.bold(slug)} when it matches the task.\n`);
+        process.stdout.write(`   ${c.dim("2.")} One-time setup: ${c.cyan(setupCommand(targetAgent))}\n\n`);
+    }
 }

package/dist/ui.js

@@ -1,12 +1,9 @@
 import pc from "picocolors";
-// Coral / teal palette to match the warm Lovable vibe.
-// picocolors only supports ANSI named colors, so we map:
-// - coral / primary action: yellow (warm) for the dot, red for emphasis when needed
-// - success: green
-// - muted: gray (dim)
+// Cool, restrained terminal palette. Keep orange out of the default CLI surface.
 const isTty = process.stdout.isTTY === true;
 export const c = {
-    coral: (s) => (isTty ? `\x1b[38;5;209m${s}\x1b[0m` : s),
+    coral: (s) => (isTty ? `\x1b[38;5;45m${s}\x1b[0m` : s),
+    blue: (s) => (isTty ? `\x1b[38;5;75m${s}\x1b[0m` : s),
     teal: (s) => (isTty ? `\x1b[38;5;73m${s}\x1b[0m` : s),
     green: pc.green,
     red: pc.red,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/floom",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Publish AI skills from your terminal. Share with a link.",
   "license": "MIT",
   "type": "module",