amenbo 2.0.0 — plugins: seu programa roda quando uma tarefa se mexe

A partir desta versão, um programa escrito por você pode rodar quando algo acontece com uma tarefa. Uma coisa também mudou no jeito de chamar a CLI, e comandos que funcionavam antes agora vão ser recusados — leia “Ao atualizar” antes de subir de versão.

Plugins

• Eventos de tarefa chamam o seu programa — um plugin roda quando uma tarefa é concluída, quando o estado dela muda, quando um comentário é adicionado. Você também pode rodar um na mão com amenbo plugin run <name>.
• Instale pela tela do Market, ou pela linha de comando — escolha um no catálogo oficial pela tela “Market” da GUI, ou rode amenbo plugin install <name>. Hoje há uma entrada lá: worktree, que corta um worktree do git por tarefa.
• Instalar não é ligar — habilitar é um passo à parte, amenbo plugin enable <name>. Se essa chave é por projeto ou por máquina, quem escolhe é quem escreveu o plugin.
• A assinatura e a soma de verificação são conferidas antes de qualquer coisa entrar — o que não dá para verificar não é instalado.
• Um plugin é só um executável — escreva na linguagem que quiser. O amenbo o inicia como processo filho e entrega JSON na entrada padrão. Veja Writing a plugin.

O que dá para ler, ajustar e conferir

• Abra uma linha e veja o que você está levando — o detalhe diz quais eventos chamam o plugin e o que você vai ter que configurar depois que ele entrar, antes de instalar.
• As configurações são um formulário — os campos que o autor declara no manifesto viram o formulário. Campos secretos ficam mascarados, e um projeto pode sobrescrever os valores que precisar.
• amenbo plugin log — as execuções recentes, com a saída e os códigos de saída delas. É aqui que se olha quando um plugin não fez o que você esperava.

Sirva plugins do seu próprio catálogo

• Registre um catálogo e os plugins dele ficam ao lado dos oficiais — amenbo plugin catalog add <URL of catalog.json> --name "Team catalog", e eles aparecem na mesma lista, prontos para instalar. Plugins internos podem ser distribuídos sem passar pelo catálogo oficial.
• Um catálogo são três arquivos estáticos — nenhum processo de servidor para manter. Veja Running a catalog.
• A chave de assinatura é fixada quando você registra — ao registrar, ele te mostra a impressão digital da chave que o catálogo publica, e concordar fixa essa chave. Os plugins instalados daquele catálogo passam a ser verificados com ela dali em diante. Um catálogo cuja chave foi trocada é recusado; um catálogo que não publica chave só pode ser folheado.
• Toda linha traz o nome do catálogo dela — e a lista pode ser filtrada por origem. A marca de “oficial” só é dada às entradas do catálogo oficial: um catálogo de terceiros que se declare oficial não a recebe.
• Um plugin instalado lembra de onde veio — as atualizações são buscadas naquele catálogo, então o mesmo nome em outro catálogo nunca é pego por engano.

Também nesta versão

• Rejeitar um registro de decisão pela GUI — escreva o motivo e rejeite ali mesmo. Não precisa passar para a CLI para isso.
• Duas configurações que não faziam nada agora fazem — default_view, a visão aberta na inicialização, e date_locale, como as datas são escritas.
• Classificar uma tarefa na hora de criar — amenbo task add --dim <axis>=<value>. O amenbo task show também imprime a classificação da tarefa.

Ao atualizar

• --actor agora é obrigatório em todo comando da CLI que toca na base — antes ele era preenchido pela variável de ambiente AMENBO_ACTOR, ou por um padrão quando você não escrevia nada. A partir desta versão você escreve toda vez: --actor human quando quem digita é você, --actor ai quando é uma IA. Por exemplo, amenbo task list --actor human. Se você tinha isso pela variável de ambiente, passe para os comandos. Os AGENTS.md e CLAUDE.md que o amenbo deixa também trazem --actor ai escrito. Na GUI nada muda.
• O formato dos dados guardados sobe — a primeira abertura nesta versão faz a migração, e um backup de antes dela é guardado automaticamente. Depois de migrados, uma versão anterior não consegue mais abrir. A GUI e a CLI são atualizadas juntas pelo mesmo instalador, então não deixe uma das duas na versão antiga.

Como obter

Abra o instalador do seu sistema na versão mais recente. A GUI e a CLI vêm juntas, e não precisa de direitos de administrador.

• macOS — .pkg, um para Apple silicon e um para Intel (a primeira abertura mostra um aviso do Gatekeeper: clique com o botão direito → Abrir)
• Windows — .exe de instalação
• Linux — .deb / .rpm

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

Chegou agora? Veja Começar.