-
-
Brain-hands flow
Brain Hands is an open-source CLI and Codex plugin for software changes that need more control than a single agent chat.
It divides the workflow into three roles. Brain investigates the problem and prepares a plan. Hands gets write access only after the user approves the discovery brief and plan. Verifier reviews the result independently. A deterministic controller manages permissions, retries, recovery, and a durable history of every run.
Interrupted work can resume without changing scope or reusing an outdated approval. Brain Hands runs in an isolated Git worktree or through GitHub issues and a single pull request. It never merges or deploys automatically, and it blocks nested agent fan-out.
I built the TypeScript controller with Codex and used GPT-5.6 for planning, architecture, debugging, and review. I chose the product boundaries and safety tradeoffs, while tests and release checks remained the final authority.
The Apache-2.0 project ships as an npm CLI and Codex plugin. Orbitarium, an interactive Solar System app, demonstrates the full workflow in practice.
Built With
- codex
- github-actions
- gpt-5.6
- node.js
- npm
- typescript
- vitest