Instalar o Lumo CLI

Tipo

Como fazer

Para

Desenvolvedor, Analista

Instale o lumo, entre com o seu usuário do Lumo e crie um workspace ligado a um Tenant. O instalador também copia as skills para os agentes de IA que encontrar na máquina.

Antes de começar

O seu usuário precisa da função Uso do Lumo CLI, da suíte DataViz, em pelo menos um Tenant. Sem ela o login é recusado. Quem dá a função é o administrador do Tenant, em grupos e permissões.

1. Instale

Windows

Baixe o instalador, dê dois cliques e siga o assistente. Ele põe o lumo no PATH e instala as skills.

Baixar para Windows (.exe)

O .exe é só para Windows x64. Em Windows ARM, ou se preferir o terminal, abra o PowerShell e rode:

irm https://storage.horusbi.com.br/download/lumo/install.ps1 | iex

Esse comando instala em %LOCALAPPDATA%\Lumo.

macOS e Linux

Abra o Terminal e rode:

curl -fsSL https://storage.horusbi.com.br/download/lumo/install.sh | bash

O script detecta o sistema e a arquitetura (amd64 ou arm64), baixa o pacote, confere o checksum e copia o lumo para /usr/local/bin. Sem permissão ali nem sudo, usa ~/.local/bin e acrescenta essa pasta ao PATH no arquivo de inicialização do shell (.zshrc, .bashrc ou .profile).

Para passar opções ao instalador, como --no-skill (não instala skills) ou --skill-target all, use bash -s --:

curl -fsSL https://storage.horusbi.com.br/download/lumo/install.sh | bash -s -- --skill-target all

Os valores de --skill-target estão em Agentes de código.

Download manual

Sistema	Pacote
Linux amd64	LumoCLI-linux-amd64.tar.gz
Linux arm64	LumoCLI-linux-arm64.tar.gz
macOS Intel	LumoCLI-darwin-amd64.tar.gz
macOS Apple Silicon	LumoCLI-darwin-arm64.tar.gz
Windows amd64	LumoCLI-windows-amd64.zip
Windows arm64	LumoCLI-windows-arm64.zip

O pacote traz o binário e o instalador local (install.sh ou install.ps1), que aceita as mesmas opções. Para conferir a integridade, compare com o checksums.txt.

2. Confira a instalação

Feche o terminal e abra outro: só uma janela nova enxerga o PATH atualizado. Depois rode:

lumo version

3. Entre com o seu usuário

lumo auth login

O comando pede e-mail e senha (a senha não aparece enquanto você digita) e, se a conta tiver 2FA, o código. A sessão fica em ~/.lumo/auth.json e se renova sozinha: o token de acesso dura 1 hora, mas o próximo comando o troca sem pedir login de novo.

Para entrar pelo navegador, sem digitar a senha no terminal, use lumo auth login --web e aprove na tela Entrar no Lumo CLI. Em domínio de parceiro, passe o endereço com --web-url. Esse modo precisa de navegador na mesma máquina; em SSH ou CI, veja Lumo CLI em CI.

Com lumo auth login --local, a sessão fica num arquivo .lumo-session no diretório atual, e os comandos rodados dali ou de uma subpasta usam essa sessão no lugar da global. Serve para usar outro usuário num workspace. O arquivo guarda o token e fica fora do .lumo/.gitignore: não o versione.

lumo auth status mostra quem está logado e quando o token vence. lumo auth logout apaga a sessão.

4. Crie o workspace

Liste os Tenants que o seu usuário enxerga e inicialize um deles num diretório:

lumo tenants list
lumo init 1200 ./loja-exemplo
cd ./loja-exemplo
lumo status

O init cria a pasta .lumo/ e baixa um YAML por recurso que você tem permissão de editar. Um tipo que o seu usuário não pode editar aparece na saída como pulado, com o motivo, e o resto segue. O que cada pasta guarda está em Conceitos.

TIP

Guarde o workspace no Git (git init && git add . && git commit). O init já cria .lumo/.gitignore, que deixa de fora o cache interno e mantém só o workspace.json.

Manter atualizado

Quando há versão nova, o lumo avisa no fim do comando:

⬆  lumo vX.Y.Z disponível (atual: vA.B.C) — rode: lumo update

lumo update baixa a versão nova, troca o binário e atualiza as skills dos agentes detectados. lumo update --check só verifica. Se a pasta do binário pedir privilégio, o comando para com código de saída 20 e mostra o que rodar (por exemplo, sudo lumo update). Para calar o aviso, defina LUMO_NO_UPDATE_NOTIFIER=1.

Se der errado

lumo: command not found logo depois de instalar. O terminal foi aberto antes da instalação. Abra uma janela nova.

Nenhum tenant disponível para uso do Lumo CLI. O seu usuário não tem a função Uso do Lumo CLI em nenhum Tenant. Peça ao administrador que dê a função ao seu usuário ou a um grupo seu.

Um comando volta acesso negado (código de saída 6) num Tenant específico. A função foi dada em outro Tenant, ou o acesso mudou depois do init. Confira com lumo tenants list e, se o acesso voltou, rode lumo init <tenant-id> --recover.

lumo init termina com código de saída 11. O diretório já tem um .lumo/. Se ele é do mesmo Tenant, lumo init <tenant-id> --recover baixa de novo por cima. Se é de outro Tenant, o --recover também recusa: use outro diretório.

Próximos passos

• Agentes de código: conferir as skills no seu agente
• Trabalhar com IA: o primeiro pedido e como revisar o resultado
• Comandos: a lista completa