@floomhq/floom-mcp-sync 1.0.3 → 1.0.5

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 subscribed library skills, and writes missing files to the configured local skills directory. 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

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.2";
+import { agentTarget, skillsDir } from "./lib/paths.js";
+const SERVER_VERSION = "1.0.5";
 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,7 @@ Usage
 
 Behavior
   Starts a stdio MCP server.
-  Syncs published, saved, and subscribed library skills into ~/.claude/skills/.
+  Syncs published, saved, and subscribed library skills into the configured local skills directory.
   Polls for updates while the MCP process is running.
 
 Options
@@ -42,6 +43,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 +101,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 +116,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.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -319,7 +324,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 +355,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.3",
+  "version": "1.0.5",
   "description": "Lightweight Floom MCP server for installing, publishing, and startup-syncing skills.",
   "license": "MIT",
   "type": "module",