Paleta de comando do GitHub
Use a paleta de comandos para navegar, pesquisar e executar comandos diretamente do teclado.
Neste artigo
Observação
A GitHub Command Palette está em versão prévia pública e está sujeita a alterações.
O GitHub Command Palette está desativado por padrão. Você pode habilitar o GitHub Command Palette com a visualização do recurso. ConfiraExplorar versões de acesso antecipado com visualização de recursos.
Sobre a GitHub Command Palette
Você pode navegar, pesquisar e executar comandos no GitHub com a GitHub Command Palette. A paleta de comandos é uma forma personalizada de mostrar sugestões com base no seu contexto atual e nos recursos que você usou recentemente. Você pode abrir a paleta de comandos com um atalho de teclado de qualquer lugar no GitHub; isso economiza tempo e você mantém as mãos no teclado.
Navegação rápida
Ao abrir a paleta de comandos, as sugestões são otimizadas para facilitar o acesso de qualquer lugar em um repositório, uma conta pessoal, ou uma organização para páginas de nível superior, como a página Problemas. Se o local que você deseja não estiver listado, comece a digitar o nome ou número para a localização refinar as sugestões.
Acesso fácil aos comandos
A capacidade de executar comandos diretamente do seu teclado, sem navegar por meio de uma série de menus pode alterar a forma como você usa GitHub. Por exemplo, você pode alternar temas com algumas teclas pressionadas, facilitando a alternância entre temas à medida que as suas necessidades forem mudando.
Como abrir a GitHub Command Palette
Abra a paleta de comandos usando um dos seguintes atalhos padrão do teclado:
- Windows e Linux:CTRL+K ouCTRL+Alt+K
- Mac:Comando+K ouComando+Opção+K
Você pode personalizar os atalhos de teclado usados para abrir a paleta de comandos naseção Acessibilidade das configurações do usuário. Para obter mais informações, confiraComo personalizar seus atalhos de teclado da GitHub Command Palette.
Quando você abrir a paleta de comandos, ela mostra sua localização no canto superior esquerdo e a usa como o escopo de sugestões (por exemplo, a organizaçãoocto-org).
Observação
- Se você estiver editando um texto Markdown, abra a paleta de comandos comCTRL+Alt+K (Windows e Linux) ouComando+Opção+K (Mac).
- Se você estiver trabalhando em um projeto, uma paleta de comandos específica do projeto será exibida. Para saber mais, confiraAlterando o layout de uma exibição.
Personalizando seus atalhos de teclado de GitHub Command Palette
Os atalhos de teclado padrão usados para abrir a paleta de comandos podem entrar em conflito com os atalhos de teclado padrão do sistema operacional e do navegador. Você tem a opção de personalizar os atalhos de teclado naseção Acessibilidade das configurações da conta. Nas configurações da paleta de comandos, você pode personalizar os atalhos de teclado para abrir a paleta de comandos em modo de pesquisa e modo de comando.
Navegando com GitHub Command Palette
Você pode usar a paleta de comandos para navegar para qualquer página a que você tenha acesso no GitHub.
UseCTRL+K (Windows/Linux) ouCommand+K (Mac) para abrir a paleta de comandos com um escopo determinado pelo local atual na interface do usuário.
Comece a digitar o caminho para o qual você deseja navegar. As sugestões na paleta de comandos são alteradas para corresponder ao seu texto.
Opcionalmente, restrinja, expanda ou altere completamente o escopo das sugestões editando o caminho no campo de texto da paleta de comandos.
- Para restringir o escopo dentro de uma conta de usuário ou organização, realce um repositório e useTab para adicioná-lo ao escopo.
- Para expandir o escopo, realce e remova um item no escopo usando a teclaBackspace oudelete.
- Para limpar o escopo e a caixa de texto, clique emLimpar ou useCtrl+Backspace (Windows e Linux) ouCommand+Delete (Mac).
Você também pode usar teclas pressionadas para restringir a sua pesquisa. Para obter mais informações, confiraFunções de pressionamento de tecla.
Termine de inserir no caminho ou use as teclas de seta para destacar o caminho que você deseja a partir da lista de sugestões.
UseENTER para ir para o local escolhido. Como alternativa, useCTRL+ENTER (Windows e Linux) ouComando+ENTER (Mac) para abrir o local em uma nova guia do navegador.
Pesquisando com GitHub Command Palette
Você pode usar a paleta de comandos para pesquisar qualquer coisa em GitHub.
UseCTRL+K (Windows/Linux) ouCommand+K (Mac) para abrir a paleta de comandos com um escopo determinado pelo local atual na interface do usuário.
Opcionalmente, restrinja, expanda ou altere completamente o escopo das sugestões editando o caminho no campo de texto da paleta de comandos.
- Para restringir o escopo dentro de uma conta de usuário ou organização, realce um repositório e useTab para adicioná-lo ao escopo.
- Para expandir o escopo, realce e remova um item no escopo usando a teclaBackspace oudelete.
- Para limpar o escopo e a caixa de texto, clique emLimpar ou useCtrl+Backspace (Windows e Linux) ouCommand+Delete (Mac).
Opcionalmente, use teclas pressionadas para encontrar tipos específicos de recursos:
- # Pesquisar problemas, solicitações de pull, discussões e projetos
- ! Pesquisar projetos
- @ Pesquisar usuários, organizações e repositórios
- / Pesquisar arquivos no escopo de um repositório
Comece a inserir seus termos de pesquisa. A paleta de comandos irá oferecer um intervalo de pesquisas sugeridas com base no seu escopo de pesquisa.
Dica
Você também pode usar a sintaxe completa da pesquisa integrada de GitHub dentro da paleta de comando. Para saber mais, confiraPesquisa na documentação do GitHub.
Use as teclas de direção para realçar o resultado da pesquisa desejado eENTER para ir ao local escolhido. Como alternativa, useCTRL+ENTER (Windows e Linux) ouComando+ENTER (Mac) para abrir o local em uma nova guia do navegador.
Executando comandos a partir de GitHub Command Palette
Você pode usar o GitHub Command Palette para executar comandos. Por exemplo, você pode criar um novo repositório ou problema ou alterar seu tema. Quando você executa um comando, o local para sua ação é determinado pela página subjacente ou pelo escopo mostrado na paleta de comandos.
- Os comandos de pull request e problemas sempre são executados na página subjacente.
- Os comandos de alto nível, por exemplo, comandos de repositório, são executados no escopo exibido na paleta de comandos.
Para ver uma lista completa de comandos compatíveis, confiraReferência da GitHub Command Palette.
Os atalhos de teclado padrão usados para abrir a paleta de comandos no modo de comando sãoCTRL+SHIFT+K (Windows e Linux) ouComando+SHIFT+K (Mac). Se você já tiver a paleta de comandos aberta, pressione> para alternar para o modo de comando. GitHub sugere comandos baseados na sua localização.
Opcionalmente, restrinja, expanda ou altere completamente o escopo das sugestões editando o caminho no campo de texto da paleta de comandos.
- Para restringir o escopo dentro de uma conta de usuário ou organização, realce um repositório e useTab para adicioná-lo ao escopo.
- Para expandir o escopo, realce e remova um item no escopo usando a teclaBackspace oudelete.
- Para limpar o escopo e a caixa de texto, clique emLimpar ou useCtrl+Backspace (Windows e Linux) ouCommand+Delete (Mac).
Se o comando que você deseja não for exibido, verifique seu escopo e, em seguida, comece a digitar o nome do comando na caixa de texto.
Use as teclas de direção para realçar o comando desejado eENTER para executá-lo.
Fechando a paleta de comandos
Quando a paleta de comando está ativa, você pode usar um dos seguintes atalhos de teclado para fechar a paleta de comandos:
- Modo de pesquisa e navegação:Esc ouCTRL+K (Windows e Linux)Comando+K (Mac)
- Modo de comando:Esc ouCTRL+SHIFT+K (Windows e Linux)Comando+SHIFT+K (Mac)
Se você tiver personalizado os atalhos da paleta de comandos nas configurações de acessibilidade, seus atalhos de teclado personalizados serão usados tanto para abrir quanto para fechar a paleta de comandos.
Referência de GitHub Command Palette
Funções de keystrokes
Essas keystrokes estão disponíveis quando a paleta de comandos está nos modos de navegação e pesquisa, isto é, elas não estão disponíveis no modo de comando.
| Teclas | Função |
|---|---|
| > | Entre no modo de comando. Para obter mais informações, confiraComo executar comandos na GitHub Command Palette. |
| # | Pesquisa problemas, pull requests, discussões e projetos. Para obter mais informações, confiraComo fazer pesquisas com a GitHub Command Palette. |
| @ | Pesquisa usuários, organizações e repositórios. Para obter mais informações, confiraComo fazer pesquisas com a GitHub Command Palette. |
| / | Pesquisar arquivos dentro de um escopo ou repositórios do repositório dentro do escopo da organização. Para obter mais informações, confiraComo fazer pesquisas com a GitHub Command Palette. |
| ! | Pesquisar apenas projetos. Para obter mais informações, confiraComo fazer pesquisas com a GitHub Command Palette. |
| CTRL+C ouComando+C | Copiar URL de pesquisa ou navegação para o resultado destacado na área de transferência. |
| Enter | Pule para o resultado destacado ou execute o comando destacado. |
| CTRL+ENTER ouComando+ENTER | Abra o resultado da pesquisa ou navegação destacada em uma nova aba do navegador. |
| ? | Exibir ajuda na paleta de comandos. |
Comandos globais
Estes comandos estão disponíveis em todos os escopos.
| Comando | Comportamento |
|---|---|
Import repository | Criar um novo repositório importando um projeto de outro sistema de controle de versão. Para saber mais, confiraImportar um repositório usando o Importador do GitHub. |
New gist | Abra um novo gist. Para saber mais, confiraCriar gists. |
New organization | Criar uma nova organização Para saber mais, confiraCriar uma organização do início. |
New project | Criar um novo projeto. Para saber mais, confiraCriar um projeto. |
New repository | Criar um novo repositório a partir do zero. Para saber mais, confiraCriar um repositório. |
Switch theme to <theme name> | Mude diretamente para um tema diferente para a interface do usuário. Para saber mais, confiraGerenciar as configurações de temas. |
Comandos da organização
Esses comandos estão disponíveis somente dentro do escopo de uma organização.
| Comando | Comportamento |
|---|---|
New team | Crie uma nova equipe na organização atual. Para saber mais, confiraComo criar uma equipe da organização. |
Comandos do repositório
A maioria desses comandos está disponível apenas na página inicial do repositório. Se um comando também estiver disponível em outras páginas, isso será mencionado na coluna de comportamento.
| Comando | Comportamento |
|---|---|
Clone repository: <URL type> | Copie a URL necessária para clonar o repositório usando GitHub CLI, HTTP ou SSH para a área de transferência. Para saber mais, confiraClonar um repositório. |
New discussion | Criar uma nova discussão no repositório. Para saber mais, confiraInício Rápido para Discussões do GitHub. |
New file | Criar um novo arquivo a partir de qualquer página no repositório. Para saber mais, confiraAdicionar um arquivo a um repositório. |
New issue | Abra um novo problema de qualquer página no repositório. Para saber mais, confiraCriar um problema. |
Open in github.dev editor | Abra o repositório atual no editor do github.dev. Para saber mais, confiraO editor github.dev baseado na web. |
Comandos de arquivos
Estes comandos só estão disponíveis quando você abre a paleta de comandos a partir de um arquivo em um repositório.
| Comando | Comportamento |
|---|---|
Copy permalink | Crie um link para o arquivo que inclui o atual commit SHA e copie o link para a área de transferência. Para saber mais, confiraObter links permanentes em arquivos. |
Open in github.dev editor | Abra o arquivo exibido no momento no editor do github.dev. Para saber mais, confiraO editor github.dev baseado na web. |
Comandos de discussão
Estes comandos só estão disponíveis quando você abre a paleta de comandos em uma discussão. Eles atuam na sua página atual e não são afetados pelo escopo definido na paleta de comando.
| Comando | Comportamento |
|---|---|
Delete discussion... | Excluir permanentemente a discussão. Para saber mais, confiraGerenciando discussões. |
Edit discussion body | Abra o texto principal da discussão que está pronto para edição. |
Subscribe/unsubscribe | Opte por participar ou não receber notificações de adições à discussão. Para saber mais, confiraSobre notificações. |
Transfer discussion... | Mover a discussão para um repositório diferente. Para saber mais, confiraGerenciando discussões. |
Comandos de problemas
Estes comandos estão disponíveis somente quando você abre a paleta de comandos em um problema. Eles atuam na sua página atual e não são afetados pelo escopo definido na paleta de comando.
| Comando | Comportamento |
|---|---|
Close/reopen issue | Fechar ou reabrir o problema atual. Para saber mais, confiraSobre issues. |
Convert issue to discussion... | Converter o problema atual em uma discussão. Para saber mais, confiraModerar discussões. |
Delete issue... | Exclua o problema atual. Para saber mais, confiraExcluir um problema. |
Edit issue body | Abra o texto principal do problema que está pronto para edição. |
Edit issue title | Abra o título do problema que está pronto para edição. |
Lock issue | Limitar novos comentários a usuários com acesso de gravação ao repositório. Para saber mais, confiraBloquear conversas. |
Pin/unpin issue | Altere se o problema é exibido ou não na seção de problemas fixados para o repositório. Para saber mais, confiraFixar um problema no repositório. |
Subscribe/unsubscribe | Opte por partiricpar ou não receber notificações de alterações nesse problema. Para saber mais, confiraSobre notificações. |
Transfer issue... | Transferir o problema para outro repositório. Para saber mais, confiraTransferir um problema para outro repositório. |
Comandos de pull request
Estes comandos só estão disponíveis quando você abre a paleta de comandos a partir de um pull request. Eles atuam na sua página atual e não são afetados pelo escopo definido na paleta de comando.
| Comando | Comportamento |
|---|---|
Close/reopen pull request | Feche ou reabra o pull request atual. Para saber mais, confiraSobre solicitação de pull. |
Convert to draft/Mark pull request as ready for review | Altere o estado do pull request para mostrá-lo como pronto ou não pronto para revisão. Para saber mais, confiraAlterar o stage de uma pull request. |
Copy current branch name | Adicione o nome do branch principal ao pull request na área de transferência. |
Edit pull request body | Abra o texto principal do pull request que está pronto para edição. |
Edit pull request title | Abra o título do pull request que está pronto para edição. |
Subscribe/unsubscribe | Opte por receber ou não receber notificações para alterações desse pull request. Para saber mais, confiraSobre notificações. |
Update current branch | Atualize o branch principal do pull request com alterações do branch base. Isso só está disponível para pull requests que apontam para o branch padrão do repositório. Para saber mais, confiraSobre branches. |