Documentação HorusBI
Buscar K

Aparência

Abrir no Claude Abrir no ChatGPT

Lumo CLI no Cursor ​

Este guia instala as skills do Lumo no Cursor 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, sem instalar a CLI. Veja Primeiros Passos.

Você talvez já tenha ​

O Cursor lê skills de várias pastas, incluindo as do Claude Code e do Codex:

PastaEscopo
~/.cursor/skills/global, nativa do Cursor
~/.agents/skills/global, compartilhada com o Codex
~/.claude/skills/global, do Claude Code
~/.codex/skills/global, do Codex
.cursor/skills/do projeto
.agents/skills/do projeto
.claude/skills/do projeto
.codex/skills/do projeto

Se você já instalou as skills do Lumo para o Claude Code ou para o Codex nesta máquina, o Cursor já enxerga todas elas. Não há nada a fazer: abra o Cursor e peça algo (veja Verificando). Por isso o instalador só cria ~/.cursor/skills/ quando nenhuma dessas outras pastas recebeu skill, evitando que o Cursor carregue a mesma skill duas vezes.

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 Cursor e copia as skills para ~/.cursor/skills/.

Para forçar a instalação no Cursor mesmo que o Claude Code ou o Codex já estejam na máquina (macOS/Linux):

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

Ao final, você terá:

~/.cursor/skills/lumo-cli/SKILL.md
~/.cursor/skills/lumo-design/SKILL.md
~/.cursor/skills/lumo-decks/SKILL.md
~/.cursor/skills/lumo-scope/SKILL.md
~/.cursor/skills/lumo-mockup/SKILL.md

TIP

Para instalar em todos os agentes de uma vez, use ./instalar.sh --skill-target all.

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

Extraia o .zip e copie as pastas de skill para a pasta de skills do Cursor:

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

Opção C: Por projeto, versionado no repositório ​

Para um time inteiro pegar as skills junto com o repositório, coloque-as em .cursor/skills/ na raiz do projeto e commite:

bash
mkdir -p .cursor/skills
cp -r skills/lumo-cli .cursor/skills/
git add .cursor/skills && git commit -m "chore: skill do Lumo no repositório"

O Cursor varre essa pasta recursivamente e carrega tudo que encontrar.

Invocando ​

O agente do Cursor decide sozinho quando usar cada skill, a partir da descrição dela. Para chamar uma na mão, digite / no chat do Agent e busque pelo nome (lumo-cli, lumo-design, lumo-decks, lumo-scope, lumo-mockup).

Verificando ​

Abra o Cursor 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 uma das pastas da tabela acima e comece uma conversa nova.

Atualizando ​

A cada nova versão do CLI, baixe o .zip novamente e rode o instalador, que substitui as skills existentes pela versão nova. O lumo update também atualiza as skills nas pastas dos agentes detectados.