Agente de linha de comando

Um programador dentro do seu terminal.

Ele lê a base de código, escreve os arquivos, roda os testes e corrige o que quebrou — no seu servidor, uma ação por vez, sempre conferindo o resultado real.

curl -fsSL https://ember.nuvhost.cloud/install.sh | bash
Como instalar Experimentar no navegador
  • Roda no seu servidor
  • Sem telemetria
  • Instala em um comando

O que ele faz de diferente

Um agente que age no seu ambiente, guarda o que aprendeu e sabe quando parar para perguntar.

Executa, não sugere

Cria e edita arquivos, roda comandos e confere o resultado real antes de decidir o próximo passo — no seu ambiente, não num sandbox de mentira.

Uma ferramenta por vez

Cada passo é uma ação verificável, com o resultado voltando pro contexto. Nada de resposta inventada sobre um comando que nunca rodou.

Memória entre sessões

Instruções do projeto em EMBER.md e o que ele aprendeu em .ember/MEMORY.md — lidos de volta toda vez que você abre o agente na mesma pasta.

Skills reutilizáveis

Fluxos de trabalho guardados em .ember/skills/*.md. O agente carrega a skill quando a tarefa combina, e cria novas quando você pede.

Busca na web de verdade

Pesquisa e lê páginas por conta própria quando a pergunta pede informação que ele não tem — sem responder que “não tem acesso à internet”.

Freio antes do estrago

Sobrescrever, apagar e comando destrutivo passam por confirmação. Criar arquivo novo e editar trecho seguem direto.

Onde ele põe a mão

Cada ferramenta é uma ação real no seu ambiente, não um trecho de texto sugerido.

arquivos

read_file
lê um arquivo com número de linha, em partes se for grande
write_file
cria ou sobrescreve um arquivo com o conteúdo completo
edit_file
troca um trecho exato de um arquivo já existente
delete_file
apaga um arquivo
list_dir
lista o conteúdo de um diretório

busca

grep
busca um padrão no conteúdo dos arquivos, recursivamente
glob
encontra arquivos por nome, mais recentes primeiro

execução

bash
roda um comando shell no diretório de trabalho

web

web_search
busca na internet e devolve título, trecho e link
web_fetch
baixa uma URL e devolve o texto legível da página

notebooks

notebook_read
lê um .ipynb célula por célula, com a saída de cada uma
notebook_edit
edita, insere ou remove célula por índice

visão

view_image
enxerga de fato o conteúdo de uma imagem antes de responder

planejamento

todo_write
escreve a lista de tarefas, uma em andamento por vez
todo_read
mostra a lista de tarefas atual

skills

use_skill
carrega um fluxo de trabalho salvo em .ember/skills/

Como ele trabalha

O mesmo laço se repete até a tarefa estar concluída de verdade.

  1. 01

    pensa

    lê o histórico da conversa e decide o próximo passo — texto ou uma chamada de ferramenta.

  2. 02

    chama a ferramenta

    executa exatamente uma ferramenta por vez e espera o resultado real, nunca inventado.

  3. 03

    vê o resultado

    o resultado volta pro histórico e vira contexto pro próximo passo.

  4. 04

    repete ou responde

    continua até a tarefa estar de fato concluída, aí sim responde em texto puro.

Freio de mão embutido

Rápido para criar, cauteloso para destruir.

sobrescrever arquivo existente

write_file num arquivo que já existe apaga o conteúdo anterior por inteiro — pede confirmação antes.

apagar arquivo

delete_file não tem desfazer — pede confirmação antes, sempre.

comandos destrutivos no bash

rm -r, find -delete e afins passam pela mesma confirmação antes de rodar.

loop de replanejamento

chamar a lista de tarefas em círculo sem executar nada é detectado e cortado — a rodada é empurrada de volta pra ação.

Criar um arquivo novo ou editar um trecho específico não pede nada — é o caminho comum. Já sobrescrever, apagar ou rodar algo irreversível passa por uma confirmação explícita antes de acontecer, do mesmo jeito que rm -r deveria sempre ter pedido.

Instalar

Um comando em qualquer servidor Linux com Python 3. Rodar de novo atualiza sem perder sua configuração.

curl -fsSL https://ember.nuvhost.cloud/install.sh | bash

Precisa de root (ele mesmo pede sudo) e instala em /opt/ember, com o comando ember disponível em qualquer pasta.

Depois de instalar

ember
abre o agente na pasta atual
ember -p "tarefa"
modo não interativo, pra script e CI (código de saída 0/1)
ember -c
continua a última conversa de onde parou
/skills
lista os fluxos de trabalho salvos no projeto
/memory
mostra o que o agente guardou sobre este projeto
/export
salva a conversa inteira em Markdown