Codex Workflow

Plugin público e marketplace da shyland-dev para instalar no Codex workflows reutilizáveis de desenvolvimento e automação do Microsoft Edge.

O MCP DevTools é local: ele inicia chrome-devtools-mcp por STDIO e se conecta somente ao Microsoft Edge do próprio usuário. Este projeto não mantém servidor intermediário nem coleta telemetria.

Conteúdo

• codex-workflow:shyland-workflow: planejamento, implementação, convenções de linguagem e regras de CSS/SCSS.
• codex-workflow:git-commit: preview e criação confirmada de Conventional Commits.
• codex-workflow:notion-docs: documentação usando o plugin oficial do Notion.
• codex-workflow:devtools-automation: automação do Microsoft Edge pelo DevTools MCP.
• MCP devtools, executado por Node.js selecionado dinamicamente pelo NVM.

Pré-requisitos para DevTools

O plugin apenas verifica e orienta; ele não instala dependências.

1. Microsoft Edge para Linux/WSL, disponível como microsoft-edge.
2. NVM instalado em $NVM_DIR ou ~/.nvm.
3. Uma versão default do Node.js configurada no NVM. npm e npx devem acompanhar essa instalação.
4. Acesso ao npm na primeira execução de chrome-devtools-mcp@latest.

Verifique o ambiente:

./plugins/codex-workflow/scripts/check-requirements.sh

Instalação

Pelo GitHub

Clone uma release publicada, registre o repositório como marketplace e instale o plugin:

git clone --branch v0.1.0 --depth 1 https://github.com/shyland-dev/codex-workflow.git
cd codex-workflow
codex plugin marketplace add "$PWD"
codex plugin add codex-workflow@shyland-dev

Abra uma conversa nova depois da instalação para o Codex carregar as skills e o MCP.

Para desenvolvimento local

Dentro de um clone deste repositório:

codex plugin marketplace add "$PWD"
codex plugin add codex-workflow@shyland-dev

Atualização e remoção

Para atualizar, obtenha a release desejada no clone e reinstale o plugin:

codex plugin add codex-workflow@shyland-dev

Para remover somente o plugin:

codex plugin remove codex-workflow@shyland-dev

Consulte codex plugin marketplace --help para gerenciar o marketplace registrado.

AGENTS.md global opcional

Plugins disponibilizam capacidades; AGENTS.md torna preferências permanentes. Revise o template antes de mesclá-lo às suas instruções existentes:

cp plugins/codex-workflow/templates/AGENTS.global.example.md ~/.codex/AGENTS.md

Não execute esse comando sobre um arquivo existente sem antes combinar os conteúdos. Para regras específicas de um repositório, use AGENTS.project.example.md como ponto de partida.

Microsoft Edge

A skill devtools-automation executa o launcher dedicado. Ele encerra todos os processos msedge, limpa /tmp/edge-codex e abre uma nova janela com:

• modo InPrivate;
• perfil descartável e isolado;
• debugging remoto na porta 9222;
• extensões e sincronização desabilitadas.

Somente Microsoft Edge é suportado. O nome chrome-devtools-mcp refere-se ao pacote npm compatível com navegadores Chromium e não habilita uso do Google Chrome.

Notion

A skill notion-docs depende do plugin oficial do Notion já instalado e habilitado. Este marketplace não duplica o servidor MCP nem a autenticação do Notion.

Desenvolvimento e validação

./tests/validate-files.sh
./tests/test-launchers.sh
./tests/test-package.sh
python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/plugin-creator/scripts/validate_plugin.py" \
  plugins/codex-workflow

Durante atualizações locais, valide o marketplace e use o cachebuster oficial antes de reinstalar:

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/plugin-creator/scripts/read_marketplace_name.py" \
  --marketplace-path .agents/plugins/marketplace.json
python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/plugin-creator/scripts/update_plugin_cachebuster.py" \
  plugins/codex-workflow
codex plugin add codex-workflow@shyland-dev

O processo completo de criação de tags e releases está em RELEASING.md.

Suporte e segurança

• Consulte CONTRIBUTING.md antes de propor alterações.
• Abra dúvidas e bugs nas issues do GitHub.
• Para vulnerabilidades, siga SECURITY.md e evite publicar detalhes sensíveis em issues.
• O tratamento de dados está descrito em PRIVACY.md.
• O uso e as limitações estão descritos em TERMS.md.

Licença

Distribuído sob a licença MIT. Consulte LICENSE.