GitTree manuale per desktop

Utilizza GitTree per il tuo lavoro quotidiano

GitTree è un client Git desktop per macOS, Windows e Linux. Accedi e tutte le attività Git locali saranno incluse nel piano gratuito: apertura, clonazione, commit, diramazione, unione, rebase, archiviazione e annullamento. GitTree Pro aggiunge integrazioni di hosting, esecuzioni CI/CD, redazione AI e Nour, l'assistente AI.

Installa GitTree su macOS

GitTree per Mac è un'app universale per Apple Silicon e Intel Macs su macOS 13 o versioni successive, firmata e autenticata da Apple. Installa prima Git, apri il file .dmg, trascina GitTree su Applicazioni e avvialo.

Installa GitTree su Windows

GitTree per Windows è un programma di installazione a 64 bit per Windows 10 (22H2) e Windows 11. Installa prima Git for Windows, scegli Microsoft Store o l'EXE diretto e avvia GitTree dal menu Start.

Installa GitTree su Linux

GitTree per Linux è disponibile come .deb per Ubuntu 22.04 o successivo e Debian 12 o successivo, e come AppImage portatile, entrambi per x86_64 a 64 bit. Installa prima Git 2.39 o una versione successiva, quindi installa .deb con apt o esegui AppImage.

Trova Git e imposta la tua identità di commit

GitTree esegue Git installato sul tuo computer e non ne raggruppa mai uno. Ha bisogno di Git 2.39 o più recente e di un nome e un indirizzo email per i tuoi commit (user.name e user.email), che richiede per la prima volta che un commit ne ha bisogno.

Orientarsi in GitTree

Una scheda del repository è composta da sei parti: la barra delle schede, la barra degli strumenti, la barra laterale, il grafico dei commit, l'ispettore e la barra di stato. Questa pagina mostra dove si trova ciascuno e cosa fai lì.

Crea il tuo primo impegno

Un commit salva un'istantanea delle modifiche apportate, con un messaggio che ne spiega il motivo. In GitTree metti in stage un file nel pannello delle modifiche, digita un riepilogo e premi Commit: il nuovo commit appare nella parte superiore del grafico.

Utilizza Git locale gratuitamente e comprendi Pro

Ogni funzionalità Git locale in GitTree è gratuita per tutti coloro che accedono con un account GitTree. GitTree Pro aggiunge Nour, le integrazioni di hosting e la redazione AI; puoi provarli con una prova gratuita che inizia solo quando lo richiedi.

Apri un repository esistente

Scegli la cartella di un repository Git già presente sul tuo computer e GitTree lo apre nella sua scheda, con il suo grafico di commit, i rami e le modifiche. Non viene caricato nulla: il repository rimane sul tuo computer.

Clonare un repository

La clonazione copia un repository da GitHub, GitLab, Bitbucket, Azure DevOps o qualsiasi server Git sul tuo computer, con la relativa cronologia. In GitTree incolli l'URL, scegli dove metterlo e premi Clone; al termine si apre in una nuova scheda.

Crea un archivio

L'inizializzazione trasforma una cartella in un repository Git, lo stesso di git init. In GitTree scegli la cartella e il ramo iniziale, opzionalmente aggiungi un .gitignore e una licenza e premi Initialize.

Utilizza repository recenti e preferiti

La nuova scheda elenca i repository che hai aperto in Recent e quelli che hai contrassegnato come Speciali in Favourites. Selezionane uno per aprirlo in una scheda. Gli elenchi rimangono su questo computer.

Trova repository su disco

Scan for Repositories… esamina una cartella scelta ed elenca tutti i repository Git fino a un massimo di tre cartelle. Niente viene aperto finché non lo scegli; puoi aprirne uno o aggiungerli a un'area di lavoro.

Esaminare l'attendibilità del repository

Alcuni repository contengono impostazioni Git o hook che eseguono programmi sul tuo computer quando Git funziona al loro interno. Prima che ciò possa accadere, GitTree mostra Trust this repository? con esattamente ciò che ha trovato e ti consente di fidarti di esso o di aprirlo in Restricted mode.

Apri un repository semplice

Un repository semplice ha una cronologia ma non file funzionanti, come quelli che i server conservano affinché altri possano inviarli (git init --bare, git clone --bare). GitTree lo apre per mostrare il grafico, i rami e i tag, contrassegna la sua scheda bare e disattiva le azioni che richiedono file funzionanti.

Gestisci le schede del repository

Ogni repository si apre nella propria scheda nella parte superiore della finestra. Le schede mostrano lo stato del repository, come le modifiche non confermate o un rebase in corso, e puoi passare da una all'altra tramite la tastiera.

Leggi il grafico dei commit

Il grafico dei commit mostra la cronologia del repository come righe, a partire dalla più recente, con corsie che si dividono dove iniziano i rami e si uniscono dove si uniscono. Le etichette sulle righe mostrano rami e tag; un segno di spunta indica il ramo in cui ti trovi.

Trova un impegno

Premi Ctrl+F (⌘F su un Mac) nel grafico e digita parte di un messaggio di commit, un autore, un SHA, un ramo o un tag. GitTree evidenzia le corrispondenze e si sposta tra di loro; Filter Graph restringe la cronologia stessa.

Ispezionare un commit

Seleziona un commit nel grafico e l'ispettore a destra mostra tutto al riguardo: il messaggio, l'SHA completo, i suoi genitori, chi lo ha scritto e commesso e i file che ha modificato. Seleziona un file per vederne le differenze.

Mettere a fuoco e filtrare il grafico

In un repository occupato, Focus on Current Branch mostra solo il tuo ramo, il suo upstream e la sua base, con quanti commit ha dalla base. Filter Graph… conserva i commit di un autore, un intervallo di date o un percorso. Il filtraggio non cancella mai la cronologia; Clear Graph Filter riporta indietro ogni riga.

Personalizza le colonne del grafico

Il grafico mostra per impostazione predefinita le etichette dei rami, le corsie e il messaggio. Il menu Graph columns aggiunge le colonne Author, Date e SHA e passa alle righe compatte; puoi ridimensionare ogni colonna e nascondere i pannelli laterali.

Confronta i commit e agisci su una selezione

Seleziona due commit tenendo premuto Ctrl (⌘ su un Mac) e scegli Compare These Two Commits per vedere ogni file diverso. Una selezione di diversi commit ha le proprie azioni: copiare gli SHA, selezionare, ripristinare, schiacciare o creare una patch.

Utilizzare il trascinamento del grafico

Trascina l'etichetta di un ramo su un altro ramo nel grafico e GitTree offre cosa possono fare i due: Fast-forward, Merge o Rebase. Non succede nulla finché non scegli; si applicano la consueta conferma e l'annullamento.

Esaminare le modifiche operative

Il pannello Working Changes è il git status di GitTree: elenca tutti i file che hai modificato dall'ultimo commit, divisi in Unstaged Files e Staged Files e mostra le differenze del file selezionato.

File di scena, pezzi e linee selezionate

Un commit contiene solo ciò che metti in scena. In GitTree metti in scena un intero file, una parte di esso, o solo le righe che scegli nel diff, e il resto delle tue modifiche rimane nella cartella di lavoro per un commit successivo.

Scrivi un messaggio di commit e conferma

Il modulo di commit si trova sotto i tuoi file in stage: una riga Summary, una Description facoltativa e Commit Options per coautori, approvazione, hook e push successivi. GitTree evidenzia gli errori comuni nei messaggi prima che tu li commetta.

Modificare l'ultimo commit

La modifica sostituisce l'ultimo commit con uno nuovo che contiene il messaggio corretto e tutte le modifiche che esegui adesso, come git commit --amend. In GitTree è l'opzione Amend Previous Commit nel modulo di commit.

Elimina le modifiche e pulisci i file non tracciati

L'eliminazione riporta i file al loro ultimo stato sottoposto a commit o stage, come git restore; la pulizia rimuove i file che Git non tiene traccia, come git clean. GitTree salva prima uno snapshot di ripristino, quindi Undo può ripristinarli.

Scegli e utilizza una visualizzazione differenziale

Ogni differenza in GitTree può essere mostrata come Hunk, Inline o Split (affiancato). Evidenzia le parole modificate, manda a capo le righe lunghe, ignora le modifiche agli spazi bianchi, visualizza l'anteprima di Markdown e passa da una modifica a quella successiva.

Ignora file da GitTree

I file che non desideri mai salvare, come l'output della build o le impostazioni locali, appartengono a .gitignore. Fai clic con il pulsante destro del mouse su un nuovo file nelle modifiche di lavoro e scegli cosa ignorare oppure modifica .gitignore direttamente con Edit .gitignore….

Creare e applicare patch

Una patch è un file che trasporta le modifiche da un repository all'altro. GitTree salva le modifiche di un file o uno o più commit come patch e applica una patch al tuo albero di lavoro, in stage o come commit sul ramo corrente.

Esamina le immagini e le modifiche binarie

Le differenze di testo non possono mostrare un'immagine. Quando un'immagine PNG, JPEG, GIF, WebP o altra immagine cambia, GitTree confronta le immagini prima e dopo: Side by side, Swipe o Onion skin. Altri file binari mostrano le loro dimensioni.

Gestisci i flag di indice dei file tracciati

A volte modifichi un file tracciato solo sul tuo computer, ad esempio una configurazione locale. Due flag Git nascondono tali modifiche: Skip Worktree… mantiene la tua copia e smette di mostrare le sue modifiche; Assume Unchanged… è un'accelerazione che impedisce a Git di controllare il file. Nessuno dei due è un modo per ignorare un file.

Crea e cambia ramo

Un ramo è un nome mobile per una linea di lavoro. In GitTree, Branch nella barra degli strumenti ne crea uno al commit in cui ti trovi; fare clic con il pulsante destro del mouse su qualsiasi commit per crearne uno lì. Fare doppio clic sull'etichetta di un ramo per passare ad essa.

Rinominare ed eliminare i rami

Fare clic con il pulsante destro del mouse sull'etichetta di un ramo per Rename e Delete. L'eliminazione di un ramo locale salva prima il suo ultimo commit sotto refs/ogt/trash, quindi Undo lo ripristina; l'eliminazione sul telecomando è una scelta separata, denominata chiaramente.

Creare e gestire i tag

Un tag è un nome fisso per un commit, solitamente una versione come v2.2.0. Fai clic con il pulsante destro del mouse su un commit, scegli Tag Here, quindi un tag leggero o annotato. I tag non vengono inviati con i tuoi commit: inviali ciascuno con Push Tag.

Imposta il monitoraggio e pubblica un ramo

Un nuovo ramo esiste solo sul tuo computer finché non lo invii. Il primo Push chiede a quale telecomando inviarlo, e da quel momento in poi il ramo tiene traccia di quel ramo remoto (è upstream), come git push -u. Set Upstream… cambia ciò che tiene traccia.

Confronta rami e tag

Compare References… confronta due rami, tag, rami remoti o commit qualsiasi in base al nome. Mostra quanti commit uno è avanti e indietro rispetto all'altro e i file che differiscono: o ogni differenza (git diff A B) o solo ciò che è cambiato il nuovo lato da quando si sono divisi (A...B, cosa mostra una richiesta pull).

Utilizza le azioni Gitflow

Gitflow è un modello di ramificazione con un ramo di produzione, un ramo di sviluppo e rami di funzionalità, rilascio e hotfix. La sezione Gitflow di GitTree lo inizializza e avvia e termina quei rami, unendoli, taggandoli ed eliminandoli per te.

Riconoscere e lasciare la TESTA distaccata

Fare il check-out di un commit o di un tag invece che di un ramo ti mette su un detached HEAD: non sei su nessun ramo. Puoi guardarti intorno e persino effettuare il commit, ma i nuovi commit non appartengono a nessun ramo. Crea un ramo per conservarli o controlla un ramo per tornare indietro.

Prendi, tira e spingi

Fetch scarica le novità sui tuoi telecomandi senza modificare il tuo lavoro. Pull porta al suo interno l'upstream del tuo ramo. Push invia i tuoi commit al telecomando. Tutti e tre sono nella barra degli strumenti, con le relative opzioni nei menu freccia accanto a loro.

Aggiungi e modifica telecomandi

Un remoto è una copia denominata del repository altrove, ad esempio origin su GitHub. La sezione Remote del pannello di sinistra li elenca; Add Remote… ne aggiunge uno e facendo clic con il pulsante destro del mouse su un telecomando lo modifica, lo recupera, lo sfoltisce o lo rimuove.

Scegli credenziali remote

GitTree esegue il tuo Git, quindi recupera, pull e push sign come fa Git sul tuo computer: su HTTPS tramite il tuo assistente credenziali, su SSH con la tua chiave o l'agente SSH. Le password e i token rimangono nel portachiavi del tuo sistema, mai nei file di GitTree.

Configura il recupero automatico

Il recupero automatico mantiene aggiornati i rami remoti nel grafico senza che tu debba premere Fetch All. Imposta il Auto-fetch interval in minuti per ogni repository aperto, sostituiscilo per un repository e ricevi una notifica sul desktop quando arrivano nuovi commit.

Utilizzare una spinta forzata con leasing

Dopo aver modificato, riorganizzato o reimpostato i commit già inviati, un push normale viene rifiutato. Force Push (With Lease)… sostituisce il ramo remoto con il tuo, ma solo se è ancora dove lo hai recuperato l'ultima volta, come git push --force-with-lease. GitTree non spinge mai con la forza in nessun altro modo.

Lavora con una cronologia del repository limitata

Un clone superficiale scarica solo gli ultimi commit; un clone blobless scarica il contenuto del file solo quando necessario. Entrambi rendono enormi repository rapidi da clonare. In un clone superficiale il grafico mostra dove si ferma la cronologia e Fetch More History o Fetch Full History riportano il resto.

Unisci rami

L'unione porta i commit di un altro ramo nel ramo su cui ti trovi, come git merge. Fai clic con il pulsante destro del mouse sull'altro ramo e scegli Merge … into …: GitTree controlla prima i conflitti e ti consente di scegliere come registrare l'unione.

Ribasare un ramo

La ribasatura riproduce i commit del tuo ramo sopra un altro ramo, quindi la cronologia rimane in linea retta, come git rebase. I commit ottengono nuovi ID; GitTree mantiene il vecchio ramo sotto refs/ogt/trash e Undo lo riporta indietro.

Risolvere i conflitti di unione

Si verifica un conflitto quando entrambi i rami modificano le stesse righe. Il risolutore di GitTree mostra le due versioni affiancate, A e B: seleziona le righe da mantenere in ciascun conflitto, seleziona Output, quindi Save e continua l'unione, il rebase o il cherry-pick.

Scegli e ripristina i commit

Cherry-Pick Commit copia le modifiche di un commit sul tuo ramo corrente come un nuovo commit, come git cherry-pick. Revert Commit aggiunge un nuovo commit che ne annulla uno, come git revert: il modo sicuro per riprendere qualcosa già inviato.

Continuare, saltare o interrompere un'operazione

Un'unione, un rebase, una selezione o un ripristino possono interrompersi a metà, di solito a causa di un conflitto. Un banner sopra il grafico nomina l'operazione e il suo passaggio e offre Resolve, Continue, Skip (rebase) e Abort…. L'interruzione salva prima ciò che cade, quindi Undo lo riporta indietro.

Riutilizzare le risoluzioni dei conflitti registrate

Con Reuse recorded resolutions (rerere) attivo, Git ricorda come hai risolto un conflitto e scrive la stessa risoluzione quando il conflitto si ripresenta, ad esempio durante un rebase ripetuto. GitTree ti dice quando si è verificato e ti consente di esaminarlo prima di contrassegnare il file come risolto.

Modifica la cronologia con un rebase interattivo

Un rebase interattivo riscrive i commit sopra quello scelto: mantieni, riformula, modifica, schiaccia, correggi o rilascia ciascuno e trascinali in un nuovo ordine, come git rebase -i. Per una singola modifica, Edit History nel menu di un commit lo fa in un solo passaggio.

Squash si impegna

Lo schiacciamento combina diversi commit in uno solo, come fixup o squash in git rebase -i. In GitTree ogni squash apre prima la finestra di dialogo Squash: mostra i commit che si piegano, il risultato, il messaggio e chi ottiene il credito, e non cambia nulla finché non confermi. Il tuo lavoro non impegnato non viene mai toccato e Undo ripristina i commit.

Modifica i commit locali selezionati

Per una rapida modifica alla cronologia, non è necessario l'intero editor rebase interattivo. Il menu Edit History di un commit modifica il suo messaggio, lo rilascia o lo sposta su o giù; selezionando diversi commit si apre la finestra di dialogo Squash. GitTree riscrive i commit sopra di esso e mantiene il vecchio ramo, quindi Undo lo rimette a posto.

Reimposta un ramo su un commit

La reimpostazione sposta il ramo corrente su un altro commit, come git reset. Soft mantiene ogni modifica in fase, Mixed le conserva nella cartella di lavoro, Hard le elimina. GitTree salva prima tutto sotto refs/ogt/trash, quindi è possibile annullare anche un hard reset.

Annulla e ripeti

GitTree registra le tue operazioni Git in modo che Undo nella barra degli strumenti possa ripristinare l'ultima: commit, unione, rebase, ripristino, scarto, pulizia, ramo o tag eliminato. Redo lo fa di nuovo. I passaggi distruttivi salvano uno snapshot di ripristino in refs/ogt/trash prima di essere eseguiti.

Trova suggerimenti per le filiali precedenti

Il reflog registra dove puntava un ramo o un HEAD, ogni volta che si spostava: commit, checkout, reset, rebase. View Reflog… elenca quelle voci; scegline uno per mostrare il suo commit nel grafico o Restore as Branch.

Cronologia dei file e colpa

History elenca ogni commit che ha modificato un file, seguendo le ridenominazioni, come git log --follow. Blame mostra, per ogni riga, il commit e l'autore che l'ha modificata per ultima, come git blame. Entrambe sono viste dell'area di lavoro dei file.

Utilizza il flusso di lavoro bisezionato

Bisect trova il primo commit che ha introdotto un problema dimezzando la cronologia tra un commit che lo ha e uno che non lo ha, come git bisect. Seleziona i due commit, testa il commit GitTree effettua il check-out, contrassegnalo come Good o Bad e ripeti finché non nomina First bad commit.

Esporta un archivio

Export Archive… scrive i file di un commit, ramo o tag come .zip o .tar.gz, senza la cartella .git, come git archive. È il modo più rapido per fornire a qualcuno la fonte di una versione.

Utilizzare gli strumenti di manutenzione e creazione del repository

Repository Maintenance… mostra la dimensione del database degli oggetti ed esegue attività che lo controllano o rendono più veloce la cronologia e lo stato. Merge Author Identities… scrive .mailmap righe in modo che una persona con diversi nomi o indirizzi e-mail venga visualizzata come un unico autore.

Organizzare gli spazi di lavoro

Uno spazio di lavoro è un insieme denominato di repository che si apre come un'unità, ad esempio "Client A" o "Mobile". La sua dashboard mostra il ramo di ogni repository, lo stato di sincronizzazione e le modifiche, oltre alle richieste pull e alle operazioni CI/CD su di essi.

Gestisci i repository salvati

Ogni area di lavoro conserva un elenco di Saved repositories: ogni repository che apri, cloni, crei o aggiungi da una scansione mentre è l'area di lavoro corrente viene salvato lì e rimane dopo la chiusura della relativa scheda. Aprili dall'elenco, tutti in una volta, o rimuovine uno; la sua cartella non viene mai toccata.

Modifiche alla scorta

Una scorta mette da parte le modifiche non salvate e ti fornisce una cartella di lavoro pulita, come git stash, in modo da poter cambiare attività e ripristinare le modifiche in un secondo momento. Stash nella barra degli strumenti salva tutto; la scheda Stash del pannello delle modifiche sceglie esattamente cosa.

Lavora su più rami con gli alberi di lavoro

Un albero di lavoro è una seconda cartella di lavoro per lo stesso repository, con il proprio ramo estratto, come git worktree add. Esamina una richiesta pull, esegui una lunga build o lascia che un agente di codifica lavori in uno, senza nascondere nulla nell'altro.

Gestire i sottomoduli

Un sottomodulo è un altro repository bloccato nel tuo in un commit specifico. GitTree li elenca con il loro stato (non inizializzato, aggiornato, commit diverso, in conflitto) e li aggiunge, inizializza, aggiorna, apre, modifica e rimuove.

Utilizza i controlli Git LFS

Git LFS archivia file di grandi dimensioni, come immagini, video o modelli, all'esterno del repository e mantiene al loro posto piccoli file puntatore. Git LFS… lo configura, tiene traccia dei modelli, scarica i contenuti, blocca i file ed elimina i vecchi contenuti.

Sfoglia e modifica i file di progetto

La sezione Files del pannello di sinistra mostra le cartelle del tuo progetto, contrassegnando quelle che contengono le modifiche. Apri un file per leggerlo o modificarlo in una scheda accanto alla scheda Graph e cambialo tra File, Changes, Blame e History.

Apri e modifica file

Un file che apri in GitTree ha la propria scheda accanto alla scheda Graph bloccata. Un file da un commit è di sola lettura; Edit in Working Directory apre la copia nel tuo progetto da modificare e Save. Se nel frattempo il file cambia sul disco, GitTree non salva nulla e ti consente di scegliere.

Ritorna al grafico dei commit

Diff, file, colpa, cronologia, confronti, pipeline e richieste pull si aprono sul grafico. Esc chiude quello in alto e ritorna alla vista che lo aveva aperto; Back to Graph li toglie tutti in una volta. Si nascondono solo i file aperti: le relative schede rimangono accanto alla scheda Graph.

Utilizza il terminale integrato

Terminal nella barra degli strumenti apre una shell nella radice del repository nel cassetto sotto il grafico. Esegui qualsiasi comando lì, incluso Git: il grafico e le modifiche si aggiornano man mano che procedi. Ogni scheda del repository mantiene i propri terminali.

Configura strumenti esterni

Preferenze › External Tools sceglie le aperture Editor, Diff tool e Merge tool GitTree dai menu file e dalla visualizzazione dei conflitti. Automatic utilizza la prima installazione di Visual Studio Code, Cursor e Antigravity; Custom… esegue qualsiasi programma con gli argomenti forniti.

Crea ed esegui azioni personalizzate

I comandi personalizzati eseguono i tuoi programmi su un repository dal pulsante Custom actions e dai menu commit, ramo e file. Ogni argomento viene passato esattamente come scritto, non è coinvolta alcuna shell e la prima esecuzione di un comando mostra esattamente cosa verrà eseguito prima di farlo.

Trova azioni con la tavolozza dei comandi

La tavolozza dei comandi esegue qualsiasi comando GitTree digitando parte del suo nome e passa anche a rami, commit, file e repository aperti. Premi Ctrl+Maiusc+P (⌘⇧P su Mac), digita e premi Invio.

Scorciatoie da tastiera

La maggior parte dei comandi GitTree hanno una scorciatoia. Premi Ctrl+/ (⌘/ su Mac) per visualizzare l'elenco completo all'interno dell'app, filtrato durante la digitazione; Customize… ne cambia qualcuno. Le tabelle seguenti elencano le impostazioni predefinite.

Ispeziona attività e notifiche

Il Activity Log elenca ogni comando git eseguito da GitTree, con il suo output, quanto tempo ha impiegato e se ha fallito; token, password e credenziali negli URL vengono rimossi. Notifications conserva i messaggi mostrati in questa sessione e Preferenze › Notifications decide quali popup verranno visualizzati e se anche il tuo sistema li mostrerà.

Utilizza la Guida alle funzionalità in-app

Il Feature Guide elenca tutto ciò che GitTree può fare, dove trovarlo e le sue scorciatoie, raggruppate per area, con una casella di ricerca. Show me ti porta alla funzione nel repository che hai aperto; lo dicono le funzionalità che necessitano di un repository, Pro o un account connesso.

Connetti GitHub

La connessione di GitHub consente a GitTree di elencare i tuoi repository, richieste pull, problemi e controlli. Accedi con il tuo browser (consigliato: approvi GitTree sulla pagina di GitHub) o utilizza un token di accesso personale. Il token viene conservato solo nel portachiavi del tuo sistema.

Connetti GitLab

GitTree si connette a gitlab.com o a un host GitLab autogestito da te indicato. Accedi con il browser tramite un'applicazione OAuth (per gitlab.com viene utilizzato quello di GitTree) oppure utilizza un token di accesso personale da quell'host. Il token viene utilizzato solo per quell'host.

Connetti Bitbucket Cloud

GitTree si connette a Bitbucket Cloud (bitbucket.org) in tre modi: accedi con il tuo account Bitbucket nel browser, utilizza un token API Atlassian con l'e-mail dell'account oppure utilizza un token di accesso all'area di lavoro, al progetto o al repository. I token vengono conservati solo nel portachiavi del tuo sistema.

Connetti il data center Bitbucket

Per un server Bitbucket Data Center aziendale, dai un nome al suo host, quindi utilizza un token di accesso HTTP personale da esso oppure accedi con il browser tramite il collegamento dell'applicazione OAuth in entrata creato dal tuo amministratore per GitTree. GitTree parla solo con quell'host.

Connetti Azure DevOps

Accedi con il tuo account Microsoft nel browser o usa un token di accesso personale da Azure DevOps. GitTree comunica con dev.azure.com e con il servizio profili di Microsoft per trovare le tue organizzazioni, quindi elenca i relativi repository, richieste pull e pipeline.

Connetti server aziendali e self-hosted

GitTree si connette ai server della tua azienda: GitHub Enterprise Server, autogestito GitLab e Bitbucket Data Center. Dai un nome all'host; GitTree parla con https:// solo quell'host e il token viene utilizzato solo per quell'host. Per accedere al browser è necessaria un'applicazione OAuth registrata lì dal tuo amministratore.

Verifica la disponibilità dell'integrazione

I fornitori non offrono tutti le stesse cose. La scheda Integrations della Guida alle funzionalità mostra, per il fornitore del repository aperto e il tuo account, cos'è Available, cos'è Not offered by quel fornitore e cos'è Coming soon.

Sfoglia e crea repository di provider

Con un account connesso, Clone a repository elenca i repository di quell'account per Owner, con la ricerca, quindi non è necessario copiare un URL. Publish Repository… va nella direzione opposta: crea il repository sul tuo account, lo aggiunge come remoto ed esegue il push del tuo ramo.

Utilizza le fork da GitTree

Un fork è la tua copia di un repository sul provider. Create Fork… chiede al fornitore di crearne uno; Add Remote from Fork… aggiunge un fork esistente come remoto. La creazione di un fork non cambia nulla nel tuo repository finché non lo aggiungi e un telecomando esistente non viene mai sostituito.

Tirare le richieste

Con un account di hosting connesso, GitTree elenca le richieste pull del repository nel pannello di sinistra e le apre ciascuna accanto al grafico: la sua conversazione, i commit, i file e i controlli, con Review… e Merge…. Le richieste pull fanno parte di GitTree Pro.

Crea una richiesta pull o unisci

Fai clic con il pulsante destro del mouse sul ramo e scegli Start a Pull Request…. Scegli cosa unisce From e Into, scrivi Title e Description, aggiungi revisori, facoltativamente Open as a draft, e premi Create Pull Request. Un ramo che non è ancora sul telecomando viene spinto per primo.

Esaminare e discutere i cambiamenti

Apri la richiesta pull, leggi Files e premi + accanto a una riga per aggiungere una riga di commento alla tua recensione. Review… invia la tua decisione (Approve, Request changes o Comment) con un Summary e un commento su ogni riga. È possibile rispondere e risolvere le conversazioni laddove il provider lo supporta.

Unisci o chiudi una richiesta pull

Merge… chiede al provider come unire la richiesta pull, mostra se è Ready to merge e offre solo i Merge method consentiti dal repository. GitTree si unisce solo mentre head è ancora il commit che hai guardato; se arrivano nuovi commit, nulla viene unito.

Utilizza le azioni per i problemi supportate

La sezione Issues del pannello di sinistra elenca i problemi aperti del repository. Aprine uno per leggere e commentare, creane uno con New Issue… o inizia a lavorare con Create Branch from Issue…. I problemi di chiusura e modifica si verificano sulla pagina del fornitore: Open Issue in Browser.

Esamina i controlli e lo stato del commit

GitTree mostra lo stato dell'elemento della configurazione dei commit e delle richieste pull: Checks passing, Checks failing, Checks running, Checks skipped o No checks reported, con il numero di passaggi, errori, esecuzione o salti. Selezionalo per vedere le esecuzioni, aprire il registro di un controllo o Re-run Check.

Viene eseguito CI/CD

GitTree mostra le esecuzioni CI/CD dell'host del tuo repository, come GitHub Azioni, nel pannello di sinistra e in un elenco completo accanto al grafico: cosa è riuscito, cosa non è riuscito e perché, con Re-run Failed Jobs, Cancel Run… e Run Workflow…. CI/CD fa parte di GitTree Pro.

Sfoglia e filtra le esecuzioni

L'elenco CI/CD mostra ogni esecuzione del repository e si aggiorna automaticamente durante l'esecuzione. Filters restringilo di Branch, Workflow, Status e Trigger; Mine mantiene le tue corse; Watch mantiene l'aggiornamento della corsa in background e ti informa quando termina.

Leggi lavori e registri

Apri un'esecuzione e seleziona un lavoro o un passaggio per leggerne il registro nella scheda Log. Jump to first error va direttamente all'errore, Search the log… trova il testo, Timestamps e Wrap cambiano la visualizzazione, Following mantiene in vista l'output live di un lavoro in esecuzione e Save Log… lo scrive in un file.

Eseguire nuovamente o annullare una pipeline

Da un'esecuzione, Re-run Failed Jobs ripete solo ciò che non è riuscito, Re-run All Jobs ripete tutto e il menu di un lavoro riesegue solo quel lavoro (Retry Stage su fasi in stile GitLab). Cancel Run… lo interrompe; Force Cancel Run… lo termina senza consentire la pulizia dei lavori. Nessuno dei due annullamenti può essere annullato.

Esegui un flusso di lavoro

Run Workflow… avvia un flusso di lavoro che può essere eseguito manualmente, ad esempio un flusso di lavoro di azioni GitHub con un trigger workflow_dispatch o una pipeline Bitbucket custom. GitTree legge i suoi input dal file del flusso di lavoro nel ramo scelto e mostra un campo per ciascuno.

Scarica gli artefatti disponibili

La scheda Artifacts di un'esecuzione elenca i file prodotti, con Name, Size e quando Expires. Save… chiede dove salvarlo e lo scarica lì, poiché il provider lo memorizza; uno zip viene salvato come zip e GitTree non lo apre.

Ispezionare distribuzioni e ambienti

Un'esecuzione che esegue la distribuzione mostra Deploys to … e una scheda Environments: ciascun ambiente, la relativa distribuzione, ramo o commit e quando. Una distribuzione in attesa mostra Waiting for approval; se sei uno dei suoi revisori, Approve Deployment… e Reject Deployment… agiscono di conseguenza. Questi cambiamenti cambiano per tutti e non possono essere annullati.

Creare e controllare i file della pipeline

New CI/CD File… scrive un file iniziale dove il tuo provider lo legge, come .github/workflows/ o .gitlab-ci.yml; non scrive mai su un file esistente. Modificalo in GitTree, premi Check with … per far sì che il provider lo convalidi, quindi esegui il commit come qualsiasi file.

Gestire le impostazioni della pipeline

CI/CD Settings mostra ciò che il provider consente a un'altra app di gestire: Variables, Secrets, Environments, Runners, Schedules, Caches, Definitions e Releases. Il valore di un segreto viene digitato in un prompt di sistema sicuro o letto da un file di tua scelta e va direttamente al fornitore; GitTree non lo mostra, non lo conserva né lo invia mai altrove.

Utilizzare i controlli di rilascio della pipeline

CI/CD Settings › Releases elenca le versioni del repository. New Release nomina un tag (o ne crea uno da un ramo o commit), con Title, Notes (Markdown) e file che le persone possono scaricare. Viene pubblicata una versione per tutti coloro che possono vedere il repository, a meno che tu non sia Save as a draft.

Chiedi a Nour informazioni su un guasto della pipeline

Explain Failure apre Nour con una domanda su un'esecuzione non riuscita. Nour legge il registro del passaggio non riuscito (al massimo 64 KiB) solo se approvi, ogni volta, e risponde indicando cosa ritiene sia andato storto e cosa provare. Considera la risposta come un consiglio: confrontala con il registro.

Configura Nour, l'assistente AI

Nour è l'assistente AI di GitTree. Esegue la CLI dell'agente di codifica che già usi, come Claude Code, Codex o Gemini CLI, con il tuo abbonamento: GitTree non vede mai le tue chiavi. In modalità Ask Nour guarda e risponde solo; in modalità Agent può agire entro i limiti consentiti. Nour fa parte di GitTree Pro.

Chiedi a Nour del tuo lavoro

Nour conosce sempre il repository e il ramo estratto della chat. Digita @ per menzionare un file, una cartella, un ramo, una richiesta di commit o pull, allegare un file o indicare a Nour altri rami. I chip sopra la finestra del messaggio mostrano What Nour is told; il selettore dell'ambito decide quali repository copre la chat.

Esamina Nour azioni dell'app

In modalità Agent Nour può agire in GitTree attraverso i propri comandi: open views, stage, commit, fetch, push e altro. Ogni azione appartiene a un tipo (Look around, Change you can undo, Risky) e segue la tua scelta per essa; qualsiasi cosa rischiosa aspetta sempre il tuo clic su una carta di approvazione.

Redigere una richiesta di commit o pull

La casella di commit e la finestra di dialogo della richiesta pull possono redigere il loro testo con una CLI dell'agente di codifica che hai installato: Generate commit message with … legge le modifiche in fase e Draft the title and description with … legge i commit del tuo ramo. Rivedi e modifichi la bozza; nulla viene impegnato o aperto finché non si preme il pulsante.

Gestisci Nour sessioni

Ogni chat viene conservata per repository in Chat history. Stop termina la risposta corrente; Nour arresta anche un agente che non stampa nulla per troppo tempo. Se l'agente scelto non può rispondere (non ha effettuato l'accesso, nessun utilizzo rimasto, modello mancante), un altro agente installato potrebbe invece rispondere e Nour spiega il motivo.

Esamina la privacy e il ripristino di Nour

Prima di ogni turno che potrebbe modificare i file, Nour salva un'istantanea dell'albero di lavoro; Changes from this turn elenca cosa è cambiato e Undo this turn ripristina l'albero di lavoro. Uno snapshot non copre push o file esterni al repository. I tuoi messaggi arrivano all'agente CLI che hai scelto, secondo la politica del suo fornitore; GitTree non memorizza mai una chiave API né chiama un modello stesso.

Configura agenti e modelli

Preferenze › Nour (AI) › Agents elenca le CLI dell'agente GitTree trovate, contrassegnate come Installed o Not installed. Scegli Agent for new chats, un Model per ciascuno (il vuoto utilizza l'impostazione predefinita dell'agente) e il Automatic selection order che segue First one installed. Test controlla che un agente funzioni su questo computer.

Trova e modifica le Preferenze

Le preferenze hanno una pagina per area, come General, Profiles, SSH, Integrations, Nour (AI), External Tools e UI Customization, più Repo-Specific Preferences per ogni repository aperto. Search preferences trova un'impostazione per nome, descrizione o chiave e ciascuna impostazione dice dove si trova Saves to: App, Profile o Repository.

Aspetto e linguaggio

Preferenze › Personalizzazione dell’interfaccia imposta la Lingua (dieci lingue: inglese, arabo da destra a sinistra, giapponese, cinese semplificato, tedesco, coreano, francese, hindi, spagnolo e italiano), il Tema (versioni chiara, scura e ad alto contrasto), Segui l’aspetto del sistema, lo Zoom (%), come vengono mostrate le Date e Riduci il movimento.

Configura il comportamento di Git e del repository

Preferenze › General contiene il modo in cui GitTree guida Git: le opzioni Git executable, Pull mode, Auto-fetch interval, rebase, Long paths e Line endings. Repo-Specific Preferences ne sovrascrive alcuni per un repository, come il suo Base branch, il recupero automatico, il modello di commit e il modo in cui rileva le modifiche ai file.

Gestisci identità e profili Git

Un profilo è un nome e un indirizzo email per i commit, oltre a una chiave di firma opzionale e un comando SSH tra cui è possibile passare. Per impostazione predefinita viene eseguito Passed to each git command GitTree, quindi ~/.gitconfig non viene mai modificato e il nome o l'e-mail di un repository prevale comunque; Written to ~/.gitconfig fa in modo che ogni strumento Git lo utilizzi.

Configura SSH in GitTree

Preferenze › SSH elenca le chiavi nella tua cartella .ssh, ne crea di nuove, mostra ciascun host dalla tua configurazione SSH e testa una connessione. GitTree non avvia mai un agente SSH e non modifica mai ~/.ssh/config o core.sshCommand; una chiave scelta per i telecomandi SSH viene passata ai comandi git che esegue.

Configura il commit e la firma dei tag

Preferenze › Commit Signing seleziona Format (OpenPGP, chiave SSH o X.509) e Key e se Sign every commit e Sign every annotated tag. Non viene scritto nulla finché non si preme Apply to Global Git Config. Il grafico e i dettagli del commit mostrano quindi lo stato della firma di ciascun commit.

Configura strumenti e codifica dei file

Diff e file che non sono UTF-8 vengono letti con Preferenze › Editor › Default encoding; prevale sempre un segno di ordine dei byte e i byte che non rientrano vengono visualizzati come �. Line endings (core.autocrlf) decide come git converte CRLF e LF e Long paths consente a git di creare percorsi di oltre 260 caratteri su Windows.

Configura notifiche e registrazione

Preferenze › Notifications imposta Where notifications appear, se su Show success notifications e Desktop notifications dal tuo sistema. Extended logging in General scrive maggiori dettagli nel registro locale, dal prossimo lancio, per aiutare a diagnosticare un problema; nulla viene inviato da nessuna parte.

Configura i privilegi Nour

Due impostazioni vincolate a Nour. What Nour may do in a repository imposta ciò che l'agente stesso può fare lì: Read only, Edit files, no commands o Everything, as in a terminal. What Nour may do in GitTree imposta, per ogni tipo e area di azione dell'app, Never, Ask me first o On its own; i cambiamenti rischiosi chiedono sempre.

Configura l'aggiornamento dell'integrazione

Preferenze › Integrations controlla come GitTree legge i tuoi account di hosting: quanti anni potrebbero avere gli elenchi prima di Refresh pull requests, issues and checks, se Refresh when I come back, impostazioni predefinite del registro CI/CD e da dove provengono le immagini dell'autore. La lettura avviene solo mentre la finestra di GitTree è di fronte.

Esegui il backup, importa o ripristina le impostazioni

Preferenze › General › Back up, restore and reset esporta le impostazioni dell'app, i profili e le impostazioni git in un file, importa tale file o ripristina tutto. Un'esportazione non contiene mai password, token o dettagli dell'account, né alcuna impostazione del repository. Le impostazioni Git da un'importazione vengono scritte su ~/.gitconfig solo dopo averle esaminate.

Controlla e installa gli aggiornamenti

GitTree non riesce a trovare Git

GitTree utilizza la tua installazione Git e non ne raggruppa né ne installa mai una. Se non ne viene trovato nessuno, mostra GitTree needs Git; se quello trovato è più vecchio di 2.39 mostra This Git is too old. Installa o aggiorna Git oppure premi Locate Git… per sceglierlo, quindi Check again.

Un repository non si aprirà

Quando non è possibile aprire una cartella, GitTree spiega il motivo e offre il passaggio successivo: This folder is not a Git repository (inizializzare o sceglierne un altro), This cannot be opened as a repository (percorso mancante), GitTree cannot read this folder (autorizzazioni) o This repository belongs to another user (controllo della proprietà di Git).

Le modifiche non sono rinfrescanti

GitTree rileva le modifiche apportate in altri programmi tramite le notifiche di modifica del tuo sistema. Sulle cartelle WSL e sulle condivisioni di rete tali notifiche non arrivano, quindi Automatic controlla invece la cartella ogni pochi secondi. Se le modifiche appaiono ancora in ritardo, forza la modalità di controllo per quel repository o aggiorna manualmente.

Un tentativo di autenticazione remota non è riuscito

Git accede prima a un dispositivo remoto con il tuo assistente credenziali o la chiave SSH. … needs you to sign in. significa che non è stata data risposta; … refused the credentials sent for this repository. significa che ciò che è stato inviato non è più valido o non è consentito. Correggi le credenziali utilizzate da Git; un account connesso si riempie solo quando i tuoi aiutanti non hanno nulla o quando lo scegli per un repository.

Una spinta è stata respinta

Un push viene rifiutato per uno dei tre motivi e GitTree dice quale. The remote refused …: il telecomando ha commit, il tuo ramo no. The remote declined the push: una protezione gancio o ramo ha detto no, con il relativo motivo. … moved: un push forzato con lease ha trovato il telecomando non più dove lo avevi recuperato l'ultima volta, quindi non è stato sostituito nulla.

Un'operazione Git richiede attenzione

Quando un'unione, un rebase, un cherry-pick, un ripristino o una bisezione si interrompono parzialmente, GitTree mostra un banner come Rebasing … onto …, step 3 of 7 e contrassegna la scheda rebase in progress. La maggior parte dei comandi attende fino al termine: risolvi eventuali conflitti, quindi Continue, Skip il passaggio o Abort… per tornare al punto di partenza.

Un'azione di integrazione non è disponibile

Quando un'azione di hosting non può essere utilizzata, GitTree spiega il motivo invece di fallire silenziosamente. I motivi più comuni sono: fa parte di GitTree Pro; nessun account è connesso per l'host del remoto; il token deve essere ricollegato; il tuo ruolo nel fornitore non lo consente; il fornitore non lo offre; oppure il fornitore sta limitando le richieste per un po'.

Nour non può iniziare o finire

Nour esegue una CLI dell'agente di codifica sul tuo computer, quindi la maggior parte dei problemi sono dovuti alla CLI: non installata, non effettuato l'accesso, nessun utilizzo rimasto, il modello impostato non è disponibile o necessita di Node.js. GitTree si rifiuta inoltre di avviare una svolta in un repository limitato o quando non può salvare l'istantanea che rende la svolta annullabile.

Non è possibile caricare una pipeline o un log

GitTree indica il motivo per cui manca un'esecuzione o un registro: This repository’s host does not list … runs., This log has expired on …, This account may not read logs here., … offers no log from outside its own page. o che il provider sta limitando le richieste. La maggior parte ha una soluzione; alcuni aprono solo la pagina del provider.

Un portachiavi o una richiesta SSH non sono riusciti

GitTree mantiene i token dell'account, il suo accesso e le passphrase SSH memorizzate solo nel portachiavi del tuo sistema: macOS Keychain, Windows Credential Manager o Secret Service (GNOME Keyring o KeePassXC) su Linux. Quando il portachiavi dice no, GitTree ti chiede di consentire l'accesso e riprovare; non ritorna mai a un file.

Utilizza GitTree mentre sei offline

GitTree è local-first: ogni funzionalità Git locale funziona senza connessione, inclusi commit, rami, fusioni, rebase, stash, cronologia e annullamento. Le integrazioni di recupero, pull, push, hosting, CI/CD e il provider di Nour necessitano della rete; mentre offline GitTree mostra gli ultimi dati letti e lo dice.

Raccogli e condividi un rapporto di supporto

Quando GitTree rileva un errore salva un rapporto su questo computer; nulla viene inviato da nessuna parte. Report a Bug… mostra cosa verrebbe copiato (il rapporto salvato con token e password rimossi o un breve riepilogo), ti consente di scegliere, quindi apre il modulo di supporto sul sito web di GitTree per poterlo incollare. Contact Support… scrive all'indirizzo dell'assistenza.