Suporte do Ground Control

O macOS mantém todo app da Mac App Store longe dos seus arquivos até você escolher o que ele pode ver. Liberar a pasta de início uma vez cobre todos os repositórios do Mac, as configurações do Git e as chaves SSH, para o Git saber seu nome e e-mail e os remotos por SSH funcionarem. Na tela de boas-vindas, clique em Give Access to Your Home Folder e depois em Grant Access no painel.

Dá para escolher só algumas pastas (Choose Folders…), mas aí o Git não lê suas configurações nem suas chaves SSH. Em Settings → Repositories → Folder Access você vê o que o Ground Control pode ver, adiciona uma pasta ou retira o acesso. Um repositório fora de tudo isso aparece como No access; ao abri-lo, o app pede a pasta dele.

Para o GitHub por HTTPS, o Ground Control tem o próprio login, em Settings → GitHub. Use GitHub CLI Login usa o login da ferramenta de linha de comando gh (o macOS pergunta uma vez se pode compartilhar); Paste a Token… aceita um token clássico com os escopos repo e workflow, ou um fine-grained com Contents de leitura e escrita. O token fica nas chaves do seu Mac, e Sign Out o apaga.

Para SSH, libere a pasta de início para o Git chegar às suas chaves e confira se a chave está na sua conta do GitHub. Se o Ground Control não conseguir confirmar a identidade do servidor, rode ssh -T git@github.com uma vez no Terminal para confiar nele. Em Settings → Repositories você escolhe se novos clones do GitHub usam SSH key ou HTTPS.

É opcional. O macOS marca todo arquivo que um app em sandbox grava, e um script ou programa marcado não roda pelo Terminal. Instalado uma vez, o helper faz pulls, trocas de branch, merges e outras gravações fora do sandbox, como o Terminal faria, para o que eles gravam continuar executável; ele também traz pull requests e checks da ferramenta gh. Sem ele, todo o resto funciona normalmente.

Para instalar, abra Settings → Advanced → Helper, clique em Copy Command, cole no Terminal e aperte Return, depois clique em Check Again. Se depois de uma atualização aparecer Needs installing again, rode o comando mais uma vez.

Eles vêm do GitHub pela ferramenta de linha de comando gh, que a versão da Mac App Store alcança pelo helper. Instale o gh (brew install gh), faça login com gh auth login no Terminal e instale o helper. O repositório precisa ter um remoto no GitHub.

Aí a lista de branches mostra os pull requests abertos, cada commit mostra o resultado do Actions e a tela inicial lista os pull requests que esperam a sua revisão. Na página de um pull request você comenta, aprova, pede mudanças e faz merge.

Um repositório é grátis: o primeiro que você abrir. O Ground Control Pro abre todos, como assinatura anual (com uma semana grátis, se você tiver direito) ou compra vitalícia única. O preço aparece na sua moeda antes de comprar.

Em outro Mac com a mesma Conta Apple, o Pro costuma ativar sozinho. Se não ativar, abra um repositório com cadeado, ou Settings → General → See Plans, e clique em Restore Purchases. Para cancelar uma assinatura, use a página de assinaturas da Apple: na App Store, clique no seu nome e vá aos ajustes da conta.

Seu código só vai para onde o Git manda: fetch, pull, push e clone falam com os remotos dos seus repositórios. Todo repositório recebe fetch em segundo plano a cada 15 minutos; mude isso em Fetch every repository, em Settings → Repositories. Os recursos do GitHub pedem ao GitHub pull requests, checks e fotos de perfil, e a página de planos confere a sua compra no nosso serviço de assinaturas. Sem conta e sem anúncios.

A lista de pastas e os ajustes ficam no seu Mac, o token do GitHub nas chaves, e Remove from Ground Control (clique direito num repositório na tela inicial) nunca mexe nos arquivos dele. Quando um fetch encontra push ou merge de colegas, o Ground Control pode avisar com uma notificação (o macOS pergunta antes); Tell me when others push or merge desliga isso.