Yeachan-Heo/oh-my-codex

O que é?

Recursos principais

• 01Fluxo de trabalho padrão, do esclarecimento ao planejamento e à execução persistente
• 02Execuções persistentes com vários objetivos e registros de checkpoints em .omx/ultragoal
• 03Equipes de agentes paralelas via tmux e git worktrees dedicados
• 04Wrapper de inicialização com isolamento em worktrees nomeadas para sessões simultâneas
• 05Executor de missões para lotes sequenciais de prompts, com status e retomada
• 06Comandos para exportar sessões, consultar a linha do tempo e inspecionar o uso de tokens

Casos de uso

• Transformar uma solicitação vaga de funcionalidade em um plano aprovado antes de o Codex editar o código
• Executar refatorações longas e com várias etapas, mantendo o progresso registrado em checkpoints entre sessões
• Dividir uma tarefa grande em frentes de trabalho paralelas, em worktrees separados
• Agrupar uma lista de prompts do Codex para executá-los, um após o outro, sem supervisão

Início rápido

1. 1

   Instale o Codex CLI via npm (pule esta etapa se já tiver instalado pelo Homebrew)

   npm install -g @openai/codex
2. 2

   Instale o oh-my-codex globalmente

   npm install -g oh-my-codex
3. 3

   Execute a verificação doctor para confirmar a instalação

   omx doctor
4. 4

   Inicie o OMX dentro de um projeto git

   omx

Antes de usar

• !Projetado principalmente para macOS ou Linux; o suporte ao Windows nativo é mais limitado e pode apresentar comportamento inconsistente.
• !Requer Node.js 20 ou superior e um Codex CLI autenticado.
• !O ambiente de execução persistente para equipes recomendado requer tmux no macOS ou Linux.
• !A flag --madmax desativa a aprovação do Codex e as proteções do sandbox, então use-a apenas em ambientes confiáveis.

Tópicos

Perguntas frequentes

O que é oh-my-codex?

Uma camada de fluxo de trabalho e runtime para o OpenAI Codex CLI que adiciona planejamento estruturado, execução persistente de objetivos, equipes de agentes paralelas e acompanhamento de estado em .omx/. oh-my-codex (OMX) é uma camada de fluxo de trabalho que funciona sobre o OpenAI Codex CLI. O Codex continua sendo o mecanismo de execução; o OMX adiciona um fluxo padrão que vai do esclarecimento de requisitos (`$deep-interview`) ao planejamento (`$ralplan`) e à execução persistente de vários objetivos (`$ultragoal`), com `$team` disponível para trabalho paralelo coordenado dentro de uma história.

oh-my-codex é gratuito? Qual é a licença?

oh-my-codex é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

oh-my-codex ainda é mantido?

Manutenção ativa. O último commit de oh-my-codex foi em 20 de out. de 2026.

Para que posso usar oh-my-codex?

Transformar uma solicitação vaga de funcionalidade em um plano aprovado antes de o Codex editar o código Executar refatorações longas e com várias etapas, mantendo o progresso registrado em checkpoints entre sessões Dividir uma tarefa grande em frentes de trabalho paralelas, em worktrees separados Agrupar uma lista de prompts do Codex para executá-los, um após o outro, sem supervisão

Como instalar oh-my-codex?

Instale o Codex CLI via npm (pule esta etapa se já tiver instalado pelo Homebrew): npm install -g @openai/codex Instale o oh-my-codex globalmente: npm install -g oh-my-codex Execute a verificação doctor para confirmar a instalação: omx doctor Inicie o OMX dentro de um projeto git: omx

Onde consigo oh-my-codex?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Yeachan-Heo/oh-my-codex