FactoryOS brings structure to Codex CLI workflows
FactoryOS is an open-source workspace built on top of Codex CLI. It tries to solve a common problem in AI coding: the prompt grows, the chat grows, and the conversation slowly becomes the project record. The workflow turns product intent into structured specs, turns specs into , and turns plans into executable task groups.
work on one small, clearly bounded task at a time. Verification checks whether the works, and humans approve important changes before they ship. The main idea is that the repository should hold the , not the chat history.
The repository contains .specs for product truth, .tasks for execution truth, AGENTS.md for repository rules, skills for s, code for , and tests for proof. The role setup is intentionally small, with a main integrator, explorer, worker, and QA role. The goal is not full autonomy; it is to keep context growth under control, make token use more predictable, and make work easier to resume, review, and verify.
Key points
- FactoryOS is an open-source workspace built on Codex CLI.
- It treats the repository, not the chat history, as the .
- Product ideas become specs, plans, and bounded task groups.
- AI tools handle one clear task at a time, with verification and human approval before important changes ship.
- The aim is controlled context growth, predictable token use, and easier review.