am423/grok-swarms

grok-swarms is a small community add-on for a tool called Hermes Agent. Hermes is an AI coding agent that runs locally, and grok-swarms teaches it how to drive teams of AI workers backed by xAI's Grok models. The README calls these teams swarms. The setup uses one Grok 4.3 model as the orchestrator that plans the work with the human user, and several other Grok models as execution agents that each take on a sub-task. The interesting piece is how the execution agents are isolated. Each one runs inside its own TMUX session, which is a terminal multiplexer for Linux and macOS. Putting each worker in a separate TMUX session means they have their own shell, their own files in progress, and their own output stream, so they do not collide with each other or with the orchestrator while they work. Task tracking lives in Hermes's built-in kanban board. The orchestrator writes cards for each sub-task, the executors update their cards as they work, and the human reviews finished work through what the README calls an approve-or-kick-back loop: either the work is accepted or it goes back to the executor with feedback. The kanban is the single source of truth for what is done, in progress, or blocked. Installation is a single shell command that clones the repository and registers SKILL.md with the Hermes skills system. After installation, the user types a short request such as start a grok-swarm for building the new auth system, and the orchestrator begins planning. The repository ships SKILL.md, reference notes on TMUX spawn patterns, kanban review loops, acceptance criteria templates, and Grok model configuration. The license is MIT.