@hasna/swarm

Autonomous swarm orchestrator for headless AI agent CLIs — CLI + MCP server + REST API + web dashboard

Install

npm install -g @hasna/swarm

CLI Usage

swarm --help

• swarm run
• swarm status
• swarm list
• swarm agents
• swarm events
• swarm delete
• swarm attach
• swarm streams

MCP Server

swarm-mcp

12 tools available.

HTTP mode

Shared Streamable HTTP transport for multi-agent sessions (binds localhost only):

swarm-mcp --http
# or: MCP_HTTP=1 swarm-mcp
# port: --port 8838  >  MCP_HTTP_PORT  >  8838 (default)

• Health: GET http://127.0.0.1:8838/health
• MCP: http://127.0.0.1:8838/mcp

REST API

swarm-serve

Cloud Sync

This package supports cloud sync via @hasna/cloud:

cloud setup
cloud sync push --service swarm
cloud sync pull --service swarm

Data Directory

Data is stored in ~/.hasna/swarm/.

License

Apache-2.0 -- see LICENSE