Skip to content

nbardy/unleashd

Repository files navigation

unleashd

A SWARM FIRST ADE (Agent Development Environment) for running and managing agent swarms across Claude Code, Codex, Gemini, and OpenCode.

Download the unleashd demo video

The problem

You run agents from different CLIs — Claude Code, Codex, Gemini, OpenCode. Each has its own terminal, its own session history, its own way of showing what happened. When you're running a swarm of agents across a codebase, there's no single place to see what's going on, steer the work, or review what was done.

What unleashd does

Two things:

1. Visibility and organization across all your agents. See every conversation from every CLI agent, organized by project. Search across all of them. No more flipping between terminals trying to remember which agent you asked to do what.

2. Launch and manage long-running agent swarms. Swarms are treated as two things at once:

  • Background jobs — they run in a loop, autonomously, without interruption.
  • Artifacts — they can be inspected, discussed, and steered through conversation.

Swarms continue without you. But you guide them. From the same chat interface, you can launch a swarm, check its progress, debug a failing worker, or review its output.

Swarm Analytics

Track multi-agent swarm runs — iterations, merges, rejections, per-worker timelines.

Swarm Analytics

Quick Start

Prerequisites: pnpm and at least one supported CLI agent installed and authenticated (e.g. claude).

pnpm install
pnpm dev

Opens at http://unleashd.localhost if local port-80 routing is active, otherwise http://localhost:7489. On macOS startup, unleashd will try to run the local routing setup automatically and may prompt for sudo once. In dev, the API server stays on port 7499 behind the Vite proxy.

Production

pnpm build
pnpm start     # serves built client + API on port 7489

Supported Agents

Agent Disk path read Live spawn
Claude Code ~/.claude/projects/ Yes
Codex ~/.codex/sessions/ Yes
OpenCode ~/.local/share/opencode/ No (read-only)
Gemini CLI ~/.gemini/tmp/ Yes

The server auto-discovers conversations from each agent's disk format. No configuration needed — if the CLI has been used, its sessions show up.

Project Structure

client/     React + Vite frontend
server/     Express + WebSocket backend
shared/     Shared types (Zod schemas)

License

MIT

About

A local, git-worktree multi-agent swarm orchestrator for Codex, Claude, Gemini, and OpenCode

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors