Git e GitHub

O que você pode fazer

• Conecte sem nunca manusear um token: o PocketCode usa o device flow do GitHub, que não precisa de client secret e verifica a cada poucos segundos até você aprovar.
• Veja o que é pedido antes de aprovar: as permissões repo, read:user e user:email. repo é o que alcança os repositórios privados.
• Use essa única conta para clone, publicar, fetch, pull, push, o painel PRs e issues do GitHub e o feed de CI.

O que você não pode fazer, e por quê

• Conectar uma segunda conta do GitHub (ou uma segunda conta de qualquer provedor) no Free: a primeira conta de cada provedor é grátis, mais contas são Pro.Pro
• Usar o login por código quando o GitHub não o ativou para o app OAuth do PocketCode: o painel então diz que o GitHub não o está oferecendo agora.Terceiros

O que você pode fazer

• Clonar repositórios privados e públicos, do GitHub, GitLab ou Bitbucket, desde que essa conta esteja conectada.
• Obter o histórico completo: um clone não é raso.

O que você não pode fazer, e por quê

• Clonar a partir de uma URL, ou um repositório que não está na lista da sua conta.Ainda não
• Clonar de outros hosts (GitHub Enterprise, GitLab auto-hospedado, Gitea, Codeberg…): só github.com, gitlab.com e bitbucket.org são suportados.De propósito
• Clonar sem uma conta conectada, mesmo um repositório público.Precisa de rede
• Baixar submódulos ou conteúdo do Git LFS: submódulos não são clonados, e arquivos LFS continuam como seus pequenos ponteiros de texto.Ainda não
• Ver o progresso real: a barra avança por etapas, não por bytes.Ainda não

O que você pode fazer

• Publicar no GitHub, GitLab ou Bitbucket.
• Obtenha o mesmo resultado em Git → Criar em GitHub e ligar, ou ligue um repositório que você já tem com Ligar um repositório que já tenho (veja Git no cartão do projeto).

O que você não pode fazer, e por quê

• Publicar sem nenhum serviço conectado: o painel diz Conecte GitHub, GitLab ou Bitbucket em Serviços primeiro, e você não consegue conectar a partir dali.Precisa de rede
• Publicar em outro host.De propósito

O que você pode fazer

• Toque em um arquivo para ler o diff: linhas adicionadas e removidas em cor, com números de linha e totais +N −M. Trocar inverte os dois lados.
• Mova um arquivo com Preparar / Desfazer preparação na linha dele (Rastrear e preparar para um arquivo novo), ou um grupo inteiro com Preparar tudo / Desfazer preparação de tudo.
• Use os ícones Atualizar, Trazer e Enviar no cabeçalho. Pull e push rodam na hora, sem perguntar, e cada um termina com uma mensagem (Push realizado ou O push falhou: …).
• Veja Nenhuma alteração (A árvore de trabalho está limpa.) quando não há nada para fazer commit.

O que você não pode fazer, e por quê

• Iniciar um repositório aqui: em um projeto que ainda não é um, o painel só diz Nenhuma alteração. Comece a rastrear em Projetos → Git ou no Painel Git do terminal.Ainda não
• Fazer fetch, criar ou trocar branches, amend, descartar as alterações de um arquivo, editar tags ou remotos: o editor não tem botão para isso. Projetos e o terminal cobrem a maior parte (veja abaixo).Ainda não
• Confiar que os contadores ↑↓ estejam atualizados: eles só mudam depois de um pull ou push, porque o editor não consegue fazer fetch.Ainda não

O que você pode fazer

• Cada bloco de alteração aparece como Fragmento na linha N com suas linhas removidas e adicionadas.
• Cada fragmento começa como Preparar; toque em Ignorar nos que quiser deixar de fora. N de M aceitos os conta.
• O botão de baixo diz Adicionar tudo ao índice quando todos os fragmentos estão escolhidos e Adicionar N nos outros casos. Ele adiciona só esses fragmentos ao próximo commit e deixa o arquivo no disco intacto.

O que você não pode fazer, e por quê

• Dividir um fragmento em linhas individuais.Ainda não
• Preparar por fragmentos um arquivo novo ou já preparado: o ícone aparece só em Alterações.Ainda não

O que você pode fazer

• Toque em Mensagem com IA para ter ideias. Escolha um estilo (Convencional, Descritivo, Imperativo ou Emoji), toque em uma sugestão e em Usar esta mensagem: ela preenche a caixa, e você ainda toca em Confirmar.
• Faça commit como você mesmo: os commits do editor levam o nome e o e-mail salvos no repositório, então defina antes O teu nome nos commits (Projetos → Git).

O que você não pode fazer, e por quê

• Fazer amend do último commit pelo editor: use Amend último commit em Projetos → Commit.Ainda não

O que você pode fazer

• Leia À frente e Atrás, Arquivos, os commits (a lista para em 50, mas À frente é a contagem real) e os caminhos alterados. Branches idênticos dizem Não há diferenças entre estes ramos.

O que você não pode fazer, e por quê

• Abrir o diff de um arquivo a partir da comparação, ou comparar branches remotos: só os branches locais são listados.Ainda não

O que você pode fazer

• Digite uma Mensagem (opcional) antes de confirmar: ela é salva com a entrada e aparece como o título dela na lista. Sem ela, o Git escreve o próprio título WIP on ….
• Leia o resultado em uma mensagem: Stash salvo: …, Stash aplicado e removido (Recuperar), Stash aplicado (mantido) (Aplicar) ou Stash removido (Descartar).

O que você não pode fazer, e por quê

• Guardar no stash arquivos novos (não rastreados): só as alterações em arquivos que o Git já rastreia são postas de lado.Ainda não
• Recuperar uma entrada específica: Recuperar sempre aplica e remove a mais nova, qualquer que seja a linha que você abriu.Ainda não
• Resolver conflitos quando um stash aplicado entra em conflito: não há resolvedor para isso.Ainda não

O que você pode fazer

• Com um arquivo aberto, toque em Blame: linhas consecutivas do mesmo commit são agrupadas, com o autor, Linha N (ou um intervalo) e o hash de 7 caracteres.
• Toque em um bloco e depois em Ver o commit para ler o diff desse commit no arquivo.
• Olhe a barra de status: ela pode mostrar autor · há quanto tempo para a linha em que o cursor está, ao lado do nome do branch. Toque em qualquer um para abrir o Controle de código-fonte. Linhas que você não commitou mostram Not Committed Yet.

O que você não pode fazer, e por quê

• Fazer blame de outro branch ou commit, ou ocultar o blame da barra de status: não há configuração para isso.Ainda não
• Ler esse tempo relativo no seu idioma: just now, 5 min ago, yesterday… estão sempre em inglês.Ainda não

O que você pode fazer

• Com um arquivo aberto, toque em Histórico do arquivo para ver os últimos 50 commits que tocaram nele (mensagem, hash, autor, idade) e em Ver diff para ver o que cada um mudou nesse arquivo.
• Um arquivo intocado diz Este ficheiro não tem histórico de commits.

O que você não pode fazer, e por quê

• Ver mais de 50 commits.De propósito
• Restaurar o arquivo para uma versão antiga, ou reverter pela linha: Revert fica em Projetos → Git → Histórico, e o Histórico local cobre o trabalho não salvo.Ainda não

O que você pode fazer

• Em um repositório, o explorador de arquivos marca cada arquivo alterado (modificado, adicionado, não rastreado, excluído ou renomeado), marca as pastas que contêm alterações e mostra um rodapé com o branch, ↑↓ e o número de arquivos alterados. Ele lê o mesmo status do Controle de código-fonte.
• O nome do branch na barra de status abre o Controle de código-fonte.
• Fora de um repositório Git não há marcas nem rodapé.

O que você não pode fazer, e por quê

—

O que você pode fazer

• Mova arquivos entre Staged (n) e Não adicionado (n) com a caixa de seleção de cada arquivo, ou use Adicionar tudo / Remover tudo.
• Digite uma Mensagem de commit e toque em Commit. Precisa de uma mensagem e de pelo menos um arquivo preparado, e não prepara nada por você: sem nenhum preparado, diz Sem arquivos staged. Use 'Adicionar tudo' para incluir as alterações.
• Marque Amend último commit (Modifica o commit anterior com as mudanças atuais): o botão vira Amend Commit.
• Toque em Commit & Push para fazer commit e enviar de uma vez (só quando o projeto tem um remoto).
• Descarte as alterações sem commit de um arquivo que o Git já rastreia com o ícone Descartar mudanças na linha dele. Ele não aparece para arquivos preparados ou novos.
• Autor: o nome e o e-mail salvos no repositório; quando não há, os da sua conta do PocketCode.

O que você não pode fazer, e por quê

—

O que você pode fazer

• Ramo: seus branches locais. Toque em um para mudar para ele, ou use Criar nova branch: a caixa Mudar para esta branch (marcada por padrão) leva você para ela na hora.
• O teu nome nos commits: defina o user.name e o user.email que o repositório guarda. Começam preenchidos a partir do repositório, do seu serviço conectado ou da sua conta.

O que você não pode fazer, e por quê

• Trocar de branch ou ver Histórico e Etiquetas em um repositório que ainda não tem remoto: essas linhas só aparecem quando existe um origin. O Painel Git do terminal pode trocar de branch localmente.Ainda não
• Excluir ou renomear um branch, ou listar branches remotos: aqui só existem branches locais.Ainda não

O que você pode fazer

• Criar tag: um nome como v1.0.0 e uma mensagem opcional. Com mensagem, a tag é anotada.
• Exclua uma tag pelo ícone dela.
• Push de tags as envia (só com um remoto).

O que você não pode fazer, e por quê

—

O que você pode fazer

• Estado: contagens e listas de arquivos Em stage, Modificado e Não rastreado, ou Árvore de trabalho limpa.
• Branches: toque em um branch para trocar para ele, ou em Nova ramificação.
• Histórico: os últimos 30 commits.
• Ações: Confirmar alterações (pede uma mensagem e fecha o painel), Pull, Push, Stash, Stash Pop, Fetch, Adicionar tudo e Reset (tira tudo do índice).
• Sem repositório, Não há repositório Git aqui oferece Inicializar repositório.

O que você não pode fazer, e por quê

• Usar a ação Diff no shell local: ela existe só por SSH.De propósito
• Stash com mensagem, descartar um único arquivo, merge, rebase, tag ou blame: não neste painel. Ele mesmo diz isso: Painel local sobre JGit; para um git completo use o Controle de código-fonte do editor.Ainda não
• Fazer push ou pull sem uma conta conectada: o painel mostra Git: … com o motivo e não abre um login.Precisa de rede

O que você pode fazer

• Resolver os arquivos um a um e ver a contagem baixar.
• Desistir com Abortar mesclagem: ela pergunta Abortar o merge? e Abortar confirma; a mensagem diz Merge abortado.

O que você não pode fazer, e por quê

—

O que você pode fazer

• Antes de qualquer mudança, o PocketCode salva a ponta atual do seu branch como refs/pocketcode/rebase-backup/<branch>.
• Um rebase nunca começa com alterações sem commit, a menos que você as coloque antes no stash.
• Abortar desfaz tudo (branch, índice e árvore de trabalho) e reaplica o seu próprio stash.
• O plano é salvo dentro de .git, então Continuar e Ignorar este commit continuam funcionando se o app foi fechado no meio.
• Restaurar a cópia move o branch de volta para a ponta salva, mas só com a árvore de trabalho limpa; os commits feitos depois do rebase ficam então apenas no reflog do Git.

O que você não pode fazer, e por quê

• Reordenar commits: o painel não permite.De propósito
• Usar a ação Edit: o Git criaria um novo commit em vez de fazer amend, então ela não é oferecida.De propósito
• Começar com Esmagar ou Fundir sem mensagem no primeiro commit que você mantém, ou descartar todos os commits: o painel recusa os dois.De propósito
• Fazer rebase sobre um branch remoto, ou fazer rebase de um branch que não seja o atual: só branches locais são oferecidos, e um HEAD desanexado é recusado.Ainda não
• Abri-lo pelo Controle de código-fonte, a partir de um projeto sem remoto, ou de um cujo origin não esteja no github.com.Ainda não

O que você pode fazer

• Filtre com Abertas, Minhas, Revisão pedida, Fechadas ou Todas. Minhas e Revisão pedida são filtradas no seu celular com base no seu login do GitHub.
• Leia a lista: estado (Aberta, Rascunho, Mesclada, Fechada), número, título, autor, idade, revisões pedidas e rótulos.
• Abra um: Resumo (descrição, head → base, arquivos alterados, +N / −M, commits, responsáveis, rótulos, Checks e Revisões com seu estado), Arquivos · N (caminhos com +/−) e Comentários · N.
• Veja por que não dá para mesclar: um banner diz Não é possível mesclar: … seguido dos motivos que se aplicam (conflitos de mesclagem, um check com falha, alterações solicitadas).
• Escreve um comentário… publica um comentário de conversa. Fechar PR fecha o pull request.
• Fundir oferece Commit de fusão, Combinar e fundir e Rebasear e fundir. O app envia o commit head que mostrou a você, então, se alguém fez push nesse meio-tempo, o GitHub recusa em vez de mesclar commits que você não viu.
• Novo pull request de … (precisa de um branch atual): título, descrição, Ramo base e Ramo de origem, Criar como rascunho e rótulos, depois Criar pull request.

O que você não pode fazer, e por quê

• Enviar uma revisão (aprovar ou pedir alterações), comentar em uma linha ou ler o diff do pull request: as revisões são mostradas, mas só para leitura, e Arquivos lista caminhos sem abri-los.Ainda não
• Escolher revisores ao criar um pull request.Ainda não
• Reabrir um pull request, editar o título ou a descrição, ativar o auto-merge ou atualizar o branch dele.Ainda não
• Usar merge requests do GitLab, pull requests do Bitbucket ou GitHub Enterprise: só repositórios do github.com são lidos.De propósito

O que você pode fazer

• Filtre com Abertas, Minhas issues (atribuídas a você), Fechadas ou Todas.
• Leia a lista (estado, número, contagem de comentários, autor, rótulos) e abra uma para ver o corpo, as datas, responsáveis, rótulos, marco, comentários e uma caixa de comentário.
• Fechar problema a fecha como concluída. Criar problema pede um título, uma descrição e rótulos.

O que você não pode fazer, e por quê

• Escolher um marco ou responsáveis ao criar uma issue, reabrir uma, editá-la, rotulá-la depois ou buscar.Ainda não

O que você pode fazer

• Abra um pull request e depois a aba CI: os checks do commit head dele (execuções do GitHub Actions, checks de outros apps e statuses clássicos) sob um único resumo, como Todos os checks passaram, Alguns checks falharam ou Checks em andamento.

O que você não pode fazer, e por quê

• Ver o CI sem abrir antes um pull request (a aba diz Seleciona um PR para ver o estado de CI), ler logs, ou executar de novo ou cancelar uma execução.Ainda não

O que você pode fazer

• Abra Avisos: suas notificações do GitHub nas quais você participa. Cada linha tem um ícone do tipo (revisão pedida, aprovado, alterações solicitadas, merge, comentário, atribuído, menção, CI passou ou falhou, release), o título e repo · motivo.
• Toque em uma não lida para marcá-la como lida, ou em Marcar tudo como lido. Quando não sobra nenhuma, diz Tudo em dia.

O que você não pode fazer, e por quê

• Abrir o pull request ou a issue por trás de uma notificação: tocar só a marca como lida.Ainda não
• Ver notificações com um token fine-grained: o GitHub só as mostra para um token clássico ou um login OAuth, e o painel avisa isso.Terceiros

O que você pode fazer

• Uma versão é salva depois de cada salvamento bem-sucedido, e só quando o texto difere da última versão salva. Funciona para arquivos do projeto e para arquivos que você abriu de fora do projeto.
• Guarda até 50 versões por arquivo e 50 MB no total, medidos comprimidos. Passando do total, as versões mais antigas de qualquer arquivo saem primeiro. Não há expiração por tempo.
• As versões ficam no armazenamento privado do PocketCode, nunca dentro do seu projeto, então nunca aparecem como alterações do Git. Renomear ou mover um arquivo leva o histórico junto.

O que você não pode fazer, e por quê

• Guardar versões de arquivos grandes: o editor abre arquivos a partir de 512 KiB, 10.000 linhas ou uma linha de 2.000 caracteres no modo leve, e esses não são salvos.De propósito
• Mudar os limites, ou fixar ou rotular uma versão.De propósito

O que você pode fazer

• Escolha a base: No disco (A versão salva deste arquivo), HEAD (O último commit do git), Área de transferência (O texto copiado) ou Outra aba aberta.
• Uma base que não está disponível diz o motivo: Não há repositório Git, A área de transferência está vazia ou Não há outras abas abertas.
• O diff abre com o título arquivo ↔ base; Trocar inverte os dois lados.

O que você não pode fazer, e por quê

• Editar a partir do diff ou vê-lo em duas colunas: é uma única lista unificada de linhas alteradas.De propósito