@floomhq/floom-mcp-sync 1.0.4 → 1.0.6

package/README.md

@@ -6,7 +6,13 @@ Tiny MCP server for Floom skills. This package is part of the Floom Version 1 sy
 npx -y @floomhq/floom-mcp-sync
 ```
 
-On startup it reads `~/.floom/config.json`, fetches published, saved, and subscribed library skills, and writes missing files to `~/.claude/skills/`. The background sync behavior is a Version 1 preview path.
+On startup it reads `~/.floom/config.json`, fetches published, saved, and followed library skills, and writes missing files to the configured local skills directory. Account-backed sync requires `npx -y @floomhq/floom login`. Public and unlisted shared-link installs still work through `floom_install_skill` without an account. The background sync behavior is a Version 1 preview path.
+
+Targets:
+
+- default: Claude Code, `~/.claude/skills/`
+- Codex: `FLOOM_TARGET=codex npx -y @floomhq/floom-mcp-sync`, `~/.codex/skills/`
+- direct override: `FLOOM_SKILLS_DIR=/path/to/skills npx -y @floomhq/floom-mcp-sync`
 
 Sync stores a machine-local manifest next to the Floom CLI config at `~/.floom/sync-manifest.json`.
 Version 1 sync does not replace existing local Markdown files. Remote updates, existing untracked
@@ -22,15 +28,15 @@ Tools:
 - `floom_search_skills(query, library?, type?, limit?)` searches `/api/v1/search` and returns compact skill hits with slug, title, description, library placement, folder, and install URL.
   - `type`: `knowledge`, `instruction`, `workflow`, or `skill`
   - `limit`: 1-50
-- `floom_install_skill(slug)` fetches `/s/<slug>.md` and writes it locally.
-- `floom_publish_skill(name, content, description?, visibility?, asset_type?, installs_as?, version?)` publishes Markdown through `/api/skills`.
+- `floom_install_skill(slug)` fetches `/s/<slug>.md` and writes it locally. Public and unlisted skills do not require an account.
+- `floom_publish_skill(name, content, description?, visibility?, asset_type?, installs_as?, version?)` publishes Markdown through `/api/skills` for the signed-in Floom account.
   - `asset_type`: `knowledge`, `instruction`, `workflow`, or `skill` (default `skill`)
   - `installs_as`: `claude_skill`, `memory`, `rule`, `codex_instruction`, `opencode_instruction`, `cursor_rule`, or `other` (default `claude_skill`)
   - `version`: optional label like `1.0.0` or `v1-preview`
 
 - `floom_list_libraries()` lists public Floom libraries.
-- `floom_subscribe_library(slug)` subscribes the signed-in user so the library syncs locally.
-- `floom_unsubscribe_library(slug)` removes that subscription.
+- `floom_subscribe_library(slug)` follows a library for the signed-in user so the library syncs locally.
+- `floom_unsubscribe_library(slug)` unfollows that library.
 - `floom_move_skill(slug, folder, tags?)` sets the signed-in user's local folder/tags override.
 
 Team workspaces, share invites, and role-based library access are planned for a later Floom version.

package/dist/lib/paths.js

@@ -4,7 +4,21 @@ import { assertValidSlug } from "./slug.js";
 export function configPath() {
     return process.env.FLOOM_CONFIG_PATH ?? join(homedir(), ".floom", "config.json");
 }
+export function agentTarget() {
+    const raw = (process.env.FLOOM_TARGET ?? process.env.FLOOM_AGENT_TARGET ?? "claude").toLowerCase();
+    if (raw === "codex")
+        return "codex";
+    if (raw === "claude")
+        return "claude";
+    throw new Error("Invalid FLOOM_TARGET. Use claude or codex.");
+}
 export function skillsDir() {
+    if (process.env.FLOOM_SKILLS_DIR)
+        return process.env.FLOOM_SKILLS_DIR;
+    if (agentTarget() === "codex") {
+        const codexHome = process.env.CODEX_HOME ?? join(homedir(), ".codex");
+        return process.env.CODEX_SKILLS_DIR ?? join(codexHome, "skills");
+    }
     return process.env.CLAUDE_SKILLS_DIR ?? join(homedir(), ".claude", "skills");
 }
 export function skillPath(slug) {

package/dist/server.js

@@ -6,7 +6,8 @@ import { installSkill } from "./tools/install.js";
 import { publishSkill } from "./tools/publish.js";
 import { listLibraries, moveSkill, subscribeLibrary, unsubscribeLibrary, } from "./tools/libraries.js";
 import { searchSkills } from "./tools/search.js";
-const SERVER_VERSION = "1.0.4";
+import { agentTarget, skillsDir } from "./lib/paths.js";
+const SERVER_VERSION = "1.0.6";
 const DEFAULT_INTERVAL_MS = 60_000;
 const MIN_INTERVAL_MS = 10_000;
 const VERSION_RE = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$/;
@@ -33,7 +34,9 @@ Usage
 
 Behavior
   Starts a stdio MCP server.
-  Syncs published, saved, and subscribed library skills into ~/.claude/skills/.
+  Syncs published, saved, and followed library skills into the configured local skills directory.
+  Requires a signed-in Floom CLI account for account-backed sync.
+  Public and unlisted shared-link installs still work through floom_install_skill without an account.
   Polls for updates while the MCP process is running.
 
 Options
@@ -42,6 +45,10 @@ Options
 
 Env
   FLOOM_API_URL              Override the API host.
+  FLOOM_TARGET               claude or codex. Default: claude.
+  FLOOM_SKILLS_DIR           Override the local skills directory directly.
+  CLAUDE_SKILLS_DIR          Override Claude's skills directory.
+  CODEX_SKILLS_DIR           Override Codex's skills directory.
   FLOOM_SYNC_INTERVAL_MS     Poll interval in milliseconds. Minimum: 10000.
 `.trimStart();
 }
@@ -96,7 +103,7 @@ function toolList() {
         tools: [
             {
                 name: "floom_search_skills",
-                description: "Search public Floom skills through the live API.",
+                description: "Search public Floom skills before recreating reusable behavior from scratch.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -111,7 +118,7 @@ function toolList() {
             },
             {
                 name: "floom_install_skill",
-                description: "Fetch a Floom skill by slug and install it into ~/.claude/skills/.",
+                description: "Fetch a Floom skill by slug and install it into the configured local skills directory. Public and unlisted links do not require an account.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -123,7 +130,7 @@ function toolList() {
             },
             {
                 name: "floom_publish_skill",
-                description: "Publish Markdown content to Floom as a skill.",
+                description: "Publish Markdown content to the signed-in Floom account as a skill. Requires CLI login/config.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -150,7 +157,7 @@ function toolList() {
             },
             {
                 name: "floom_subscribe_library",
-                description: "Subscribe the signed-in user to a Floom library so it syncs locally.",
+                description: "Follow a Floom library for the signed-in user so its skills sync locally.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -162,7 +169,7 @@ function toolList() {
             },
             {
                 name: "floom_unsubscribe_library",
-                description: "Unsubscribe the signed-in user from a Floom library.",
+                description: "Unfollow a Floom library for the signed-in user.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -319,7 +326,12 @@ async function handleRequest(message) {
             stdout.write(response(id, {
                 protocolVersion: "2025-06-18",
                 capabilities: { tools: {} },
-                serverInfo: { name: "floom-mcp-sync", version: SERVER_VERSION },
+                serverInfo: {
+                    name: "floom-mcp-sync",
+                    version: SERVER_VERSION,
+                    target: agentTarget(),
+                    skillsDir: skillsDir(),
+                },
             }));
             return;
         }
@@ -345,7 +357,7 @@ async function main() {
     if (handleCliArgs(process.argv.slice(2)))
         return;
     const intervalMs = resolvePollIntervalMs();
-    process.stderr.write(`[floom] starting sync poller (interval ${intervalMs}ms)\n`);
+    process.stderr.write(`[floom] starting sync poller for ${agentTarget()} at ${skillsDir()} (interval ${intervalMs}ms)\n`);
     const syncState = { inFlight: true };
     void autoSync().catch((err) => {
         process.stderr.write(`[floom] initial sync failed: ${err instanceof Error ? err.message : String(err)}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/floom-mcp-sync",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Lightweight Floom MCP server for installing, publishing, and startup-syncing skills.",
   "license": "MIT",
   "type": "module",