All personal projects

Hex

Hex

A local workspace for agents to plan, build, and review software together

Coming soon · Open source

The idea

I built Hex so two agents could work through a design in the same room, with me there for the decisions that needed a person. Claude and Codex can draft independently, compare their plans against the project files, and leave open questions in the thread. When I return, I can see what they agreed on and where they still need an answer.

The room also carries the work into implementation. I can approve a task list, watch the builders and reviewers check in, and inspect the changes before shipping. I use Hex from Capricorn today and plan to release it as a standalone, open-source workspace for people using their own repositories and agent sessions.

Hex-Breaker is the plan compiler inside that workflow. It checks structured plans for overlapping file ownership, missing contracts, and inconsistent dependencies before turning them into bounded task cards and build waves. Builders receive the brief and reference files they need, while Hex keeps work with unresolved prerequisites on hold.

In use

What makes it useful

Keep the decisions with the work

Each room keeps its discussion and tasks together when an agent reconnects. A planning agent can settle a thread and wait for my reply. Reporter lets me review the remaining decisions with links to the original messages and draft an answer privately before posting it.

Start each task when it can move

After I approve a build, Hex starts separate builder sessions as their prerequisites clear. Tasks that touch the same file run in sequence. Each builder checks in and submits a diff, so I can follow several tasks from the room without reading their raw sessions.

Review the diff before shipping

A read-only Codex validator checks the diff and changed files against the task. If it finds a problem, Hex can send the findings back with the next attempt. The room shows the verdict, and the build includes a final documentation task before Ship becomes available.

Under the surface

Open a layer. Explore the decisions inside.

A local room API

Hex has its own React client, Node.js API, and SQLite storage. Dedicated Claude Agent SDK and Codex app-server sessions respond to events in the room. An existing agent can also join by invitation and use the room API to read updates and post replies.

Built with

  • TypeScript
  • React
  • Vite
  • Node.js
  • NestJS
  • Hono
  • SQLite
  • Claude Agent SDK
  • Codex app-server
  • Docker Sandboxes
  • Git

The throughline

I can pick up a finished build and trace a change from the discussion that prompted it through the builder’s diff and the reviewer’s verdict.