evener

# Evener Evener é um agente de programação que recebe um prompt e, iterativamente, lê, escreve, executa comandos e pesquisa código até que o trabalho esteja concluído. Ele utiliza chamadas nativas de ferramentas em OpenAI, Anthropic, Google e outros provedores. ## Interfaces - **Web Hub (`evener hub`)**: Um orquestrador baseado em navegador para gerenciar muitas sessões simultâneas. Os recursos incluem uma barra lateral com sessões ao vivo e agrupadas por projeto, um painel de workspace com exibição de conversa em dois níveis, bifurcação de sessões, retomada transparente e busca com ⌘K. - **Terminal UI (`evener tui`)**: Um painel apoiado pelo hub para navegar pelas sessões, aprofundar-se em transcrições e enviar ações por meio da API do hub. - **CLI não interativa**: Para execuções pontuais em scripts, CI e pipelines. Suporta prompts como argumentos ou via stdin, esquemas de saída estruturada e saída de eventos NDJSON para registro. ## Principais Recursos - **Chamadas nativas de ferramentas**: Usa o loop nativo de chamadas de ferramentas do LLM, com suporte a OpenAI, Anthropic, Google e outros provedores (Groq, DeepSeek, OpenRouter, Ollama, etc.). - **Persistência de sessão**: Salva automaticamente o estado da sessão, permitindo retomar trabalhos interrompidos. As sessões podem ser retomadas por ID ou com `--resume-last`. - **Bifurcação e threads paralelas**: Ramifique sessões em qualquer ponto ou bifurque para uma thread paralela para perguntas que distraem. - **Sandboxing**: Restrinja o acesso a arquivos, processos e rede de uma sessão com `--sandbox`. - **Plugins e skills**: Raízes de extensão para skills e plugins autônomos do usuário, com seleção de plugin por sessão. - **Saída estruturada**: Substitua o esquema de saída padrão pelo seu próprio JSON Schema para o modo estrito específico do provedor. - **Mecanismo de atualização**: `evener upgrade` segue o canal de instalação do binário (release ou snapshot). ## Instalação Instale a versão mais recente no Linux x64 ou macOS Apple silicon: ```bash curl -fsSL https://raw.githubusercontent.com/prime-radiant-inc/evener/main/install.sh | sh ``` O instalador verifica o checksum SHA-256 e instala o `evener` em `~/.local/share/evener/bin`, com link simbólico em `~/.local/bin`. O binário inclui os subcomandos `hub`, `tui`, `doctor` e `migrate`. ## Início Rápido Inicie o hub: ```bash evener hub ``` O hub escuta em `127.0.0.1:9180` e imprime uma URL de autorização. Abra-a, adicione credenciais se necessário e então inicie uma sessão em `http://127.0.0.1:9180/new`. ## CLI Não Interativa ```bash evener --model openai/gpt-5.2 "add input validation to the signup handler" ``` Os prompts podem ser enviados via stdin. Use `--verbose` para saída de eventos NDJSON adequada para encaminhar a `jq` ou agregação de logs. ## llmcall Um wrapper de CLI minimalista para chamadas únicas e "descartáveis" a LLMs, sem loop de agente, sem chamadas de ferramentas e com modos opcionais de saída JSON/JSON Schema. ## Agradecimentos Evener é um fork de Kilroy, de Dan Shapiro, originalmente criado como parte do projeto StrongDM Attractor. O cliente LLM unificado, os adaptadores de provedor e o loop agêntico de chamadas de ferramentas têm sua linhagem nesse trabalho. Kilroy é licenciado sob a Licença MIT.