amenbo

amenbo 2.0.0 — plugin: un tuo programma parte quando un'attività si muove

Installa un plugin e parte quando a un'attività succede qualcosa. Un team può servire i propri plugin da un catalogo suo. Sulla CLI, `--actor` adesso è obbligatorio su ogni comando.

Da questa release un programma scritto da te può partire quando a un’attività succede qualcosa. È cambiata anche una cosa nel modo di chiamare la CLI, e comandi che prima funzionavano adesso vengono rifiutati — leggi «Sull’aggiornamento» prima di aggiornare.

Plugin

  • Gli eventi delle attività chiamano il tuo programma — un plugin parte quando un’attività viene completata, quando cambia stato, quando le si aggiunge un commento. Puoi anche eseguirne uno tu con amenbo plugin run <name>.
  • Installalo dalla schermata Market, o dalla riga di comando — scegline uno dal catalogo ufficiale nella schermata «Market» della GUI, oppure esegui amenbo plugin install <name>. Oggi lì c’è una voce sola: worktree, che ritaglia un worktree di git per ogni attività.
  • Installare non vuol dire accendere — abilitarlo è un passo a parte, amenbo plugin enable <name>. Se quell’interruttore sia per progetto o per macchina lo sceglie l’autore del plugin.
  • Firma e checksum si controllano prima che atterri qualsiasi cosa — quello che non si riesce a verificare non viene installato.
  • Un plugin è solo un eseguibile — scrivilo nel linguaggio che vuoi. amenbo lo avvia come processo figlio e gli passa del JSON sullo standard input. Vedi Scrivere un plugin.

Cosa puoi leggere, impostare e controllare

  • Apri una riga e vedi cosa stai prendendo — il dettaglio ti dice quali eventi chiamano il plugin e cosa dovrai configurare una volta dentro, prima ancora di installarlo.
  • Le impostazioni sono un modulo — i campi che l’autore dichiara nel manifest diventano il modulo. I campi segreti sono mascherati, e un progetto può sovrascrivere i valori che gli servono.
  • amenbo plugin log — le esecuzioni recenti, con il loro output e i codici di uscita. È qui che si guarda quando un plugin non ha fatto quello che ti aspettavi.

Servi i plugin da un catalogo tuo

  • Registra un catalogo e i suoi plugin si mettono accanto a quelli ufficialiamenbo plugin catalog add <URL of catalog.json> --name "Team catalog", e compaiono nello stesso elenco, pronti da installare. I plugin interni si possono distribuire senza passare dal catalogo ufficiale.
  • Un catalogo sono tre file statici — nessun processo server da tenere acceso. Vedi Gestire un catalogo.
  • La chiave di firma si fissa al momento della registrazione — registrandolo ti viene mostrata l’impronta della chiave che il catalogo pubblica, e accettandola la fissi. Da lì in poi i plugin installati da quel catalogo si verificano con quella chiave. Un catalogo a cui la chiave è stata cambiata viene rifiutato; un catalogo che non pubblica nessuna chiave si può solo sfogliare.
  • Ogni riga porta il nome del suo catalogo — e l’elenco si può filtrare per provenienza. Il marchio «ufficiale» va solo alle voci del catalogo ufficiale: un catalogo di terze parti che se lo attribuisce da sé non lo ottiene.
  • Un plugin installato si ricorda da dove viene — gli aggiornamenti si prendono da quel catalogo, quindi lo stesso nome in un catalogo diverso non viene mai raccolto per sbaglio.

Anche in questa versione

  • Respingere una decisione dalla GUI — scrivi il motivo e la respingi lì. Non serve passare alla CLI per farlo.
  • Due impostazioni che non facevano niente adesso fanno qualcosadefault_view, la vista che si apre all’avvio, e date_locale, come si scrivono le date.
  • Classificare un’attività mentre la creiamenbo task add --dim <axis>=<value>. Anche amenbo task show stampa la classificazione dell’attività.

Sull’aggiornamento

  • --actor adesso è obbligatorio su ogni comando della CLI che tocca l’archivio — prima lo riempiva la variabile d’ambiente AMENBO_ACTOR, oppure un valore predefinito quando non scrivevi niente. Da questa release lo scrivi ogni volta: --actor human quando stai scrivendo tu, --actor ai quando è un’IA. Per esempio, amenbo task list --actor human. Se lo avevi impostato con la variabile d’ambiente, spostalo sui comandi. Anche gli AGENTS.md e i CLAUDE.md che amenbo mette adesso scrivono per esteso --actor ai. Nella GUI non cambia niente.
  • Il formato dei dati salvati sale di versione — il primo avvio su questa versione lo migra, e un backup precedente alla migrazione viene tenuto in automatico. Una volta migrato, una versione precedente non riesce più ad aprirlo. GUI e CLI le aggiorna insieme lo stesso installer, quindi non lasciarne una alla versione vecchia.

Come ottenerlo

Apri l’installer per il tuo sistema operativo dall’ultima release. GUI e CLI arrivano insieme, e non servono diritti di amministratore.

  • macOS — .pkg, uno per Apple silicon e uno per Intel (alla prima apertura compare l’avviso di Gatekeeper: clic destro → Apri)
  • Windows — .exe di setup
  • Linux — .deb / .rpm

Per aggiornare: nella GUI, il banner «è disponibile una versione più recente» adesso lo applica sul posto. Se hai installato solo la CLI, amenbo update --apply la sostituisce.

È la prima volta? Vedi Inizia.