amenbo 4.0.0 — Dá para fazer sua IA abrir toda sessão pelo amenbo

Esta versão muda o jeito como uma IA fica sabendo do amenbo numa pasta pela primeira vez, e refaz a tela de plugins em torno de uma linha por projeto. Leia a seção de atualização antes de subir de versão.

Dá para fazer sua IA abrir toda sessão pelo amenbo

Até agora, a única coisa que dizia a uma IA como trabalhar com o amenbo numa pasta era um texto parado no CLAUDE.md ou no AGENTS.md. Se a IA lia ou não era decisão dela, e o trabalho feito sem ler não fica registrado em lugar nenhum. As ferramentas de IA têm um gancho de início de sessão — um mecanismo que roda algo fixo toda vez que uma sessão abre — e o amenbo agora te entrega a configuração para se colocar ali.

• amenbo agent-hook snippet claude-code imprime o texto e onde ele vai — são cinco ferramentas atendidas: Claude Code, GitHub Copilot CLI, Cursor, Codex CLI e Gemini CLI.
• O amenbo nunca escreve no arquivo de configuração da ferramenta — o que ele imprime é um pedido endereçado à IA com quem você trabalha. Você entrega esse texto e a IA edita o arquivo; o pedido diz para ela manter o que já estiver lá e acrescentar.
• Uma pasta sem a configuração avisa, e nomeia a ferramenta — o amenbo descobre qual ferramenta você usa pelos rastros deixados na pasta.

$ amenbo status
⚠ One step is left before your AI keeps this work in amenbo: Claude Code's settings here do not open a session with `amenbo agent`.
  The text to give your AI: amenbo agent-hook snippet claude-code

Com a configuração no lugar, o aviso para. Se você não quer, rode o comando amenbo agent-hook answer no e ele para de perguntar — o texto continua disponível pelo comando snippet sempre que você quiser. A GUI faz o mesmo: você é perguntado uma vez ao abrir a pasta, e apertar “Me dá o texto” mostra ele. Numa pasta sem rastro de ferramenta nenhuma, você escolhe entre as cinco.

A chave de um plugin e as configurações dele ficam numa linha

• Uma linha por projeto — a tela de plugins agora é uma linha por projeto. “Adicionar um projeto…” acrescenta uma, e a chave que liga e desliga o plugin mora nessa linha.
• As configurações abrem dentro da linha — apertar “Configurações” abre as configurações daquele projeto embaixo dela, então não há o que reescolher.
• Uma configuração obrigatória vazia aparece antes de você apertar qualquer coisa — a linha diz “Configuração obrigatória não preenchida”. Preencha e ela vira “Configuração preenchida”, e o plugin pode ser ligado.
• As configurações do próprio projeto chegam à mesma linha — a tela de configurações do projeto tem uma seção “Plugins”, e uma linha acrescentada ali traz a mesma chave e as mesmas configurações.

As notificações em espera podem ser empurradas

As notificações para plugins normalmente pegam carona na escrita que você estava fazendo. O que parou no meio do caminho espera a próxima escrita, então, com uma pausa no seu trabalho, aquilo pode ficar sem ser entregue. Rode o novo comando amenbo plugin flush para mandar o que está esperando, agora.

$ amenbo plugin flush
Nothing was waiting: every plugin's queue is empty.

Coisas menores

• amenbo task show abre com o estado — em qual dos cinco (todo / in progress / blocked / done / rejected) a tarefa está. Antes ele dizia só se a tarefa estava concluída.
• O show conta os comentários e mostra uma prévia deles — tanto para tarefas quanto para registros de decisão.
• Um plugin que lê o amenbo de volta não para mais no meio — um plugin que perguntava ao amenbo sobre o evento que tinha acabado de receber falhava com um erro.
• A notificação de comentário nomeia a tarefa em que o comentário está — quem recebe consegue saber do que se trata.

Antes de atualizar

• O formato dos dados guardados sobe — ele migra sozinho na primeira vez que uma versão mais nova o abre, e um backup é tirado antes. Versões antigas não conseguem abrir depois disso, então não deixe a GUI nem a CLI na versão antiga (o mesmo instalador atualiza as duas).
• dimension rename e dimension value-rename acabaram — para renomear uma dimensão, rode o comando amenbo dimension update <dimension> --name <new name>; para um valor, amenbo dimension value-update <dimension> <value> --name <new name>.

Como obter

Abra o instalador do seu sistema na versão mais recente. Não precisa de direitos de administrador.

• macOS — .pkg, um para Apple silicon e um para Intel (a GUI e a CLI vêm juntas; a primeira abertura mostra um aviso do Gatekeeper: clique com o botão direito → Abrir)
• Windows — .exe de instalação (a GUI e a CLI vêm juntas)
• Linux — a GUI é um AppImage; o comando amenbo vem do instalador da CLI

Para atualizar: na GUI, o banner de “há uma versão mais nova” aplica a atualização ali mesmo. Se você instalou só a CLI, amenbo update --apply faz a troca.

Chegou agora? Veja Começar.