Releases · desplega-ai/agent-swarm

GitHub

17 min read Original article ↗

v2.7.4

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.7.4
# or install globally
npm i -g @desplega.ai/agent-swarm@2.7.4

bun:

bunx @desplega.ai/agent-swarm@2.7.4
# or install globally
bun i -g @desplega.ai/agent-swarm@2.7.4

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.7.4
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.7.4
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.7.4

E2B templates:

# API
agent-swarm-api-2-7-4
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-7-4
agent-swarm-worker-latest

agent-fs

Ships agent-fs 0.18.13 (bumped from 0.18.12).

agent-swarm pins agent-fs via the chart image tag and npm packages @desplega.ai/agent-fs and @desplega.ai/agent-fs-just-bash; each agent-fs release needs a chore(deps): bump agent-fs pins PR here.


What's Changed

New Contributors

Full Changelog: v2.7.3...v2.7.4

v2.7.3

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.7.3
# or install globally
npm i -g @desplega.ai/agent-swarm@2.7.3

bun:

bunx @desplega.ai/agent-swarm@2.7.3
# or install globally
bun i -g @desplega.ai/agent-swarm@2.7.3

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.7.3
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.7.3
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.7.3

E2B templates:

# API
agent-swarm-api-2-7-3
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-7-3
agent-swarm-worker-latest

agent-fs

Ships agent-fs 0.18.12 (bumped from 0.18.11).

agent-swarm pins agent-fs via the chart image tag and npm packages @desplega.ai/agent-fs and @desplega.ai/agent-fs-just-bash; each agent-fs release needs a chore(deps): bump agent-fs pins PR here.


What's Changed

New Contributors

Full Changelog: v2.7.2...v2.7.3

v2.7.2

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.7.2
# or install globally
npm i -g @desplega.ai/agent-swarm@2.7.2

bun:

bunx @desplega.ai/agent-swarm@2.7.2
# or install globally
bun i -g @desplega.ai/agent-swarm@2.7.2

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.7.2
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.7.2
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.7.2

E2B templates:

# API
agent-swarm-api-2-7-2
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-7-2
agent-swarm-worker-latest

What's Changed

Full Changelog: v2.7.1...v2.7.2

v2.7.1

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.7.1
# or install globally
npm i -g @desplega.ai/agent-swarm@2.7.1

bun:

bunx @desplega.ai/agent-swarm@2.7.1
# or install globally
bun i -g @desplega.ai/agent-swarm@2.7.1

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.7.1
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.7.1
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.7.1

E2B templates:

# API
agent-swarm-api-2-7-1
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-7-1
agent-swarm-worker-latest

What's Changed

  • docs(specs): sync TLA+ specs with main (heartbeat, workflows) by @desplega-bot in #2483
  • fix(setup): switch all agents to the first credential's harness by @tarasyarema in #2460
  • fix(fs): return pending invite state and accept link from members/invite by @desplega-bot in #2478
  • chore(docker): bump claude-code, cursor, amp, copilot, kiro (2026-10-27) by @desplega-bot in #2481
  • fix(runner): preserve pi-mono session cost when long lead session settles or aborts (#2073) by @duongynhi000005-oss in #2480
  • fix(prompts): codemode tool-discovery line for codex and opencode by @desplega-bot in #2457
  • fix(codex): identify OAuth pool slots in terminal auth errors by @ZedingZhang in #2482
  • feat(memory): skip store-progress learnings that near-duplicate a swarm memory by @desplega-bot in #2485
  • feat(onboarding): bundle agent-fs and local embeddings, add team invites by @tarasyarema in #2442
  • release: v2.7.1 + docs daily update 2026-10-27 by @desplega-bot in #2486

Full Changelog: v2.7.0...v2.7.1

v2.7.0

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.7.0
# or install globally
npm i -g @desplega.ai/agent-swarm@2.7.0

bun:

bunx @desplega.ai/agent-swarm@2.7.0
# or install globally
bun i -g @desplega.ai/agent-swarm@2.7.0

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.7.0
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.7.0
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.7.0

E2B templates:

# API
agent-swarm-api-2-7-0
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-7-0
agent-swarm-worker-latest

What's Changed

New Contributors

Full Changelog: v2.6.0...v2.7.0

v2.6.0

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.6.0
# or install globally
npm i -g @desplega.ai/agent-swarm@2.6.0

bun:

bunx @desplega.ai/agent-swarm@2.6.0
# or install globally
bun i -g @desplega.ai/agent-swarm@2.6.0

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.6.0
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.6.0
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.6.0

E2B templates:

# API
agent-swarm-api-2-6-0
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-6-0
agent-swarm-worker-latest

What's Changed

  • docs(specs): sync TLA+ specs with main (heartbeat, workflows) by @desplega-bot in #2413
  • chore(evals): publish benchmark 1.0 from weekly run run-202610250200-3822d6 by @desplega-bot in #2414
  • chore(docker): bump amp, qwen (2026-10-25) by @desplega-bot in #2411
  • chore: re-pin researching skill retrieval guidance by @desplega-bot in #2410
  • docs: verify skill writes in script guide by @desplega-bot in #2409
  • fix(workflows): break startedAt ties by rowid when reading run steps by @dev-petrov in #2416
  • feat(tasks): filter GET /api/tasks by workflowRunId by @dev-petrov in #2417
  • feat(db-retention): opt-in retention for finished script_runs by @desplega-bot in #2404
  • feat(comb): search, share links, audio and HTML preview, uploads by @tarasyarema in #2406
  • fix(onboarding): clean install and /setup flow for new users by @tarasyarema in #2405
  • feat(extensions): expose Slack messages in task creation hooks by @ZedingZhang in #2412
  • feat(sessions): Slack and chat source sections, source keys, and backfill by @tarasyarema in #2408
  • feat(comb): send any comment, bulk resolve, In progress home, Recent and Favorites by @tarasyarema in #2420
  • chore(docker): bump amp (2026-10-25) by @desplega-bot in #2421
  • fix(sessions): readable thread group labels, the phone filter button, and thread group docs by @tarasyarema in #2423
  • fix(credentials): test each pool key, re-test on change, check Claude tokens by @tarasyarema in #2422
  • fix(claude): seed trust in the session HOME, not the host ~/.claude.json by @tarasyarema in #2424
  • feat(codex): route Codex through a gateway with CODEX_GATEWAY_BASE_URL by @desplega-bot in #2426
  • fix(tests): retry the API spawn when its free port is taken by @desplega-bot in #2427
  • feat(comb): file menu, filters, search in the URL, agent-fs stars, asset comments by @tarasyarema in #2428
  • docs(readme): add the launch video asset by @tarasyarema in #2429
  • docs(readme): launch video as the README hero by @tarasyarema in #2431
  • feat(workflows): read a run tree via GET /api/workflow-runs/{id}/tree by @dev-petrov in #2419
  • fix(workflows): do not retry a sub-workflow step whose child run was deleted by @dev-petrov in #2433
  • feat(workflows): add fields=slim to GET /api/workflow-runs/{id} by @dev-petrov in #2418
  • feat(credentials): list, add and remove single pool keys, with an instant key check by @tarasyarema in #2430
  • docs: Release Notes — Week of October 19 to October 26, 2026 by @desplega-bot in #2434
  • feat(skills): onboarding-qa maintainer skill (install, ui and stack modes) by @tarasyarema in #2362
  • release: v2.6.0 + docs daily update 2026-10-26 by @desplega-bot in #2437

Full Changelog: v2.5.4...v2.6.0

v2.5.4

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.5.4
# or install globally
npm i -g @desplega.ai/agent-swarm@2.5.4

bun:

bunx @desplega.ai/agent-swarm@2.5.4
# or install globally
bun i -g @desplega.ai/agent-swarm@2.5.4

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.5.4
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.5.4
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.5.4

E2B templates:

# API
agent-swarm-api-2-5-4
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-5-4
agent-swarm-worker-latest

What's Changed

Full Changelog: v2.5.3...v2.5.4

v2.5.3

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.5.3
# or install globally
npm i -g @desplega.ai/agent-swarm@2.5.3

bun:

bunx @desplega.ai/agent-swarm@2.5.3
# or install globally
bun i -g @desplega.ai/agent-swarm@2.5.3

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.5.3
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.5.3
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.5.3

E2B templates:

# API
agent-swarm-api-2-5-3
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-5-3
agent-swarm-worker-latest

What's Changed

  • feat(skills): rank skill-search results with BM25 by @desplega-bot in #2361
  • chore(docker): bump opencode, dsh, amp, anthropic sdk (2026-10-23) by @desplega-bot in #2369
  • feat(extensions): comms-adherence-gate judges plain language and agent Slack posts by @desplega-bot in #2360
  • fix(ui): keep the border beam a ring in Firefox by @desplega-bot in #2371
  • fix(chat-sdk): acknowledge addressed asks in a subscribed Telegram thread right away by @desplega-bot in #2368
  • feat(ui): pretty-print raw task prompts in sessions, lists and pop-overs by @desplega-bot in #2373
  • fix(workflows): keep one child run per sub-workflow invocation across crashes and retries by @dev-petrov in #2364
  • feat(hitl): config question type sets swarm config and secrets safely by @desplega-bot in #2374
  • fix(ui): read generated prompt envelopes from their backend builders by @desplega-bot in #2376
  • fix(sessions): show only ui sessions by default and keep Done through agent activity by @desplega-bot in #2379
  • fix(entrypoint): make the GitLab git credential helper setup idempotent by @dev-petrov in #2372
  • docs(skills): ask for missing config and secrets with a config question by @desplega-bot in #2378
  • fix(sessions): reopen a Done session when a person steers it by @desplega-bot in #2381
  • fix(skills): rank name and description hits first in skill-search by @desplega-bot in #2375
  • docs: reserve changelog edits for release PRs by @desplega-bot in #2382
  • release: v2.5.3 + docs daily update 2026-10-24 by @desplega-bot in #2387

New Contributors

Full Changelog: v2.5.2...v2.5.3

v2.5.2

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.5.2
# or install globally
npm i -g @desplega.ai/agent-swarm@2.5.2

bun:

bunx @desplega.ai/agent-swarm@2.5.2
# or install globally
bun i -g @desplega.ai/agent-swarm@2.5.2

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.5.2
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.5.2
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.5.2

E2B templates:

# API
agent-swarm-api-2-5-2
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-5-2
agent-swarm-worker-latest

What's Changed

Full Changelog: v2.5.1...v2.5.2

v2.5.1

Install & Run

npm:

npx @desplega.ai/agent-swarm@2.5.1
# or install globally
npm i -g @desplega.ai/agent-swarm@2.5.1

bun:

bunx @desplega.ai/agent-swarm@2.5.1
# or install globally
bun i -g @desplega.ai/agent-swarm@2.5.1

Docker:

# Server
docker pull ghcr.io/desplega-ai/agent-swarm:2.5.1
# Worker
docker pull ghcr.io/desplega-ai/agent-swarm-worker:2.5.1
# Dashboard
docker pull ghcr.io/desplega-ai/agent-swarm-ui:2.5.1

E2B templates:

# API
agent-swarm-api-2-5-1
agent-swarm-api-latest

# Worker / lead runtime
agent-swarm-worker-2-5-1
agent-swarm-worker-latest

What's Changed

Full Changelog: v2.5.0...v2.5.1