Codex Cowork

English: Codex Cowork is a Codex-first cowork operator platform and specialist-agent plugin. It keeps execution local to Codex while adding consultative roles for planning, research, implementation guidance, review, QA, app packs, reusable recipes, and local operations through MCP, macOS, and browser backends.

Português: Codex Cowork é uma plataforma operador/cowork com foco em Codex e um plugin de agentes especialistas. Ele mantém a execução local no Codex enquanto adiciona papéis consultivos para planejamento, pesquisa, orientação de implementação, revisão, QA, app packs, recipes reutilizáveis e operação de aplicativos por meio dos backends MCP, macOS e browser.

Phase 3 Beta

English: The current checkpoint is 0.4.0-beta.2. Phase 3 beta adds semantic app operators, guided runbooks with pause/resume checkpoints, replayable executions, richer operator health diagnostics, structured failure taxonomy with remediation hints, and a stronger local dashboard for evidence, approvals, and operator state.

Português: O checkpoint atual é 0.4.0-beta.2. A beta da Fase 3 adiciona operadores semânticos de apps, runbooks guiados com checkpoints de pausa/retomada, execuções com replay, diagnósticos mais ricos de saúde dos operadores, taxonomia estruturada de falhas com dicas de remediação e um dashboard local mais forte para evidências, aprovações e estado operacional.

GitHub Description

English: Codex-first cowork operator plugin with specialist agents, app packs, recipes, and a local dashboard for MCP, macOS, and browser automation.

Português: Plugin operador/cowork com foco em Codex que adiciona agentes especialistas, app packs, recipes e um dashboard local para automação via MCP, macOS e browser.

Highlights

English:

• Codex remains the only actor with local execution power.
• External models stay consultative and role-based.
• Local control backends cover MCP servers, macOS apps, and browser targets.
• Curated app packs cover core developer tools, graphics apps, and Steam/Valve-style launch flows.
• Semantic app operators expose app-aware intents for Finder, VS Code, Chrome, Xcode, Antigravity IDE, Unity, Android Studio, Steam, and Blender handoff-first flows.
• Reusable recipes combine typed control actions with explicit skill or MCP handoffs.
• Guided runbooks add checkpoints, pause/resume, approval gates, and role handoffs for longer operator flows.
• Replay tools can re-run the latest execution, operator action, or runbook with the same structured request.
• Structured failure taxonomy returns failureKind plus remediation hints across control, operator, workflow, and runbook surfaces.
• A loopback-only dashboard exposes catalog, operators, runbooks, evidence, replay history, and a dry-run/live control console.
• Evidence, sessions, provider routing, and policies are persisted outside the repo.
• Default application language is English, with Portuguese translations included in docs and server strings.

Português:

• O Codex continua sendo o único ator com poder de execução local.
• Os modelos externos permanecem consultivos e orientados por papel.
• Os backends locais de controle cobrem servidores MCP, apps macOS e alvos de browser.
• App packs curados cobrem ferramentas centrais de desenvolvimento, apps gráficos e fluxos de launch em estilo Steam/Valve.
• Operadores semânticos de apps expõem intenções conscientes do app para Finder, VS Code, Chrome, Xcode, Antigravity IDE, Unity, Android Studio, Steam e fluxos Blender com handoff-first.
• Recipes reutilizáveis combinam ações tipadas de controle com handoffs explícitos para skills ou MCP.
• Runbooks guiados adicionam checkpoints, pausa/retomada, gates de aprovação e handoffs de papel para fluxos operacionais mais longos.
• Tools de replay podem reexecutar a última execução, ação de operador ou runbook com o mesmo pedido estruturado.
• A taxonomia estruturada de falhas retorna failureKind com dicas de remediação nas superfícies de controle, operador, workflow e runbook.
• Um dashboard local em loopback expõe catálogo, operadores, runbooks, evidência, histórico de replay e um console de controle com dry-run/live.
• Evidências, sessões, roteamento de providers e políticas ficam persistidos fora do repositório.
• O idioma padrão da aplicação é inglês, com traduções em português incluídas na documentação e nas strings do servidor.

Repository Layout

• plugins/codex-cowork/: main plugin source, skills, assets, tests, and MCP server.
• plugins/codex-cowork/src/ui/: local loopback dashboard server for the operator UX.
• docs/research/claudecodes-audit.md: bilingual audit dossier for the reference corpus.
• .agents/plugins/marketplace.json: local marketplace entry for Codex plugin discovery.

Development

cd plugins/codex-cowork
npm install
npm test

Localization

English: The default runtime language is English. Portuguese translations are included for documentation, skills, dashboard copy, and MCP server surface strings. You can switch the server surface to Portuguese with CODEX_COWORK_LOCALE=pt-BR.

Português: O idioma padrão de runtime é inglês. Traduções em português estão incluídas para documentação, skills, copy do dashboard e strings de superfície do servidor MCP. Você pode mudar a superfície do servidor para português com CODEX_COWORK_LOCALE=pt-BR.

Publishing Notes

English: This repository is prepared to publish the full Codex Cowork plugin, not only the README, so the GitHub repository is immediately usable as a real project source.

Português: Este repositório foi preparado para publicar o plugin completo Codex Cowork, e não apenas o README, para que o GitHub já fique utilizável como fonte real do projeto.