Învață Comenzi GitHub CLI (gh): comenzi explicate cu exemple

66 de comenzi 19 categorii Comunitate & Q&A

GitHub CLI (cunoscut ca comanda binară gh) este instrumentul oficial dezvoltat de GitHub pentru a aduce întreaga putere a platformei web direct în linia de comandă a dezvoltatorului. Lansat oficial în 2020, gh elimină comutarea continuă de context între editorul de cod, terminal și browserul web.

Cu GitHub CLI poți crea și revizui Pull Request-uri, poți inspecta diferențele de cod (diff), poți clona depozite prin scurtături simple, poți urmări în timp real execuția pipeline-urilor GitHub Actions cu streaming de jurnale și poți gestiona secrete criptate și versiuni software (Releases) printr-o singură linie de comandă.

Mai jos găsești cele 50 de comenzi esențiale GitHub CLI organizate pe categorii: autentificare securizată și configurări de sistem, fluxul complet de lucru cu Pull Requests, gestionarea tichetelor și a discuțiilor (Issues), administrarea depozitelor și a fork-urilor, monitorizarea și relansarea fluxurilor de lucru GitHub Actions și publicarea de versiuni cu gestionarea secretelor.

macOS • Windows • Linux

Ghid de instalare și autentificare GitHub CLI (gh)

Interacționează cu GitHub direct din terminal: deschide Pull Requests, creează Issues și gestionează repository-uri.

Cerințe de sistem: Un cont activ pe GitHub.com și Git instalat.

Terminal macOS (Homebrew / zsh)

# Instalare prin Homebrew:
brew install gh

# Autentificare în contul GitHub:
gh auth login
# Alege GitHub.com -> HTTPS -> autentificare prin browser

Windows 10 / 11 (PowerShell / Winget / WSL2)

# Instalare prin Windows Package Manager:
winget install GitHub.cli

# Autentificare în Command Prompt sau PowerShell:
gh auth login

Linux (Ubuntu / Debian / Bash)

# Ubuntu / Debian:
sudo apt update && sudo apt install -y gh

# RHEL / Fedora:
sudo dnf install -y gh

# Autentificare:
gh auth login

Verificare token și cont GitHub conectat

# Verifică starea sesiunii și permisiunile curente:
gh auth status

# Reîmprospătare token sau adăugare de noi scopuri (ex: workflow):
gh auth refresh -s workflow,repo

Autentificare și Git 1 comandă

gh auth setup-git – Configurarea Credențialelor Git Automate gh auth setup-git [--hostname <host>] Comanda gh auth setup-git configurează utilitarul local Git să folosească GitHub CLI ca asistent de credențiale (Credential Helper). Odată rulată, toate comenzile standard git push, git pull și git clone peste protocolul HTTPS vor funcționa fără a mai solicita introducerea manuală a parolelor sau a token-urilor Personal Access Tokens (PAT). # Configurează Git să folosească […]

Productivitate și Navigare 1 comandă

gh browse – Deschiderea Rapidă a Depozitului în Browser gh browse [<fișier>[:<linie>]] [--branch <branch>] [--settings] Comanda gh browse deschide instantaneu pagina web a depozitului curent în browserul implicit de sistem. Poate naviga direct către un fișier specific la o linie exactă de cod, pe un anumit branch sau direct în panoul de setări administrative. # Deschide pagina principală a depozitului curent în browser gh browse # Deschide fișierul specificat la […]

Performanță și CI/CD 1 comandă

gh cache list / delete – Administrarea Cache-ului GitHub Actions gh cache list [--limit <numar>] [--sort <criteriu>] gh cache delete <id | cheie> Subcomenzile gh cache list și gh cache delete administrează memoria tampon (Actions Cache) folosită de pașii de pipeline pentru biblioteci (npm, Maven, pip, Cargo). Permite eliberarea spațiului înainte de atingerea limitei maxime de 10 GB per depozit sau invalidarea cache-ului corupt. # Listează toate intrările de cache sortate după spațiul ocupat gh cache list --sort […]

Cloud și Medii 2 comenzi

Partajare și Gist 2 comenzi

Tichete și Organizare 1 comandă

gh label create – Gestiunea Etichetelor pentru Tichete și PR-uri gh label create <nume> [--color <hex>] [--description <descriere>] Comanda gh label create permite crearea și administrarea etichetelor (Labels) dintr-un depozit GitHub. Etichetele sunt esențiale pentru clasificarea cromatică a tichetelor și Pull Request-urilor după prioritate, tip (bug, feature) sau componentă afectată. # Creează o etichetă roșie pentru bug-uri critice gh label create "critic" --color "D93F0B" --description "Probleme urgente ce blochează producția" # Listează toate […]

Organizații și Echipă 1 comandă

gh org list – Listarea Organizațiilor și a Rolurilor de Membru gh org list [--limit <numar>] Comanda gh org list raportează toate organizațiile GitHub din care face parte contul utilizatorului autentificat curent, facilitând auditul rapid al accesului la resurse corporative și spații de lucru partajate. # Listează organizațiile asociate contului curent gh org list # Listează depozitele dintr-o organizație specifică gh repo list dexblog --limit 30 Utilitate: Esențial pentru dezvoltatorii care […]

Planificare și Proiecte 1 comandă

gh project list – Interogarea Proiectelor GitHub Projects v2 gh project list [--owner <utilizator|organizatie>] Comanda gh project list listează panourile de gestiune de proiecte GitHub Projects (generația modernă Projects v2). Permite vizualizarea planificărilor agile de tip Kanban, a sprinturilor și a stărilor elementelor de lucru fără a ieși din fluxul de lucru din consolă. # Listează toate proiectele asociate organizației curente gh project list --owner dexblog # Vizualizează elementele […]

Lansări și Versiuni 1 comandă

gh release delete – Ștergerea Versiunilor Publicate (Releases) gh release delete <tag> [--yes] [--cleanup-tag] Comanda gh release delete elimină o versiune de lansare (Release) publicată pe GitHub, împreună cu toate fișierele binare și pachetele arhivate asociate. Oferă opțiunea critică de a șterge automat și tag-ul Git corespunzător de pe depozit printr-o singură instrucțiune. # Șterge un release de test cerând confirmare interactivă gh release delete v1.0.0-rc1 # Ștergere automată […]

Căutare și Explorare 2 comenzi

Căutare și Tichete 1 comandă

gh search issues – Căutare Globală de Tichete și Pull Requests gh search issues <termen> [--state <open|closed>] [--label <nume>] [--assignee <user>] Comanda gh search issues permite căutarea de tichete (Issues) și Pull Requests pe GitHub, fie la nivel global, fie limitat la un depozit sau organizație. Este instrumentul perfect pentru a verifica dacă un bug pe care l-ați întâlnit a fost deja raportat sau discutat. # Caută tichete deschise legate de autentificare în depozitul curent gh […]

Securitate și CI/CD 1 comandă

gh secret delete – Ștergerea Secretelor Criptate din Depozit gh secret delete <NUME_SECRET> [--env <mediu>] [--org <organizatie>] Comanda gh secret delete elimină un secret criptat din configurația GitHub Actions a depozitului, a unui mediu izolat sau a întregii organizații. Este o măsură esențială de securitate la revocarea cheilor API compromise sau la dezafectarea serviciilor vechi. # Șterge un secret la nivel de depozit gh secret delete AWS_SECRET_ACCESS_KEY # Șterge un secret asociat […]

CI/CD și Configurare 1 comandă

gh variable set – Gestionarea Variabilelor pentru GitHub Actions gh variable set <NUME_VARIABILA> [--body <valoare>] [--env <mediu>] Comanda gh variable set creează sau actualizează variabile de configurare în text clar (non-secrete) utilizate în fluxurile GitHub Actions. Spre deosebire de secretele criptate (gh secret), variabilele de configurare pot fi inspectate vizual și sunt ideale pentru setări non-confidențiale (cum ar fi URL-uri de staging, porturi sau flag-uri de mediu). # Setează o variabilă la […]

Autentificare, Configurare și Utilitare globale 8 comenzi

Pull Requests (PR-uri) 9 comenzi

Issues și Discuții 8 comenzi

Repozitorii și Git Remote 9 comenzi

GitHub Actions și Workflow-uri 8 comenzi

Release-uri, Secrete și Extensii 8 comenzi

Toate comenzile GitHub CLI (gh)

Lista completă a celor 66 de comenzi fundamentale GitHub CLI (gh) explicate în această secțiune. Fiecare comandă dispune de o pagină dedicată, cu exemple practice de utilizare, opțiuni de filtrare JSON și automatizări pentru fluxurile de lucru din producție.

Autentificare, Configurare și Mediu (9)

Comandă gh	Descriere
`gh auth login`	Autentificarea interactivă sau prin token în contul GitHub sau Enterprise
`gh auth status`	Verificarea stării curente a sesiunii, a contului activ și a drepturilor OAuth
`gh auth refresh`	Extinderea permisiunilor (scopes) sau reîmprospătarea token-ului de acces
`gh auth logout`	Deconectarea contului și eliminarea token-ului de securitate stocat local
`gh auth setup-git`	Configurarea automată a gh ca asistent de credențiale (credential helper) pentru Git
`gh config set`	Configurarea setărilor globale (editor implicit, protocol git, pager)
`gh config get`	Interogarea valorii unei chei de configurare specifice din profilul local
`gh alias set`	Crearea de scurtături și alias-uri personalizate pentru comenzi frecvente
`gh version`	Afișarea versiunii curente a utilitarului CLI și a platformei pe care rulează

Gestionarea Depozitelor Git (Repo) (10)

Comandă gh	Descriere
`gh repo create`	Crearea unui nou depozit pe GitHub din directorul local sau din șablon
`gh repo clone`	Clonarea unui depozit folosind protocolul SSH sau HTTPS configurat
`gh repo view`	Vizualizarea detaliilor depozitului, a statisticilor și a fișierului README direct în consolă
`gh repo list`	Listarea depozitelor unui utilizator sau ale unei organizații cu opțiuni de filtrare
`gh repo fork`	Crearea unei copii fork în contul propriu și configurarea automată a remote-ului upstream
`gh repo sync`	Sincronizarea automată a branch-ului unui fork cu ramura originală upstream
`gh repo edit`	Modificarea descrierii, a paginii de prezentare, a vizibilității și a setărilor repo-ului
`gh repo archive`	Trecerea depozitului în modul de arhivă read-only
`gh repo delete`	Ștergerea definitivă a unui depozit după confirmarea numelui complet
`gh browse`	Deschiderea instantanee a depozitului sau a unui fișier la o linie precisă în browser

Flux de Lucru Pull Requests (PR) (9)

Comandă gh	Descriere
`gh pr create`	Deschiderea unui nou Pull Request specificând titlul, descrierea și reviewerii
`gh pr list`	Listarea și filtrarea PR-urilor deschise după etichetă, autor sau branch
`gh pr view`	Inspectarea descrierii, a comentariilor și a stării verificărilor CI/CD pentru un PR
`gh pr checkout`	Descărcarea ramurii unui PR și comutarea automată pe aceasta în arborele local de lucru
`gh pr diff`	Vizualizarea diferențelor de cod (Diff colorat) propuse într-un Pull Request
`gh pr review`	Aprobarea unui PR, trimiterea de comentarii sau solicitarea de modificări de cod
`gh pr merge`	Îmbinarea definitivă a unui PR prin Merge commit, Squash and Merge sau Rebase
`gh pr close / reopen`	Închiderea unui PR respins sau redeschiderea acestuia pentru reluarea lucrului
`gh pr comment`	Adăugarea de comentarii pe firul de discuție al unui Pull Request

Tichete, Discuții și Etichete (Issues & Labels) (9)

Comandă gh	Descriere
`gh issue create`	Raportarea unui Issue nou direct din terminal cu atribuire de etichete și persoane
`gh issue list`	Filtrarea și căutarea tichetelor active după etichete, autor sau milestone
`gh issue view`	Afișarea detaliată a conținutului și a istoricului de mesaje ale unui Issue
`gh issue edit`	Modificarea titlului, descrierii, etichetelor sau a persoanelor asignate
`gh issue close`	Închiderea unui tichet rezolvat specificând motivul (completed / not planned)
`gh issue reopen`	Redeschiderea unui tichet închis anterior pentru reevaluare
`gh issue comment`	Adăugarea de răspunsuri și note explicative pe un Issue existent
`gh issue develop`	Crearea automată a unei ramuri Git legate direct de un Issue deschis
`gh label create / clone`	Crearea, editarea și sincronizarea taxonomiei de etichete colorate

GitHub Actions: Fluxuri și Pipeline-uri (8)

Comandă gh	Descriere
`gh workflow list`	Listarea tuturor fișierelor de workflow definite în directorul .github/workflows/
`gh workflow run`	Declanșarea manuală a unui flux de lucru transmițând parametri de intrare
`gh workflow view`	Vizualizarea codului sursă YAML și a detaliilor de execuție ale unui workflow
`gh workflow enable / disable`	Activarea sau pauzarea temporară a unui flux automat Actions
`gh run list`	Afișarea istoricului rulărilor recente de pipeline cu starea lor (Success / Failure)
`gh run view`	Inspectarea pașilor eșuați și descărcarea jurnalelor de execuție dintr-un job
`gh run watch`	Monitorizarea în direct a progresului pipeline-ului cu reîmprospătare continuă
`gh run rerun`	Re-rularea întregului pipeline sau reluarea exclusivă a pașilor care au eșuat

Secrete, Variabile, Medii și Cache (5)

Comandă gh	Descriere
`gh secret set`	Adăugarea sau actualizarea secretelor criptate pentru GitHub Actions
`gh secret list`	Listarea numelor de secrete configurate la nivel de depozit sau mediu
`gh secret delete`	Ștergerea definitivă a cheilor secrete compromise sau neutilizate
`gh variable set / list`	Gestionarea variabilelor de configurare în text clar pentru fluxuri CI/CD
`gh cache list / delete`	Inspectarea și curățarea memoriei cache a dependențelor din GitHub Actions

Lansări, Versiuni și Gists (7)

Comandă gh	Descriere
`gh release create`	Publicarea unei versiuni noi cu tag Git, note automate și arhive binare atașate
`gh release list`	Listarea tuturor versiunilor publicate (Releases) și a stării de prerelease
`gh release view`	Inspectarea notelor de lansare (Changelog) și a activelor descărcabile
`gh release download`	Descărcarea pachetelor binare compilate atașate unei anumite versiuni
`gh release delete`	Ștergerea unei versiuni de lansare și a tag-ului Git de pe server
`gh gist create`	Publicarea rapidă a fișierelor locale sau a fluxurilor din terminal ca fragmente Gist
`gh gist list / view`	Administrarea, clonarea și ștergerea fragmentelor Gist din contul propriu

Căutare Globală, Codespaces, API și Extensii (9)

Comandă gh	Descriere
`gh search repos`	Căutarea avansată de depozite pe GitHub după limbaj, stele și activitate
`gh search issues`	Căutarea globală a tichetelor și discuțiilor pe întreaga platformă
`gh search code`	Căutarea fragmentelor de cod, funcțiilor și definițiilor în fișiere sursă
`gh codespace create`	Instanțierea mediilor complete de dezvoltare în cloud prin GitHub Codespaces
`gh codespace code / ssh`	Conectarea la containerul Codespace prin VS Code sau tunel securizat SSH
`gh project list`	Interogarea și gestiunea planificărilor din GitHub Projects v2 (tabele Kanban)
`gh org list`	Listarea organizațiilor corporative din care face parte utilizatorul curent
`gh extension install`	Instalarea plugin-urilor comunitare care extind funcționalitatea GitHub CLI
`gh api`	Efectuarea de cereri REST și GraphQL directe autentificate către GitHub API

Comunitate & Schimb de cunoștințe

Discuții, Întrebări & Coduri Comenzi GitHub CLI (gh)

Ai o întrebare legată de Comenzi GitHub CLI (gh), cauți o soluție sau vrei să împărtășești un fragment util de cod? Trimite mai jos contribuția ta.

💬

Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!

Nu au fost adăugate încă întrebări sau exemple de cod pentru această pagină. Dacă ai întâlnit o problemă sau ai un snippet util, adaugă-l mai jos pentru a-i ajuta pe ceilalți.

Comunitate Adaugă o întrebare sau distribuie un cod Anulează răspunsul

Alege ce dorești să transmiți:

Titlu scurt (opțional)

Întrebarea ta *

Moderare & Siguranță:

Pentru a menține calitatea și securitatea informațiilor, fiecare întrebare sau fragment de cod/prompt este analizat (manual sau prin moderare asistată de AI) înainte de publicare.

Nume sau Pseudonim *

Adresă de Email * (nu va fi publicată)