Ir para o conteúdo
Promovaweb
Voltar ao site
Menu

Plugin Maintainer Inbox no Omarchy

Em destaque

O que o Plugin Maintainer Inbox faz no seu Omarchy

  1. Veja issues e pull requests abertos nos seus repositórios
  2. Acompanhe respostas em qualquer repositório do GitHub
  3. Marque um item como esperando terceiros
  4. Dispense ou silencie itens sem sair do painel
  5. Receba notificação quando aparecer resposta
Maintainer Inboxio.github.davidboulay.maintainer-inbox
Tipo
Widget da barra
Categoria
Ferramentas de desenvolvimento
Mantenedor
David Boulay
Licença
MIT
Versão
0.2.1
Compatibilidade
Exige o gh autenticado, com escopo repo para repositórios privados, e python3. Nenhum token é lido ou guardado. O gh instalado pelo mise é encontrado mesmo fora do PATH do shell. Referência do portal: Omarchy 4.5.0-rc1.
Tags
#barra#quickshell
Painel do Maintainer Inbox na barra do Omarchy com a lista de issues e pull requests abertos, agrupados entre os que esperam resposta e os que aguardam retorno.
Repositório davidboulay/omarchy-maintainer-inbox (MIT)

Instalar e manter

  1. Instale o plugin

    O Omarchy clona o repositório do plugin e valida os arquivos no seu computador. Só depois ele instala e ativa o plugin.

    Instalar
    omarchy plugin add https://github.com/davidboulay/omarchy-maintainer-inbox.git --enable

  2. Atualize quando sair uma versão nova

    Rode este comando para trazer as mudanças publicadas no repositório do plugin.

    Atualizar
    omarchy plugin update io.github.davidboulay.maintainer-inbox

  3. Remova quando não precisar mais

    O comando retira o plugin do seu Omarchy. Use o mesmo identificador mostrado no cartão de detalhes.

    Remover
    omarchy plugin remove io.github.davidboulay.maintainer-inbox

O Maintainer Inbox reúne, na barra do Omarchy, toda issue e pull request aberto nos repositórios que você mantém, além das respostas às suas conversas em qualquer lugar do GitHub. O item fica visível até você responder.

As notificações do GitHub não garantem esse comportamento. Elas só existem para repositórios que você acompanha no nível certo. Qualquer item marcado como lido no celular, por e-mail ou na web desaparece delas. O widget ignora as notificações e consulta a busca do GitHub com is:open archived:false user:<você>.

Antes de instalar

Você precisa do gh autenticado, com gh auth login e escopo repo para repositórios privados, e de python3. Nenhum token é lido ou guardado. Um gh instalado pelo mise é encontrado mesmo quando não está no PATH do shell.

Instale e configure

Terminal
omarchy plugin add https://github.com/davidboulay/omarchy-maintainer-inbox.git --enable

O painel abre pelo ícone da barra. As opções ficam na engrenagem do painel ou no comando de barra:

Terminal
omarchy bar set io.github.davidboulay.maintainer-inbox refreshIntervalMin 10
omarchy bar set io.github.davidboulay.maintainer-inbox owners lojel,lojel/lojel-wp

As chaves são refreshIntervalMin (5), owners (outros donos ou pares owner/repo, separados por vírgula), participating (ligado), excludeBots, notify, hideWhenEmpty e staleAfterMin (60).

Entenda o que espera resposta

Um item espera por você quando a atividade mais recente nele vem de outro autor, seja abrindo, comentando, revisando ou enviando um commit. Comentários, revisões e commits de bots, incluindo resumos de CI, revisores de IA e bots de rebase, não valem como resposta.

O painel separa dois grupos. On your repos traz issues e pull requests abertos nos repositórios seus e nos donos ou repositórios extras que você acrescentar. Replies to you traz itens em qualquer repositório do GitHub que você abriu, comentou ou recebeu menção ou atribuição, quando chega uma resposta depois da sua participação. O segundo grupo pode ser desligado nas opções.

Estado Significado Sai quando
Needs you a última atividade é de outro autor você responde no GitHub ou aperta d
Waiting on them a última atividade é sua o outro autor responde
Dismissed você deixou o item de lado com d chega atividade externa nova
Muted você encerrou o assunto com m você desfaz o silêncio

Issues abertas por você só aparecem depois que outro autor comenta.

Tecla Ação
j e k percorrem os itens
Enter abre o item no GitHub
d dispensa ou restaura
m silencia ou retoma
w, h e u mostram os que esperam, os dispensados e os silenciados
r atualiza a consulta
, abre as opções

Cada item ou resposta nova envia uma notificação de área de trabalho. O clique abre o item no GitHub. Quando mais de três chegam juntos, você recebe um resumo único. A barra mostra o número em cor de urgência. Se o GitHub ficar inacessível pelo limite configurado, que começa em uma hora, o ícone fica urgente e mostra !, para uma falha de consulta não passar em silêncio. Para testar o clique da notificação:

Terminal
omarchy-shell io.github.davidboulay.maintainer-inbox testNotification

O estado do que já foi notificado e das dispensas fica em ~/.local/state/omarchy-maintainer-inbox/state.json.

Atualize e remova

Terminal
omarchy plugin update io.github.davidboulay.maintainer-inbox
omarchy plugin remove io.github.davidboulay.maintainer-inbox
rm -rf ~/.local/state/omarchy-maintainer-inbox

A remoção do plugin não apaga o estado, então a última linha limpa o registro de notificações e dispensas. O histórico do GitHub continua intacto, já que o widget não escreve nada no repositório.