Documentação HorusBI
Buscar K

Aparência

Abrir no Claude Abrir no ChatGPT

Lumo CLI no Codex ​

Este guia instala as skills do Lumo no Codex para que ele saiba operar a CLI por você.

NOTE

Pré-requisitos: o binário lumo já instalado e autenticado (lumo auth login). A skill ensina o agente a usar o lumo — ela não instala a CLI. Veja Primeiros Passos.

Opção A: Instalador automático (recomendado) ​

  1. Baixe lumo-cli-skill.zip e extraia.
  2. Rode o instalador da sua plataforma:
    • Windows — duplo-clique em instalar.bat
    • macOS / Linux — ./instalar.sh
  3. O instalador detecta o Codex e copia as skills para ~/.agents/skills/.

Para forçar a instalação no Codex mesmo sem detecção automática (macOS/Linux):

bash
./instalar.sh --skill-target codex

Ao final, você terá:

~/.agents/skills/lumo-cli/SKILL.md
~/.agents/skills/lumo-design/SKILL.md

TIP

Para instalar nos dois agentes de uma vez (Claude Code e Codex), use ./instalar.sh --skill-target all.

Opção B: Instalação manual ​

Extraia o .zip e copie as duas pastas de skill para a pasta de skills do Codex (~/.agents/skills/):

bash
mkdir -p ~/.agents/skills
cp -r skills/lumo-cli    ~/.agents/skills/
cp -r skills/lumo-design ~/.agents/skills/
powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.agents\skills" | Out-Null
Copy-Item -Recurse -Force .\skills\lumo-cli    "$env:USERPROFILE\.agents\skills\"
Copy-Item -Recurse -Force .\skills\lumo-design "$env:USERPROFILE\.agents\skills\"

Verificando ​

Abra o Codex no diretório do seu workspace Lumo e peça algo simples:

Verifique o status da minha sessão do Lumo e liste meus flows.

O agente deve rodar lumo auth status / lumo list flow. Se ele não reconhecer o lumo, confirme que os arquivos estão em ~/.agents/skills/lumo-cli/SKILL.md e reinicie a sessão.

Atualizando ​

A cada nova versão do CLI, baixe o .zip novamente e rode o instalador — ele substitui as skills existentes pela versão nova.