gyokuro

Funcionalidades em detalhe

Seis coisas que o gyokuro faz bem — aqui em detalhe, em vez de numa frase.

Issues e pull requests

Criar, comentar, etiquetar, fazer merge — o fluxo de trabalho completo, sem portátil.

Tocas diretamente em títulos, descrições e detalhes e alteras-os no próprio local — sem um modo de edição separado. Crias labels em qualquer altura, e alteras milestones e responsáveis no mesmo passo. Gestos de deslizar fecham, reabrem ou atribuem issues, sem passares pela vista de detalhe.

Nos pull requests tens o controlo total: alterar o branch base, o milestone e os revisores, submeter reviews, fixar comentários a linhas individuais do diff e atualizar o branch com um toque. O estado do merge fica bem visível no topo, e o iPad mostra os diffs lado a lado.

Os comentários podem ser editados, eliminados e marcados com reações de emoji; o histórico de atividade mostra o que aconteceu ao longo de uma issue. Podes juntar várias issues numa só — anexos incluídos — ou copiá-las de uma vez para vários repositórios.

Actions e runners

Acompanhar execuções de workflows, ler logs, reiniciar diretamente execuções falhadas.

Vês as execuções de workflows em curso e passadas, com estado e duração. Os logs chegam a cores e em direto, para poderes ver um build a decorrer em vez de adivinhar depois. Reinicias diretamente execuções falhadas, também podes acionar workflows manualmente e cancelar execuções em curso.

Também geres os próprios runners a partir da app: registar novos, colocar em pausa ou remover os existentes. Quem tem o seu CI no homelab já não precisa de se sentar ao computador para isso.

Para isto é preciso que as Actions estejam ativadas no servidor e no respetivo repositório — se não estiverem, a secção fica simplesmente vazia.

Ler e editar código

Pesquisa de texto integral no código-fonte, edição direta de ficheiros e commit.

A pesquisa de código percorre o código-fonte de todos os teus repositórios — útil quando estás fora e só precisas de saber rapidamente de onde vem uma função.

Os ficheiros podem ser editados diretamente na app: com destaque de sintaxe, indentação automática e commit sem rodeios. Criar e eliminar ficheiros novos também está incluído. O Markdown é apresentado tal como deve ser — READMEs, callouts de aviso, listas de tarefas marcáveis e código com destaque de sintaxe.

As releases não te limitas a ver: crias, editas e carregas ou removes ficheiros como assets.

Notificações

Push através do teu próprio servidor ntfy ou Gotify — self-hosted até ao fim.

Para as mensagens push, o gyokuro usa a tua própria instância de ntfy ou Gotify. Não há nenhum desvio por um serviço de terceiros — a notificação segue o mesmo caminho que o resto da tua infraestrutura.

O que chega até ti filtras por repositório e por tipo. Assim recebes de imediato as menções do projeto principal, enquanto um repositório de arquivo fica em silêncio. Um badge da app mostra o número de notificações não lidas.

Além disso há notificações locais sem necessidade de servidor, e um relatório semanal opcional: os últimos sete dias com atividades, issues, pull requests, linhas de código e os repositórios mais ativos.

Feito para o homelab

Tantos servidores quantos quiseres — também com certificados próprios, proxy ou endereços internos.

O gyokuro parte do princípio de que o teu servidor não está num centro de dados com um certificado perfeito. Certificados autoassinados são fixados com segurança em vez de aceites às cegas, e a isso juntam-se mTLS, proxies HTTP e SOCKS, cabeçalhos HTTP próprios e Basic Auth.

Podes guardar quantas instâncias de Gitea e Forgejo quiseres, em paralelo, e alternar entre elas. Servidores que só permitem acesso à API com autenticação também funcionam.

Se mesmo assim a autenticação falhar, o registo em direto ajuda-te a ligar: regista cada passo da verificação, para veres de imediato se o problema está no endereço, no certificado ou no token.

Os teus dados continuam teus

O teu token fica no porta-chaves e nunca vai parar a servidores de terceiros. Sem cloud, sem contas, sem monitorização por terceiros.

O gyokuro comunica exclusivamente com os servidores que tu próprio configuras. Não existe nenhum serviço intermédio, nenhuma conta de utilizador nem qualquer registo.

Os tokens de acesso ficam exclusivamente no porta-chaves do iOS, no teu dispositivo. Desde a versão 2.3, o gyokuro garante ainda que um token não é enviado por engano para servidores de terceiros — por exemplo, quando um repositório aponta para conteúdo externo.

Não estão integrados serviços de análise, monitorização ou publicidade de terceiros, e os relatórios de falhas não são enviados a terceiros. A partir da versão 3.0, o gyokuro regista um pequeno número de eventos anónimos sobre configuração, período experimental e compra, e envia-os para um servidor que operamos nós próprios na Alemanha — sem endereços IP, sem identificadores de dispositivo e sem qualquer relação com os teus repositórios. Desativável nas definições da app; os detalhes estão na Política de Privacidade.

← gyokuro