@desplega.ai/agent-swarm 1.0.1

package/.claude/settings.local.json

@@ -0,0 +1,80 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__agent-swarm__*",
+      "Bash(bun run tsc:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "agent-swarm"
+  ],
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun run \"$CLAUDE_PROJECT_DIR\"/src/hooks/hook.ts"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2

package/.env.example

@@ -0,0 +1,9 @@
+# Define your API key or leave empty for no auth
+API_KEY=
+
+# Server port (default: 3013)
+PORT=3013
+
+# MCP Base URL for remote server (used by setup command)
+# Default: https://agent-swarm-mcp.desplega.sh
+MCP_BASE_URL=

package/CLAUDE.md

@@ -0,0 +1,111 @@
+---
+description: Use Bun instead of Node.js, npm, pnpm, or vite.
+globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
+alwaysApply: false
+---
+
+Default to using Bun instead of Node.js.
+
+- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
+- Use `bun test` instead of `jest` or `vitest`
+- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
+- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
+- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
+- Bun automatically loads .env, so don't use dotenv.
+
+## APIs
+
+- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
+- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
+- `Bun.redis` for Redis. Don't use `ioredis`.
+- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
+- `WebSocket` is built-in. Don't use `ws`.
+- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
+- Bun.$`ls` instead of execa.
+
+## Testing
+
+Use `bun test` to run tests.
+
+```ts#index.test.ts
+import { test, expect } from "bun:test";
+
+test("hello world", () => {
+  expect(1).toBe(1);
+});
+```
+
+## Frontend
+
+Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
+
+Server:
+
+```ts#index.ts
+import index from "./index.html"
+
+Bun.serve({
+  routes: {
+    "/": index,
+    "/api/users/:id": {
+      GET: (req) => {
+        return new Response(JSON.stringify({ id: req.params.id }));
+      },
+    },
+  },
+  // optional websocket support
+  websocket: {
+    open: (ws) => {
+      ws.send("Hello, world!");
+    },
+    message: (ws, message) => {
+      ws.send(message);
+    },
+    close: (ws) => {
+      // handle close
+    }
+  },
+  development: {
+    hmr: true,
+    console: true,
+  }
+})
+```
+
+HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
+
+```html#index.html
+<html>
+  <body>
+    <h1>Hello, world!</h1>
+    <script type="module" src="./frontend.tsx"></script>
+  </body>
+</html>
+```
+
+With the following `frontend.tsx`:
+
+```tsx#frontend.tsx
+import React from "react";
+
+// import .css files directly and it works
+import './index.css';
+
+import { createRoot } from "react-dom/client";
+
+const root = createRoot(document.body);
+
+export default function Frontend() {
+  return <h1>Hello, world!</h1>;
+}
+
+root.render(<Frontend />);
+```
+
+Then, run index.ts
+
+```sh
+bun --hot ./index.ts
+```
+
+For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.

package/README.md

@@ -0,0 +1,141 @@
+# Agent Swarm MCP
+
+> Agent orchestration layer MCP for Claude Code, Codex, Gemini CLI, and more!
+
+## Overview
+
+Agent Swarm MCP enables multi-agent coordination for AI coding assistants. It provides tools for agents to join a swarm, receive tasks, report progress, and coordinate with a lead agent.
+
+## Quick Start
+
+### Setup (Recommended)
+
+Run the setup command in your project directory:
+
+```bash
+bunx @desplega.ai/agent-swarm@latest setup
+```
+
+This will:
+- Create `.claude` directory and `settings.local.json` if needed
+- Create `.mcp.json` if needed
+- Add entries to `.gitignore`
+- Configure permissions and hooks
+- Prompt for your API token and Agent ID
+
+Options:
+- `--dry-run` - Preview changes without writing
+- `--restore` - Restore files from `.bak` backups
+
+### Manual Installation
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "agent-swarm": {
+      "type": "http",
+      "url": "https://agent-swarm-mcp.desplega.sh/mcp",
+      "headers": {
+        "Authorization": "Bearer <your-token>",
+        "X-Agent-ID": "<your-agent-id>"
+      }
+    }
+  }
+}
+```
+
+## CLI Commands
+
+```bash
+# Run setup wizard
+bunx @desplega.ai/agent-swarm setup
+
+# Preview setup changes
+bunx @desplega.ai/agent-swarm setup --dry-run
+
+# Restore from backups
+bunx @desplega.ai/agent-swarm setup --restore
+
+# Start MCP HTTP server (for self-hosting)
+bunx @desplega.ai/agent-swarm mcp
+bunx @desplega.ai/agent-swarm mcp --port 8080 --key my-api-key
+
+# Run Claude CLI with swarm integration
+bunx @desplega.ai/agent-swarm claude
+bunx @desplega.ai/agent-swarm claude --headless -m "Hello"
+
+# Hook handler (called by Claude Code hooks)
+bunx @desplega.ai/agent-swarm hook
+
+# Show help
+bunx @desplega.ai/agent-swarm help
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MCP_BASE_URL` | Base URL for the MCP server | `https://agent-swarm-mcp.desplega.sh` |
+| `PORT` | Port for self-hosted MCP server | `3013` |
+| `API_KEY` | API key for server authentication | - |
+
+## Development
+
+Install dependencies:
+
+```bash
+bun install
+```
+
+Run the STDIO server:
+
+```bash
+bun run start
+```
+
+Run the HTTP server:
+
+```bash
+bun run start:http
+```
+
+Run with hot reload:
+
+```bash
+bun run dev      # STDIO
+bun run dev:http # HTTP
+```
+
+Run the MCP inspector:
+
+```bash
+bun run inspector      # STDIO
+bun run inspector:http # HTTP
+```
+
+Run the CLI locally:
+
+```bash
+bun run cli setup
+bun run cli setup --dry-run
+bun run hook  # Hook handler
+```
+
+## MCP Tools
+
+The server provides these tools for agent coordination:
+
+- `join-swarm` - Register an agent in the swarm
+- `poll-task` - Poll for assigned tasks (worker agents)
+- `send-task` - Assign a task to an agent (lead agent)
+- `get-swarm` - List all agents in the swarm
+- `get-tasks` - List tasks filtered by status
+- `get-task-details` - Get detailed info about a task
+- `store-progress` - Update task progress or mark complete/failed
+- `my-agent-info` - Get current agent's info
+
+## License
+
+MIT License, 2025-2026 (c) desplega.ai

package/biome.json

@@ -0,0 +1,36 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.3.9/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "space",
+		"indentWidth": 2,
+		"lineWidth": 100
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}

package/example-req-meta.json

@@ -0,0 +1,24 @@
+{
+  "meta": {
+    "signal": {},
+    "sessionId": "942c8196-66ad-4c1f-b31e-7331ce7f4bb9",
+    "_meta": {
+      "progressToken": 3
+    },
+    "requestId": 3,
+    "requestInfo": {
+      "headers": {
+        "accept": "application/json, text/event-stream",
+        "accept-encoding": "gzip, deflate, br",
+        "authorization": "Bearer 123123",
+        "connection": "keep-alive",
+        "content-length": "119",
+        "content-type": "application/json",
+        "host": "localhost:3013",
+        "mcp-protocol-version": "2025-11-25",
+        "mcp-session-id": "942c8196-66ad-4c1f-b31e-7331ce7f4bb9",
+        "user-agent": "node-fetch"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@desplega.ai/agent-swarm",
+  "version": "1.0.1",
+  "description": "Agent orchestration layer MCP for Claude Code, Codex, Gemini CLI, and more!",
+  "module": "src/stdio.ts",
+  "type": "module",
+  "bin": {
+    "agent-swarm": "./src/cli.tsx"
+  },
+  "@desplega.ai/agent-swarm": "link:@desplega.ai/agent-swarm",
+  "config": {
+    "name": "agent-swarm"
+  },
+  "scripts": {
+    "tsc:check": "bun tsc --noEmit",
+    "cli": "bun src/cli.tsx",
+    "hook": "bun src/hooks/hook.ts",
+    "claude": "bun src/cli.tsx claude",
+    "claude:headless": "bun src/cli.tsx claude --headless",
+    "dev": "bun --hot src/stdio.ts",
+    "dev:http": "bun --hot src/http.ts",
+    "start": "bun src/stdio.ts",
+    "start:http": "bun src/http.ts",
+    "inspector": "bunx @modelcontextprotocol/inspector --transport stdio bun src/stdio.ts",
+    "inspector:http": "bunx @modelcontextprotocol/inspector --transport http http://localhost:3013/mcp",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "format": "biome format --write src"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.9",
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@inkjs/ui": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@types/react": "^19.2.7",
+    "date-fns": "^4.1.0",
+    "ink": "^6.5.1",
+    "react": "^19.2.3",
+    "zod": "^4.2.1"
+  }
+}