Clodex

Clodex

A session manager for fleets of coding agents.

Install · What it does · How it works · Docs

Clodex runs Claude Code and Codex sessions as terminals and adds three layers around them: a sidebar that shows the state of every session, a message bus that lets agents coordinate with each other, and a wire that makes sessions on other machines part of the same fleet. The same engine runs as a macOS desktop app and as a headless node on Linux; clodexctl drives either from a terminal, and a headless node can serve the GUI in a browser.

*Left: sessions grouped by project with context fill and cache warmth, a peered box (TEST) contributing its sessions. Centre: the session's terminal, with wire telemetry (model, context, turn, spend, cache state) underneath. Bottom: the IPC bus, where a lead dispatches a review to a reviewer it spawned and reads the verdict back.*

Watch it run: Clodex adding a feature to itself, six minutes at 2x: a hand reports done, a reviewer accepts, the branch merges, and the next ticket starts.

Install

Download Clodex-x.y.z-arm64.dmg from Releases and drag Clodex to Applications. First launch: right-click Clodex.app → Open, or xattr -cr /Applications/Clodex.app; the app is ad-hoc signed, not notarized. Then open Clodex, choose File ▸ New Session… (⌘T), and pick a CLI and a project directory.

Requires an Apple Silicon Mac on macOS 12+, plus the CLIs you want to drive: Claude Code (claude in PATH) and/or Codex (codex in PATH). Intel Macs build from source; Linux servers run the headless engine.

With the desktop app running and its peer wire enabled, install the standalone client (Node 20+):

Building from source, headless and Docker nodes, deploying to a server, and the everyday clodexctl verbs are one page: docs/how-to.md.

What it…