Asynkron.Swarm
1.2.0
dotnet tool install --global Asynkron.Swarm --version 1.2.0
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
dotnet tool install --local Asynkron.Swarm --version 1.2.0
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Asynkron.Swarm&version=1.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
nuke :add-package Asynkron.Swarm --version 1.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Asynkron.Swarm
AI Agent Swarm Orchestrator - Run multiple AI coding agents in parallel on git worktrees.
Overview
Swarm creates multiple git worktrees from your repository and spawns AI agents (Claude or Codex) to work on tasks in parallel. Agents compete to fix issues, and a supervisor agent evaluates and merges the best solution.
Installation
dotnet tool install -g Asynkron.Swarm
Usage
swarm --repo ~/git/my-project --todo todo.md --agents 3 --minutes 5
Options
| Option | Description | Default |
|---|---|---|
-r, --repo |
Path to the git repository | (required) |
-t, --todo |
Name of the todo file | todo.md |
-a, --agents |
Number of worker agents | 3 |
-m, --minutes |
Minutes per round | 5 |
--agent-type |
Agent CLI: Claude or Codex |
Claude |
--max-rounds |
Maximum rounds | 10 |
How It Works
Round Lifecycle
- Create Worktrees: Creates N git worktrees (
round1-agent1,round1-agent2, etc.) - Inject Rivals: Each worktree's todo.md gets a "Rivals" section with paths to other worktrees
- Start Workers: Spawns AI agents, one per worktree
- Start Supervisor: Supervisor agent monitors worker logs
- Wait: Workers compete for the specified time
- Kill Workers: All workers are terminated, logs marked with
<<worker has been stopped>> - Evaluate: Supervisor evaluates each worktree (build, tests)
- Merge: Supervisor picks winner and merges to main repo
- Cleanup: Worktrees are deleted
- Repeat: If todo items remain, start next round
UI
The TUI shows:
- Left panel: List of running agents (use ↑/↓ to select)
- Right panel: Log output of selected agent
Press q to quit.
Todo File Format
The todo file should contain markdown checkboxes:
# Tasks
- [ ] Fix authentication bug in login.ts
- [ ] Add unit tests for UserService
- [ ] Optimize database queries
Requirements
- .NET 9.0+
- Git
- Claude CLI (
claude) or Codex CLI (codex)
License
MIT
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.