@hiperplano/aluy-cli

<p align="center" <picture <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/hiperplano/aluy-cli/main/docs/aluy-wordmark-white.png" <img src="https://raw.githubusercontent.com/hiperplano/aluy-cli/main/docs/aluy-wordmark.png" alt="Aluy" height="56" </picture </p

<h1 align="center"Aluy CLI</h1

<p align="center" Um agente de terminal que roda na <bsua máquina</b, com o <bseu próprio provider de LLM</b. </p

---

O Aluy CLI é um agente de terminal: ele lê e edita arquivos, executa comandos, busca no seu código e conduz seu próprio loop de ferramentas — tudo numa TUI rica, com uma engine de permissão onde todo efeito passa por uma catraca antes de acontecer.

Você usa o seu próprio modelo (BYO): qualquer provider compatível com a API da OpenAI, com a sua própria credencial — direto, sem intermediário e sem metering. (Por enquanto o aluy roda só local, com a sua chave.)

Instalação

npm install -g @hiperplano/aluy-cli
aluy onboard      # configura idioma, provider, modelo e (opcional) os complementos
aluy              # abre a sessão

O aluy onboard é o instalador guiado: escolhe o idioma, conecta o seu provider (faz um teste de conectividade real antes de prosseguir), e oferece os complementos opcionais. Funciona em Linux, macOS e Windows — o terminal recomendado é o WezTerm, mas qualquer terminal moderno serve.

Uso

aluy                          # sessão interativa (TUI)
aluy "refatore o módulo X"    # dá um objetivo direto e acompanha o agente trabalhar
aluy -p "liste os TODOs"      # modo headless (one-shot), ideal p/ scripts/CI
aluy --resume <id|nome>       # retoma uma conversa anterior (id ao sair, ou o nome do /rename)
aluy --continue               # retoma a sessão mais recente deste diretório

Dentro da sessão, slash-commands controlam tudo sem sair do fluxo:

| Comando | O que faz | |---|---| | /model · /provider · /effort | troca modelo / provider / esforço de raciocínio | | /init | cria o ALUY.md + a estrutura .aluy/ do projeto | | /mcp · /agents · /skills · /workflows | gerencia MCP, sub-agentes, skills e workflows | | /rooms | salas de conversa entre agentes (multi-agente) | | /rename · /theme · /lang | nome+cor da sessão, tema, idioma | | /memory · /compact · /history | memória, compactação de contexto, histórico |

Como funciona

• Agente + permissão — o loop de ferramentas (ler/editar/rodar/buscar) passa por

um ponto único de interceptação: nada com efeito acontece sem a catraca liberar (ou você aprovar). O modo --yolo dispensa as confirmações por sua conta e risco.

• BYO provider — --backend local fala direto com o provider (API key ou OAuth).

A credencial fica só no keychain do SO (macOS Keychain · Windows Credential Manager · Linux Secret Service) — nunca em arquivo, .env ou log.