Skip to main content
Skip to content

Usando GitHub Classroom com GitHub CLI

Você pode usar gh, a interface de linha de comando GitHub, para trabalhar com GitHub Classroom diretamente pela linha de comando.

Aviso

          **Descontinuação:** Esta `gh` extensão será descontinuada. O GitHub Classroom aplicativo será desativado em 28 de agosto de 2026.

Para obter mais informações, consulte o GitHub Classroom aviso de fechamento.

Sobre GitHub Classroom CLI

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. Quando você está trabalhando na linha de comando, você pode usar GitHub CLI para economizar tempo e evitar mudar o contexto. Para obter mais informações, consulte Sobre GitHub CLI.

Você pode trabalhar com GitHub Classroom em GitHub CLI para:

Configurando GitHub CLI

Para obter instruções de instalação para GitHub CLI, veja o repositório GitHub CLI.

Usando a extensão GitHub Classroom com GitHub CLI

Se você ainda não fez isso, execute gh auth login para autenticar com sua GitHub conta.

Para instalar a GitHub Classroom extensão, execute gh extension install github/gh-classroom.

Para usar gh para trabalhar com GitHub Classroom, digite gh classroom SUBCOMMAND.

Como exemplo de uma série de comandos que você pode usar para trabalhar com GitHub Classroom, você pode:

  • Liste suas salas de aula:
    gh classroom list
  • Liste as tarefas de uma sala de aula específica:
    gh classroom assignments
  • Veja as informações de uma tarefa específica:
    gh classroom assignment

gh subcomandos para GitHub Classroom

Estas seções fornecem exemplos de subcomandos para cada uma das operações disponíveis. Quando aplicável, a CLI solicitará que você escolha uma sala de aula depois de executar o subcomando.

Na linha de comando, use gh classroom --help para obter ajuda geral ou gh classroom SUBCOMMAND --help para obter ajuda com um subcomando específico.

Listar salas de aula

gh classroom list

Lista de salas de aula que pertencem a você.

Exibir informações da sala de aula

gh classroom view

Exiba o ID da sala de aula, o slug da sala de aula, o título e outras informações sobre a sala de aula.

Listar tarefas

gh classroom assignments

Veja uma lista de tarefas para uma sala de aula.

Listar as tarefas aceitas

gh classroom accepted-assignments

Veja uma lista de tarefas aceitas e informações sobre as tarefas do estudante.

Exibir informações das tarefas

gh classroom assignment

Exibe as informações da tarefa.

Clonar o repositório de código inicial de uma tarefa

gh classroom clone starter-repo

Clona o repositório de código inicial usado por uma tarefa. Por padrão, o código inicial é clonado no diretório atual. Para fazer a clonagem em outro diretório, use o sinalizador --directory. Se o diretório não existir, ele será criado.

Clonar o repositório de tarefas de um estudante

gh classroom clone student-repos

Clona os repositórios do estudante de determinada tarefa. Por padrão, os repositórios dos alunos são clonados no diretório atual, em um diretório com o nome do slug da tarefa. Para fazer a clonagem em outro diretório, use o sinalizador --directory. Se o diretório não existir, ele será criado.

Por padrão, todos os repositórios de estudantes são clonados. Para obter um número diferente de repositórios, use os sinalizadores --page NUMBER e --per-page NUMBER.