amenbo 3.0.0 — O plugin se liga por projeto, e as configurações dele vão no backup

Os plugins agora se ligam um projeto por vez, e o lugar onde as configurações deles ficam mudou. Leia a seção de atualização antes de subir de versão.

A chave de um plugin é uma por projeto

• A chave por dispositivo acabou — havia dois tipos de chave: uma que valia por projeto e outra que valia para o dispositivo inteiro, e quem escrevia o plugin decidia qual delas ele tinha. Agora todo plugin tem uma única chave por projeto.
• A linha nomeia os projetos em que ele está ligado — em vez de um sim ou não, você vê os nomes dos projetos em que o plugin roda. Desligue um e dá para ver que ele continua rodando nos outros. Se nenhum nome aparece, ele não roda em lugar nenhum.
• Também dá para ligar pelas configurações de um projeto — você chega à mesma chave pelas duas pontas: “em quais projetos este plugin roda” e “quais plugins rodam neste projeto”. Não é mais preciso caçar numa lista de plugins para desligar alguma coisa.
• Instalar não pergunta mais qual projeto — instalar não mira projeto nenhum, então não pergunta. A tela diz que ainda não roda nada, e onde ligar.
• Ligar já é a permissão para rodar — o pedido de consentimento à parte acabou.
• A CLI também nomeia os projetos — cada linha de amenbo plugin list mostra os projetos em que o plugin roda. amenbo plugin enable / disable mexem na chave do projeto da pasta em que você está.

Configurações e segredos agora vão no backup

• Uma restauração devolve tudo funcionando — restaurar de um backup voltava com as configurações perdidas e cada credencial para digitar de novo. O backup agora leva o estado inteiro de um plugin.
• Os valores pertencem a um projeto — --scope saiu de amenbo plugin config set / get; eles leem e escrevem o valor do projeto da pasta em que você está. O formulário de configurações na GUI edita o projeto que ele está mostrando.

A ajuda de um plugin agora vem do plugin

amenbo plugin run <name> --help agora imprime o uso do próprio plugin. Antes ele devolvia o texto do próprio amenbo, então não havia como descobrir como um plugin funcionava.

Toda palavra depois do nome pertence ao plugin. As flags do próprio amenbo (como --actor) vão antes do nome.

amenbo --actor ai plugin run worktree --help

A CLI do Linux roda em distribuições mais antigas

O comando amenbo não iniciava em distribuições um pouco mais antigas, como o Ubuntu 22.04. A GUI (AppImage) rodava lá, então dava para acabar com só metade funcionando na mesma máquina.

Antes de atualizar

• O formato dos dados guardados sobe — ele migra sozinho na primeira vez que a versão 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).
• Os plugins que você tinha ligados para o dispositivo inteiro passam a ser por projeto — o que rodava em todo projeto daquele dispositivo volta ligado em cada um deles. Desligue os que você não quer.
• Tire o --scope se você passava — amenbo plugin config set / get não aceitam mais.

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.