whatisgithub

What is swarm-board?

vesperino/swarm-board — explained in plain English

Analysis updated 2026-07-26

1HTMLAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A tool for Claude Code that lets one AI judge coordinate many AI workers in parallel to solve complex tasks, with a live web board to watch and guide the process in real time.

Mindmap

mindmap
  root((repo))
    What it does
      Coordinates AI worker swarms
      Live web dashboard
      Human can intervene mid-run
    How it works
      Judge sets success criteria
      Workers run in parallel waves
      Adversarial critics verify results
    Memory system
      Wiki of findings and failures
      Distiller extracts lessons
      Plain markdown files
    Tech stack
      HTML and Node
      Claude Code required
      Supports OpenAI Codex CLI
    Use cases
      Fix flaky tests
      Complex code research
      Parallel feature development

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find and fix flaky tests by spinning up parallel AI agents to research and patch.

USE CASE 2

Coordinate multiple AI workers to tackle a complex coding goal from a single command.

USE CASE 3

Watch AI agents collaborate live and intervene to correct individual workers mid-task.

USE CASE 4

Build a persistent wiki of past failures and lessons so future AI runs avoid dead ends.

What is it built with?

HTMLNode.jsClaude CodeOpenAI Codex CLI

How does it compare?

vesperino/swarm-boardabhas9/escape-runabhishek-kumar09/mern-live-js-june-2021
Stars111
LanguageHTMLHTMLHTML
Last pushed2021-09-13
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Claude Code and Node 20.11 or higher to be installed and configured.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Swarm Board is a tool for Claude Code that lets one AI session act as a judge coordinating many AI workers at once. You type a single command with a goal, such as finding and fixing a flaky test, and the system spins up parallel agents to research, analyze, code, test, and synthesize results. You watch the whole process unfold on a live web board in your browser. When you start a run, your session becomes the judge. It figures out what success looks like, starts a local server, and gives you a URL. The judge then launches waves of worker agents, each running on the model you choose. Agents communicate with each other on the board through mentions, findings, and failure reports. You can watch every message stream in real time, color-coded by role, with long reports collapsible for easier reading. You are not a passive observer. You can post messages as a human and tag specific agents, and the judge pushes your input into a running agent's context mid-task. You can stop or correct individual agents without halting the rest of the swarm. A live token counter shows session cost as it accrues. When the judge believes the goal is met, adversarial critics attempt to refute the result, and only solid evidence turns a failure into a pass. Every run builds a wiki memory of findings, failures, and approaches. Workers must read the wiki and past failures before starting, then write their own findings back before finishing. When a run closes, a distiller extracts up to three general lessons and stores them in a global wiki that seeds future swarms, so the system avoids repeating dead ends. The memory is plain markdown files you can read directly, and the board itself is a JSONL log you can search. The project also supports OpenAI's Codex CLI, sharing the same board, wiki, and global memory between both systems. It requires Claude Code and Node 20.11 or higher, and it is licensed under MIT. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to use Swarm Board with Claude Code to find and fix a flaky test in my repository. How do I start a swarm run with that goal?
Prompt 2
How do I post a message as a human into a running Swarm Board session to correct a specific AI agent that is going down the wrong path?
Prompt 3
Explain how Swarm Board's wiki memory works and how I can read the markdown files it creates to understand past failures and lessons.
Prompt 4
I have OpenAI's Codex CLI installed. How do I connect it to Swarm Board so it shares the same board and global wiki as Claude Code?
Prompt 5
How do I monitor the live token cost of my Swarm Board session and what happens when the judge thinks the goal is met?

Frequently asked questions

What is swarm-board?

A tool for Claude Code that lets one AI judge coordinate many AI workers in parallel to solve complex tasks, with a live web board to watch and guide the process in real time.

What language is swarm-board written in?

Mainly HTML. The stack also includes HTML, Node.js, Claude Code.

What license does swarm-board use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is swarm-board to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is swarm-board for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.