Skip to content

Latest commit

 

History

History
95 lines (61 loc) · 7.11 KB

gh-cli.md

File metadata and controls

95 lines (61 loc) · 7.11 KB

Explicación de la Estructura de Comandos en GitHub CLI

La línea de comandos que proporcionaste, gh <command> <subcommand> [flags], es una estructura generalizada para usar GitHub CLI (gh) y se utiliza para ejecutar comandos y subcomandos en GitHub CLI. Aquí hay una explicación de cada parte:

  • gh: Esto es el nombre del comando principal, que es "gh" en este caso. Es el punto de entrada para acceder a todas las funcionalidades de GitHub CLI.

  • <command>: Esto representa el comando que deseas ejecutar. Los comandos en GitHub CLI son acciones específicas que puedes realizar, como repo para trabajar con repositorios, pr para solicitudes de extracción, issue para problemas (issues), entre otros. Debes reemplazar <command> con el nombre del comando que deseas utilizar.

  • <subcommand>: Algunos comandos principales tienen subcomandos que se utilizan para realizar acciones específicas dentro del comando principal. Por ejemplo, si estás trabajando con el comando repo, puedes tener subcomandos como create, clone, list, etc. Debes reemplazar <subcommand> con el nombre del subcomando que deseas utilizar.

  • [flags]: Los flags son opciones que puedes incluir después de los comandos y subcomandos para personalizar su comportamiento. Los flags suelen comenzar con un guion (-) o dos guiones (--) y se utilizan para configurar opciones adicionales. Por ejemplo, puedes usar --help para obtener información sobre cómo usar un comando específico, o flags como --org para especificar una organización en la que deseas realizar una acción.

Para usar GitHub CLI, debes reemplazar <command>, <subcommand>, y [flags] con los valores y opciones específicos que necesites para ejecutar un comando en particular. Por ejemplo:

  • Para listar tus repositorios, puedes usar: gh repo list.
  • Para crear un nuevo repositorio, puedes usar: gh repo create.
  • Para obtener ayuda sobre cómo usar un comando en particular, puedes usar: gh <command> --help o gh <command> <subcommand> --help.

Recuerda que GitHub CLI es una herramienta poderosa para interactuar con GitHub desde la línea de comandos, y cada comando y subcomando tiene su propio conjunto de opciones y funcionalidades. Puedes consultar la documentación de GitHub CLI o ejecutar gh --help para obtener información general y explorar todas las capacidades disponibles.

Ejemplos de Comandos, Subcomandos y Flags en GitHub CLI

A continuación, se presenta una lista de 20 ejemplos de comandos, subcomandos y flags importantes que puedes utilizar en GitHub CLI (gh):

Comandos Principales:

  1. gh repo: Comando principal para trabajar con repositorios en GitHub.
  2. gh pr: Comando principal para trabajar con solicitudes de extracción (pull requests).
  3. gh issue: Comando principal para trabajar con problemas (issues) en GitHub.
  4. gh gist: Comando principal para trabajar con gists de GitHub.
  5. gh workflow: Comando principal para trabajar con flujos de trabajo de GitHub Actions.
  6. gh repo clone: Subcomando para clonar un repositorio en tu sistema local.
  7. gh repo create: Subcomando para crear un nuevo repositorio en GitHub.
  8. gh pr create: Subcomando para crear una nueva solicitud de extracción.
  9. gh pr list: Subcomando para listar solicitudes de extracción.
  10. gh issue create: Subcomando para crear un nuevo problema en un repositorio.
  11. gh gist create: Subcomando para crear un nuevo gist en GitHub.
  12. gh workflow list: Subcomando para listar flujos de trabajo de GitHub Actions.

Flags (Opciones) Útiles:

  1. --help o -h: Flag para obtener ayuda y documentación sobre cómo usar un comando o subcomando.
  2. --web: Flag para abrir la URL correspondiente en el navegador web (por ejemplo, --web con gh repo view abrirá el repositorio en el navegador).
  3. --json: Flag para mostrar la salida en formato JSON.
  4. --org <nombre>: Flag para especificar una organización en la que deseas realizar una acción.
  5. --branch <nombre>: Flag para especificar una rama en un repositorio.
  6. --title <título>: Flag para especificar un título al crear una solicitud de extracción o un problema.
  7. --assignee <nombre>: Flag para asignar una solicitud de extracción o un problema a un usuario.
  8. --label <etiqueta>: Flag para agregar etiquetas a una solicitud de extracción o un problema.

Estos son solo ejemplos de comandos, subcomandos y flags disponibles en GitHub CLI. La herramienta es muy versátil y te permite interactuar con casi todas las funciones de GitHub desde la línea de comandos, por lo que hay muchas más opciones disponibles según tus necesidades específicas. Puedes explorar la documentación de GitHub CLI o ejecutar gh --help o gh <command> --help para obtener más detalles y ejemplos de uso.

Ejemplos de Comandos, Subcomandos y Flags en GitHub CLI

A continuación, se presenta una lista de 20 ejemplos de comandos, subcomandos y flags importantes que puedes usar en GitHub CLI (gh):

Comandos Principales:

  1. gh repo: Comando principal para trabajar con repositorios en GitHub.
  2. gh pr: Comando principal para trabajar con solicitudes de extracción (pull requests).
  3. gh issue: Comando principal para trabajar con problemas (issues) en GitHub.
  4. gh gist: Comando principal para trabajar con gists de GitHub.
  5. gh workflow: Comando principal para trabajar con flujos de trabajo de GitHub Actions.
  6. gh repo clone: Subcomando para clonar un repositorio en tu sistema local.
  7. gh repo create: Subcomando para crear un nuevo repositorio en GitHub.
  8. gh pr create: Subcomando para crear una nueva solicitud de extracción.
  9. gh pr list: Subcomando para listar solicitudes de extracción.
  10. gh issue create: Subcomando para crear un nuevo problema en un repositorio.
  11. gh gist create: Subcomando para crear un nuevo gist en GitHub.
  12. gh workflow list: Subcomando para listar flujos de trabajo de GitHub Actions.

Flags (Opciones) Útiles:

  1. --help o -h: Flag para obtener ayuda y documentación sobre cómo usar un comando o subcomando.
  2. --web: Flag para abrir la URL correspondiente en el navegador web (por ejemplo, --web con gh repo view abrirá el repositorio en el navegador).
  3. --json: Flag para mostrar la salida en formato JSON.
  4. --org <nombre>: Flag para especificar una organización en la que deseas realizar una acción.
  5. --branch <nombre>: Flag para especificar una rama en un repositorio.
  6. --title <título>: Flag para especificar un título al crear una solicitud de extracción o un problema.
  7. --assignee <nombre>: Flag para asignar una solicitud de extracción o un problema a un usuario.
  8. --label <etiqueta>: Flag para agregar etiquetas a una solicitud de extracción o un problema.

Estos son solo ejemplos de comandos, subcomandos y flags disponibles en GitHub CLI. La herramienta es muy versátil y te permite interactuar con casi todas las funciones de GitHub desde la línea de comandos, por lo que hay muchas más opciones disponibles según tus necesidades específicas. Puedes explorar la documentación de GitHub CLI o ejecutar gh --help o gh <command> --help para obtener más detalles y ejemplos de uso.