@swarmify/agents-mcp 0.2.13 → 0.2.14

package/README.md

@@ -69,6 +69,29 @@ You control the cost tradeoffs. Expensive models for planning, fast models for e
 
 ## Quick Start
 
+```bash
+npm install -g @swarmify/agents-mcp
+```
+
+That's it. The installer auto-detects Claude, Codex, and Gemini CLIs and registers with each:
+
+```
+@swarmify/agents-mcp - Auto-registering with detected agents...
+
+  Registered with:
+    + Claude Code
+    + Codex
+    + Gemini CLI
+
+  Restart your agent to use Swarm tools.
+```
+
+Uninstalling (`npm uninstall -g @swarmify/agents-mcp`) automatically unregisters from all agents.
+
+### Manual Registration
+
+If auto-registration doesn't work or you need to register with a specific agent:
+
 ```bash
 # Claude Code
 claude mcp add --scope user Swarm -- npx -y @swarmify/agents-mcp
@@ -77,15 +100,12 @@ claude mcp add --scope user Swarm -- npx -y @swarmify/agents-mcp
 codex mcp add swarm -- npx -y @swarmify/agents-mcp@latest
 
 # Gemini CLI
-gemini mcp add Swarm -- npx -y @swarmify/agents-mcp
+gemini mcp add Swarm "npx -y @swarmify/agents-mcp@latest"
 
-# OpenCode
-opencode mcp add
-# Name: Swarm, Command: npx -y @swarmify/agents-mcp
+# Cursor / OpenCode
+# Add manually via their MCP config - Name: Swarm, Command: npx -y @swarmify/agents-mcp
 ```
 
-The server auto-discovers which agent CLIs you have installed. Once connected, your agent gains the ability to spawn and coordinate other agents.
-
 ## What It Costs
 
 This server is free and open source.
@@ -241,7 +261,7 @@ Orchestrator                     SubAgent
      |                              |
      |                         writes to stdout
      |                              |
-     |                         ~/.agents/agents/{id}/stdout.log
+     |                         ~/.agents/swarm/agents/{id}/stdout.log
      |                              |
      +-- Status -----------------> reads log, parses events
      |                              |
@@ -253,7 +273,7 @@ Orchestrator                     SubAgent
 Each agent writes to its own log file (`stdout.log`). The Status tool reads these logs, normalizes events across different agent formats, and returns a summary. This design means:
 
 - **Persistence**: Agents survive IDE restarts. Reconnect via Status/Tasks.
-- **Debugging**: Full logs available at `~/.agents/agents/{id}/`
+- **Debugging**: Full logs available at `~/.agents/swarm/agents/{id}/`
 - **No shared state**: Agents don't talk to each other directly. The orchestrator coordinates.
 
 ### Storage
@@ -281,7 +301,7 @@ Data lives at `~/.agents/`:
 
 ## Configuration
 
-Config lives at `~/.agents/config.json`. See [AGENTS.md](./AGENTS.md) for full config reference.
+Config lives at `~/.agents/swarm/config.json`. See [AGENTS.md](./AGENTS.md) for full config reference.
 
 ## Environment Variables
 

package/dist/hello-world.d.ts

@@ -1,2 +1,2 @@
-export declare function printHelloWorld(): void;
+export {};
 //# sourceMappingURL=hello-world.d.ts.map

package/dist/hello-world.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hello-world.d.ts","sourceRoot":"","sources":["../src/hello-world.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"hello-world.d.ts","sourceRoot":"","sources":["../src/hello-world.ts"],"names":[],"mappings":""}

package/dist/hello-world.js

@@ -1,7 +1,5 @@
 import { pathToFileURL } from 'url';
-export function printHelloWorld() {
-    console.log('hello world');
-}
+import { printHelloWorld } from './hello.js';
 const invokedPath = process.argv[1];
 if (invokedPath) {
     const invokedFileUrl = pathToFileURL(invokedPath).href;

package/dist/hello-world.js.map

@@ -1 +1 @@
-{"version":3,"file":"hello-world.js","sourceRoot":"","sources":["../src/hello-world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAEvD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;QACvC,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}
+{"version":3,"file":"hello-world.js","sourceRoot":"","sources":["../src/hello-world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAEvD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;QACvC,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/hello.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hello.d.ts","sourceRoot":"","sources":["../src/hello.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"hello.d.ts","sourceRoot":"","sources":["../src/hello.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/hello.js

@@ -1,4 +1,12 @@
+import { pathToFileURL } from 'url';
 export function printHelloWorld() {
     console.log('hello world');
 }
+const invokedPath = process.argv[1];
+if (invokedPath) {
+    const invokedFileUrl = pathToFileURL(invokedPath).href;
+    if (import.meta.url === invokedFileUrl) {
+        printHelloWorld();
+    }
+}
 //# sourceMappingURL=hello.js.map

package/dist/hello.js.map

@@ -1 +1 @@
-{"version":3,"file":"hello.js","sourceRoot":"","sources":["../src/hello.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"hello.js","sourceRoot":"","sources":["../src/hello.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAEvD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;QACvC,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/hello_world.d.ts

@@ -1,2 +1,2 @@
-export declare function printHelloWorld(): void;
+export {};
 //# sourceMappingURL=hello_world.d.ts.map

package/dist/hello_world.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hello_world.d.ts","sourceRoot":"","sources":["../src/hello_world.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"hello_world.d.ts","sourceRoot":"","sources":["../src/hello_world.ts"],"names":[],"mappings":""}

package/dist/hello_world.js

@@ -1,7 +1,5 @@
 import { pathToFileURL } from 'url';
-export function printHelloWorld() {
-    console.log('hello world');
-}
+import { printHelloWorld } from './hello.js';
 const invokedPath = process.argv[1];
 if (invokedPath) {
     const invokedFileUrl = pathToFileURL(invokedPath).href;

package/dist/hello_world.js.map

@@ -1 +1 @@
-{"version":3,"file":"hello_world.js","sourceRoot":"","sources":["../src/hello_world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAEvD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;QACvC,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}
+{"version":3,"file":"hello_world.js","sourceRoot":"","sources":["../src/hello_world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpC,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAEvD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,cAAc,EAAE,CAAC;QACvC,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmify/agents-mcp",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "True multi-agent coding in your IDE. Spawn Claude, Codex, Gemini, and Cursor agents from a single MCP server.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,8 @@
     "agents-mcp": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "scripts"
   ],
   "type": "module",
   "repository": {
@@ -23,6 +24,8 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "tsc",
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js",
     "start": "node dist/index.js",
     "test": "bun test",
     "hello": "bun run src/hello-world.ts"

package/scripts/build.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# Build and install the Swarm MCP server
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SWARM_DIR="$(dirname "$SCRIPT_DIR")"
+
+echo "Building Swarm MCP server..."
+cd "$SWARM_DIR"
+
+# Install dependencies
+bun install
+
+# Build TypeScript
+bun run build
+
+echo "Build complete: $SWARM_DIR/dist/"
+echo ""
+echo "To use this MCP server, add to your Claude Code config:"
+echo "  command: bun"
+echo "  args: [\"run\", \"$SWARM_DIR/dist/server.js\"]"

package/scripts/postinstall.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for @swarmify/agents-mcp
+ * Detects installed agent CLIs and registers this MCP server with each.
+ */
+
+import { execSync, spawnSync } from 'child_process';
+
+const MCP_NAME = 'Swarm';
+const MCP_COMMAND = 'npx -y @swarmify/agents-mcp@latest';
+
+// Agent configurations: CLI name, detection command, register command
+const AGENTS = {
+  claude: {
+    name: 'Claude Code',
+    cli: 'claude',
+    register: `claude mcp add --scope user ${MCP_NAME} -- ${MCP_COMMAND}`,
+    unregister: `claude mcp remove ${MCP_NAME} --scope user`,
+  },
+  codex: {
+    name: 'Codex',
+    cli: 'codex',
+    register: `codex mcp add ${MCP_NAME.toLowerCase()} -- ${MCP_COMMAND}`,
+    unregister: `codex mcp remove ${MCP_NAME.toLowerCase()}`,
+  },
+  gemini: {
+    name: 'Gemini CLI',
+    cli: 'gemini',
+    register: `gemini mcp add ${MCP_NAME} "${MCP_COMMAND}"`,
+    unregister: `gemini mcp remove ${MCP_NAME}`,
+  },
+};
+
+function isCliInstalled(cli) {
+  try {
+    execSync(`which ${cli}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function registerWithAgent(agentId, config) {
+  try {
+    const result = spawnSync('sh', ['-c', config.register], {
+      stdio: 'pipe',
+      timeout: 30000,
+    });
+
+    if (result.status === 0) {
+      return { success: true };
+    } else {
+      const stderr = result.stderr?.toString() || '';
+      if (stderr.includes('already exists') || stderr.includes('already registered')) {
+        return { success: true, alreadyExists: true };
+      }
+      return { success: false, error: stderr || 'Unknown error' };
+    }
+  } catch (err) {
+    return { success: false, error: err.message };
+  }
+}
+
+function main() {
+  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
+    return;
+  }
+
+  if (process.env.AGENTS_MCP_SKIP_POSTINSTALL === '1') {
+    return;
+  }
+
+  console.log('\n@swarmify/agents-mcp - Auto-registering with detected agents...\n');
+
+  const detected = [];
+  const registered = [];
+  const skipped = [];
+  const failed = [];
+
+  for (const [agentId, config] of Object.entries(AGENTS)) {
+    if (isCliInstalled(config.cli)) {
+      detected.push(config.name);
+      const result = registerWithAgent(agentId, config);
+
+      if (result.success) {
+        if (result.alreadyExists) {
+          skipped.push(`${config.name} (already registered)`);
+        } else {
+          registered.push(config.name);
+        }
+      } else {
+        failed.push(`${config.name}: ${result.error}`);
+      }
+    }
+  }
+
+  if (detected.length === 0) {
+    console.log('  No supported agent CLIs detected.');
+    console.log('  Install Claude, Codex, or Gemini CLI, then run:');
+    console.log('    npx @swarmify/agents-mcp --register\n');
+    return;
+  }
+
+  if (registered.length > 0) {
+    console.log('  Registered with:');
+    for (const name of registered) {
+      console.log(`    + ${name}`);
+    }
+  }
+
+  if (skipped.length > 0) {
+    console.log('  Already registered:');
+    for (const name of skipped) {
+      console.log(`    - ${name}`);
+    }
+  }
+
+  if (failed.length > 0) {
+    console.log('  Failed:');
+    for (const msg of failed) {
+      console.log(`    x ${msg}`);
+    }
+  }
+
+  console.log('\n  Restart your agent to use Swarm tools.\n');
+}
+
+main();

package/scripts/preuninstall.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+/**
+ * Preuninstall script for @swarmify/agents-mcp
+ * Unregisters this MCP server from all detected agents.
+ */
+
+import { execSync, spawnSync } from 'child_process';
+
+const MCP_NAME = 'Swarm';
+
+const AGENTS = {
+  claude: {
+    name: 'Claude Code',
+    cli: 'claude',
+    unregister: `claude mcp remove ${MCP_NAME} --scope user`,
+  },
+  codex: {
+    name: 'Codex',
+    cli: 'codex',
+    unregister: `codex mcp remove ${MCP_NAME.toLowerCase()}`,
+  },
+  gemini: {
+    name: 'Gemini CLI',
+    cli: 'gemini',
+    unregister: `gemini mcp remove ${MCP_NAME}`,
+  },
+};
+
+function isCliInstalled(cli) {
+  try {
+    execSync(`which ${cli}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function unregisterFromAgent(config) {
+  try {
+    const result = spawnSync('sh', ['-c', config.unregister], {
+      stdio: 'pipe',
+      timeout: 30000,
+    });
+    return { success: result.status === 0 };
+  } catch {
+    return { success: false };
+  }
+}
+
+function main() {
+  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
+    return;
+  }
+
+  if (process.env.AGENTS_MCP_SKIP_PREUNINSTALL === '1') {
+    return;
+  }
+
+  console.log('\n@swarmify/agents-mcp - Unregistering from agents...\n');
+
+  const removed = [];
+
+  for (const [agentId, config] of Object.entries(AGENTS)) {
+    if (isCliInstalled(config.cli)) {
+      const result = unregisterFromAgent(config);
+      if (result.success) {
+        removed.push(config.name);
+      }
+    }
+  }
+
+  if (removed.length > 0) {
+    console.log('  Unregistered from:');
+    for (const name of removed) {
+      console.log(`    - ${name}`);
+    }
+    console.log('');
+  }
+}
+
+main();

package/scripts/publish.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# Build and publish the Swarm MCP server package to npm
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SWARM_DIR="$(dirname "$SCRIPT_DIR")"
+
+cd "$SWARM_DIR"
+
+if [[ $# -ne 1 ]]; then
+  echo "Usage: $0 x.y.z"
+  exit 1
+fi
+
+VERSION="$1"
+if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "Invalid version: $VERSION"
+  echo "Expected format: x.y.z"
+  exit 1
+fi
+
+if ! command -v bun >/dev/null 2>&1; then
+  echo "bun is required but was not found in PATH"
+  exit 1
+fi
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "npm is required but was not found in PATH"
+  exit 1
+fi
+
+# Ensure dependencies are installed
+bun install
+
+# Build TypeScript output
+rm -rf dist
+bun run build
+
+# Bump package version without git tagging
+npm version "$VERSION" --no-git-tag-version
+
+# Verify npm auth before publishing
+if ! npm whoami >/dev/null 2>&1; then
+  echo "npm login required before publishing"
+  exit 1
+fi
+
+npm publish --access public
+
+echo "Publish complete"