Πρώτα βήματα
- Εγκατάσταση. Κατέβασε το
Hangar-Setup.exeκαι εκτέλεσέ το. Το Hangar εγκαθίσταται μόνο για τον χρήστη σου, χωρίς δικαιώματα διαχειριστή. - Ξεκίνα έναν πράκτορα. Διάλεξε έναν φάκελο έργου στη «Νέα συνεδρία», επίλεξε «Ιδιωτική» ή «Ομάδα» και κάνε κλικ σε έναν πράκτορα. Το Hangar δείχνει κάθε πράκτορα που βρίσκει στον υπολογιστή σου, μαζί με την έκδοσή του· στην «Ομάδα» μόνο όσους μπορούν να τρέξουν ως συνεδρίες ομάδας.
- Φέρε την ομάδα σου (προαιρετικά). Κάνε κλικ στη «Σύνδεση» στο κάτω μέρος της πλαϊνής στήλης, επιβεβαίωσε τον κωδικό στον περιηγητή σου και σύνδεσε το έργο. Όσοι συνάδελφοι μπαίνουν στο ίδιο έργο βλέπουν ο ένας τον άλλον στο παράθυρο Ομάδα.
- Φωτογραφία προφίλ (προαιρετικά). Η φωτογραφία προφίλ σου από τον λογαριασμό Hangar εμφανίζεται στην πλαϊνή στήλη. Την ανεβάζεις σε αυτόν τον ιστότοπο, στο Λογαριασμός › Ρυθμίσεις.
Λήψη του Hangar Υποστηριζόμενοι πράκτορες
Αν τα Windows δείξουν προειδοποίηση SmartScreen κατά την εγκατάσταση, επίλεξε «Περισσότερες πληροφορίες» και μετά «Εκτέλεση οπωσδήποτε». Το πρόγραμμα εγκατάστασης δεν έχει ακόμη υπογραφεί με πιστοποιητικό υπογραφής κώδικα. Οι ενημερώσεις μέσα στο Hangar είναι πάντα υπογεγραμμένες και επαληθευμένες.
Απαιτήσεις: Windows 10 έκδοση 1809 ή νεότερη, ή Windows 11 (x64). Τους πράκτορες τους εγκαθιστάς εσύ, με τους δικούς σου λογαριασμούς. Το Git χρειάζεται για συνεδρίες ομάδας (worktrees), παρακολούθηση αλλαγών, commits και κοινόχρηστες σημειώσεις.
Συντομεύσεις πληκτρολογίου
Το Hangar δεσμεύει μόνο συνδυασμούς που δεν χρειάζονται τα κελύφη και οι πράκτορες. Οι αντίστοιχοι χωρίς Shift μένουν στο πρόγραμμα του τερματικού: τα Ctrl+B, Ctrl+F ή Ctrl+P φτάνουν κανονικά στο κέλυφος ή στον πράκτορά σου.
| Πλήκτρα | Ενέργεια |
|---|---|
| Ctrl+Shift+P | Γρήγορη πρόσβαση: εύρεση συνεδριών, προγραμμάτων, αρχείων, πρόσφατων commits, ρυθμίσεων και κάθε εντολής μενού |
| Ctrl+Shift+S | Αναζήτηση στην έξοδο όλων των συνεδριών |
| Ctrl+Shift+M | Εμφάνιση όλων των συνεδριών ως ζωντανά πλακίδια |
| Ctrl+Shift+H | Εμφάνιση της αρχικής προβολής· οι συνεδρίες συνεχίζουν να τρέχουν |
| Ctrl+Shift+T | Νέα συνεδρία με το πρόγραμμα που χρησιμοποίησες τελευταία |
| Ctrl+Shift+W | Κλείσιμο συνεδρίας |
| Ctrl+Tab | Επόμενη συνεδρία |
| Ctrl+Shift+Tab | Προηγούμενη συνεδρία |
| Ctrl+Shift+A | Μετάβαση στην επόμενη συνεδρία που σε περιμένει |
| Ctrl+Shift+N | Γρήγορη σημείωση |
| Ctrl+Shift+D | Εμφάνιση ή απόκρυψη των αλλαγών στον φάκελο της συνεδρίας |
| Ctrl+Shift+F | Αναζήτηση στο ιστορικό του τερματικού |
| Ctrl+Shift+B | Σύμπτυξη ή ανάπτυξη της πλαϊνής στήλης |
| Ctrl+, | Άνοιγμα ρυθμίσεων |
| Ctrl++ | Μεγαλύτερο κείμενο |
| Ctrl+- | Μικρότερο κείμενο |
| Ctrl+0 | Επαναφορά μεγέθους κειμένου |
| Πλήκτρα | Ενέργεια |
|---|---|
| Ctrl+C | Αντιγραφή της επιλογής· χωρίς επιλογή το πλήκτρο πηγαίνει στο πρόγραμμα (διακοπή) |
| Ctrl+Shift+C | Αντιγραφή της επιλογής χωρίς να χαθεί η επιλογή |
| Ctrl+V | Επικόλληση· αν υπάρχει εικόνα στο πρόχειρο, το Hangar επικολλά τη διαδρομή του αποθηκευμένου αρχείου εικόνας |
| Shift+Enter | Νέα γραμμή στο prompt ενός πράκτορα, χωρίς αποστολή |
| Ctrl+Shift+Διάστημα | Κράτα πατημένο για υπαγόρευση· η ομιλία αναγνωρίζεται στον δικό σου υπολογιστή |
| Πλήκτρα | Ενέργεια |
|---|---|
| Enter | Επόμενο αποτέλεσμα |
| Shift+Enter | Προηγούμενο αποτέλεσμα |
| Esc | Κλείσιμο αναζήτησης |
| Πλήκτρα | Ενέργεια |
|---|---|
| F6 / Shift+F6 | Με ανοιχτές τις σημειώσεις, μετακίνηση της εστίασης μεταξύ τερματικού, λίστας σημειώσεων και επεξεργαστή |
| F2 | Μετονομασία σημείωσης |
| Alt+↑ / Alt+↓ | Μετακίνηση της εστιασμένης συνεδρίας πάνω ή κάτω στην πλαϊνή στήλη |
| Ctrl+Enter | Αποστολή μηνύματος σε πολλές συνεδρίες |
Προφίλ στο profiles.toml
Τα δικά σου τερματικά και οι πράκτορες βρίσκονται στο profiles.toml στον φάκελο ρυθμίσεων, στα Windows %APPDATA%\com.feoren.hangar\profiles.toml. Αν το αρχείο λείπει, το Hangar το δημιουργεί κατά την εκκίνηση από ένα σχολιασμένο πρότυπο, με PowerShell 7, Windows PowerShell και Γραμμή εντολών.
Ο πιο γρήγορος τρόπος να ανοίξεις το αρχείο είναι στις Ρυθμίσεις, στο Τερματικά & πράκτορες › Άνοιγμα αρχείου προφίλ.
Οι πράκτορες του καταλόγου δεν χρειάζονται προφίλ, το Hangar τους γνωρίζει μόνο του. Για να ξεκινήσεις κάποιον διαφορετικά, φτιάξε ένα προφίλ με το ίδιο id: αντικαθιστά όνομα, εικονίδιο, εντολή, ορίσματα και θέση της καταχώρισης του καταλόγου· η σελίδα του έργου και η εντολή εγκατάστασης μένουν από τον κατάλογο.
| Πεδίο | Σημασία |
|---|---|
id | Υποχρεωτικό. Μοναδικό, χωρίς κενά. Το Hangar απορρίπτει δύο IDs που διαφέρουν μόνο σε κεφαλαία και πεζά. |
name | Υποχρεωτικό. Όνομα εμφάνισης στην πλαϊνή στήλη. |
command | Υποχρεωτικό. Όνομα προγράμματος από το PATH ή πλήρης διαδρομή. Χωρίς σύνταξη κελύφους: το Hangar ξεκινά το πρόγραμμα απευθείας. |
args | Ορίσματα ως λίστα, για παράδειγμα ["--model", "opus"]. |
cwd | Σταθερός φάκελος εργασίας. Χωρίς αυτό το πεδίο το πρόγραμμα ξεκινά στον φάκελο που διαλέγεις. |
icon | Ένας ή δύο χαρακτήρες για το εικονίδιο στην πλαϊνή στήλη. |
[profile.env] | Μεταβλητές περιβάλλοντος ως ξεχωριστός πίνακας. Μη βάζεις μυστικά εδώ. |
secret_env | Ονόματα μεταβλητών των οποίων τις τιμές το Hangar κρατά στη Διαχείριση διαπιστευτηρίων των Windows, για παράδειγμα ["GITHUB_TOKEN"]. |
resume_args | Ορίσματα για συνέχιση της τελευταίας συνομιλίας. Αντικαθιστούν τα args αντί να προστίθενται. |
version_args | Ορίσματα για το ερώτημα έκδοσης, προεπιλογή ["--version"]· το [] σημαίνει: μην ξεκινάς ποτέ το πρόγραμμα για να διαβάσεις την έκδοσή του. |
latest, packages, self_update, update_hint | Πού δημοσιεύονται οι νέες εκδόσεις και πώς το Hangar ενημερώνει το πρόγραμμα με ένα κλικ. Το σχολιασμένο πρότυπο στο αρχείο εξηγεί κάθε πεδίο. |
Παράδειγμα
Το πρώτο προφίλ ξεκινά το Claude Code του καταλόγου με άλλο μοντέλο. Το δεύτερο είναι ένα δικό σου PowerShell με σταθερό φάκελο εργασίας, μία απλή και μία μυστική μεταβλητή.
[[profile]]
id = "claude"
name = "Claude Code (Opus)"
command = "claude"
args = ["--model", "opus"]
icon = "C"
[[profile]]
id = "pwsh-shop"
name = "PowerShell (Shop)"
command = "pwsh"
args = ["-NoLogo"]
cwd = 'C:\src\shop'
icon = "SH"
secret_env = ["GITHUB_TOKEN"]
[profile.env]
DOTNET_CLI_TELEMETRY_OPTOUT = "1"
Μυστικές μεταβλητές
Οι τιμές από το secret_env δεν εμφανίζονται ποτέ στο αρχείο. Τις εισάγεις στις Ρυθμίσεις, εκεί όπου επεξεργάζεσαι το προφίλ. Το Hangar τις κρατά στη Διαχείριση διαπιστευτηρίων των Windows με την υπηρεσία hangar και τις βάζει στο περιβάλλον μιας συνεδρίας μόνο όταν αυτή ξεκινά. Μια μεταβλητή δεν επιτρέπεται να υπάρχει ταυτόχρονα στο [profile.env] και στο secret_env.
Αφού αποθηκεύσεις, το Hangar ξαναφορτώνει το αρχείο μόλις επιστρέψεις στο παράθυρό του, ή επιλέγεις «Επαναφόρτωση προφίλ». Το Hangar δείχνει τα σφάλματα με γραμμή και στήλη· οι συνεδρίες που τρέχουν μένουν όπως είναι.
Ειδοποιήσεις για πράκτορες σε αναμονή
Η πλαϊνή στήλη δείχνει με μια ματιά ποιος πράκτορας εργάζεται, ποιος είναι έτοιμος και ποιος σε περιμένει. Όλα τα υπόλοιπα βρίσκονται στις Ρυθμίσεις, στην Ειδοποίηση.
- Επισήμανση συνεδριών σε αναμονή: μια συνεδρία πάλλεται απαλά όταν ένας πράκτορας τελειώσει ή σε περιμένει ενώ κοιτάς αλλού. Εσύ ορίζεις μετά από πόσα δευτερόλεπτα ησυχίας εμφανίζεται η ένδειξη.
- Χρώματα και παλμός: τα Εργάζεται, Έτοιμο, Σε ρωτά και Παύση έχουν το καθένα δικό του χρώμα, ένταση και διάρκεια παλμού, με προεπισκόπηση.
- Αναπαραγωγή ήχου: ένα απαλό δίτονο καμπανάκι όταν περιμένει μια συνεδρία που δεν βλέπεις αυτή τη στιγμή. Αν ένα πρόγραμμα τελειώσει με σφάλμα, ακούγεται χαμηλότερα. Η ένταση ρυθμίζεται.
- Εμφάνιση ειδοποίησης όταν μια συνεδρία περιμένει: μόνο όσο το Hangar είναι στο παρασκήνιο. Κάνε κλικ σε αυτήν για να ανοίξεις τη συνεδρία.
- Αναλαμπή στη γραμμή εργασιών όταν μια συνεδρία περιμένει: μόνο όσο το Hangar δεν είναι στο προσκήνιο. Η αναλαμπή σταματά μόλις μεταβείς στο παράθυρό του.
- Πλήθος στη γραμμή εργασιών: ένα μικρό εικονίδιο στο κουμπί της γραμμής εργασιών δείχνει πόσες συνεδρίες περιμένουν, από 1 έως 9 και 9+ από εκεί και πάνω.
- Push στο κινητό σου: μέσω ntfy ή Pushover όταν μια συνεδρία σε περιμένει. Με το ntfy διάλεξε ένα θέμα (topic) που δύσκολα μαντεύεται, γιατί όποιος το γνωρίζει μπορεί να διαβάζει.
- Ώρες ησυχίας: τις ώρες που διαλέγεις δεν υπάρχει ήχος, ειδοποίηση, push στο κινητό ούτε αναλαμπή στη γραμμή εργασιών. Τα χρώματα και το πλήθος των συνεδριών σε αναμονή παραμένουν.
- Συνέχιση στην περιοχή ειδοποιήσεων όταν κλείνεις το παράθυρο: οι συνεδρίες σου συνεχίζουν να τρέχουν και το εικονίδιο στην περιοχή ειδοποιήσεων δείχνει πόσες περιμένουν. Για να τερματίσεις το Hangar, κάνε δεξί κλικ στο εικονίδιο.
Το Ctrl+Shift+A σε πηγαίνει κατευθείαν στην επόμενη συνεδρία σε αναμονή.
Συνεδρίες ομάδας και worktrees
Στη «Νέα συνεδρία» διαλέγεις «Ιδιωτική» ή «Ομάδα». Μια ιδιωτική συνεδρία τρέχει απευθείας στον φάκελό σου, μόνο για σένα. Μια συνεδρία ομάδας παίρνει το δικό της Git worktree και είναι ορατή στην ομάδα σου, ώστε πολλοί πράκτορες να μπορούν να αλλάζουν το ίδιο έργο ταυτόχρονα χωρίς να τραβούν τα αρχεία ο ένας κάτω από τα πόδια του άλλου.
Για κάθε συνεδρία ομάδας το Hangar δημιουργεί έναν κλάδο hangar/… από την τρέχουσα κατάσταση. Όταν ένας πράκτορας θέλει να επεξεργαστεί ένα αρχείο στο οποίο δουλεύει άλλη συνεδρία, το Hangar τον σταματά και σε ρωτά· απάντησε «πάντα» ή «ποτέ» για ένα αρχείο ή φάκελο και το Hangar το θυμάται ανά έργο. Τα Claude Code, Codex CLI, OpenCode και Pi τρέχουν ως συνεδρίες ομάδας.
Τα worktrees βρίσκονται στον φάκελο δεδομένων της εφαρμογής, στο %LOCALAPPDATA%\com.feoren.hangar\worktrees\, όχι δίπλα στο αποθετήριό σου. Έτσι τα αποθετήρια και οι συγχρονισμένοι φάκελοι μένουν καθαροί.
Όταν ένας πράκτορας ξεκινά σε φρέσκο worktree, ελέγχει πρώτα για νέα commits στο upstream και ρωτά πριν τα φέρει. Μπορείς να το απενεργοποιήσεις στις ρυθμίσεις, στα Τερματικά & πράκτορες.
Όταν τελειώνει μια συνεδρία ομάδας, το Hangar αφαιρεί ξανά το worktree της, εκτός αν περιέχει ακόμη αλλαγές ή αγνοημένα αρχεία, όπως αποτελέσματα build, ή αν άλλη συνεδρία δουλεύει ακόμη σε αυτό. Αν ο κλάδος έχει commits που δεν έχουν συγχωνευτεί ακόμη, παραμένει. Το Hangar δεν επιβάλλει ποτέ τίποτα.
Το Git πρέπει να είναι εγκατεστημένο και ο φάκελος να βρίσκεται μέσα σε αποθετήριο Git. Το Hangar δεν εκτελεί Git σε κοινόχρηστους φακέλους δικτύου, και ο έλεγχος πριν από επεξεργασίες δεν ισχύει μέσα στο WSL.
Σημειώσεις
Οι σημειώσεις ανήκουν στο έργο μιας συνεδρίας ή στην περιοχή Γενικά. Είναι πραγματικά αρχεία Markdown που μπορείς να ανοίξεις και στην Εξερεύνηση αρχείων.
- Το Ctrl+Shift+N ξεκινά μια γρήγορη σημείωση από οπουδήποτε.
- Στείλε επιλεγμένο κείμενο του τερματικού κατευθείαν σε μια σημείωση, ή μια σημείωση σε μια συνεδρία. Εκεί επικολλάται χωρίς Enter, ώστε να το ελέγξεις πρώτα.
- Οι διαγραμμένες σημειώσεις πηγαίνουν στις «Πρόσφατα διαγραμμένες», από όπου μπορείς να τις επαναφέρεις.
- Πάνω στο πάνελ σημειώσεων εναλλάσσεσαι ανάμεσα σε Ιδιωτικές και Κοινόχρηστες, ώστε οι δικές σου σημειώσεις να μένουν χωριστά από της ομάδας.
Κοινόχρηστες, κρυπτογραφημένες σημειώσεις
Όταν ενεργοποιείς τις κοινόχρηστες σημειώσεις για ένα έργο, το Hangar τις κρυπτογραφεί και τις κρατά στον φάκελο .hangar\notes\ του αποθετηρίου. Ταξιδεύουν μαζί με τα commits σου. Όποιος έχει το αποθετήριο και τον κωδικό μπορεί να τις διαβάσει. Το αποκρυπτογραφημένο κείμενο δεν γράφεται ποτέ στον δίσκο και το Hangar δεν κάνει ποτέ commit από μόνο του.
Όταν τις ενεργοποιείς, το Hangar δείχνει μία φορά έναν κωδικό ανάκτησης σημειώσεων. Φύλαξέ τον καλά: χωρίς αυτόν, οι σημειώσεις χάνονται οριστικά αν αυτός ο υπολογιστής χάσει το κλειδί του. Με τον κωδικό τις ανοίγεις και σε άλλο κλώνο.
Ένα αρχείο οδηγιών για όλους τους πράκτορες
Το HANGAR.md βρίσκεται στον φάκελο ρυθμίσεων δίπλα στο profiles.toml και λειτουργεί όπως το AGENTS.md ή το CLAUDE.md, μόνο που δεν χρειάζεται αρχείο στο αποθετήριό σου. Το Hangar δίνει το περιεχόμενό του σε κάθε πράκτορα που δέχεται πρόσθετες οδηγίες: Claude Code, Codex CLI και Aider. Είναι ενεργό από προεπιλογή· το πρότυπο είναι κενό και δεν στέλνει τίποτα μέχρι να γράψεις μέσα του.
Ανοίγεις το αρχείο στις ρυθμίσεις, στα Τερματικά & πράκτορες › Άνοιγμα του HANGAR.md. Εκεί ενεργοποιείς ή απενεργοποιείς και τη «Χρήση του HANGAR.md για κάθε πράκτορα». Μη γράφεις μυστικά μέσα: το κείμενο εμφανίζεται στη γραμμή εντολών των πρακτόρων.
Θέσεις αποθήκευσης
Το Hangar κρατά τις ρυθμίσεις του στο προφίλ χρήστη σου, στα Windows στα %APPDATA% και %LOCALAPPDATA%. Μόνο οι κοινόχρηστες σημειώσεις βρίσκονται στο έργο.
| Θέση | Περιεχόμενο |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Τα προφίλ σου |
%APPDATA%\com.feoren.hangar\HANGAR.md | Οι οδηγίες σου για όλους τους πράκτορες |
%APPDATA%\com.feoren.hangar\account.json | Ο επιλεγμένος διακομιστής και οι διακομιστές όπου είσαι συνδεδεμένος· χωρίς tokens |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Ανοιχτές συνεδρίες και το ιστορικό τους, ώστε το Hangar να τις επαναφέρει μετά από επανεκκίνηση |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Ιδιωτικές σημειώσεις ως αρχεία .md, ανά φάκελο έργου και στο general· οι διαγραμμένες στο .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktrees των συνεδριών σου |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Επικολλημένα στιγμιότυπα οθόνης· το Hangar τα διαγράφει μετά από μία εβδομάδα |
%LOCALAPPDATA%\Hangar | Το ίδιο το πρόγραμμα |
.hangar\notes\ | Κοινόχρηστες σημειώσεις, κρυπτογραφημένες, στο αποθετήριο |
| Διαχείριση διαπιστευτηρίων των Windows | Μυστικές μεταβλητές προφίλ, η σύνδεσή σου και τα κλειδιά για την ομάδα και τις κοινόχρηστες σημειώσεις |
Ο δικός σου διακομιστής ομάδας
Για ομάδες, το Hangar συνδέεται από προεπιλογή στην επίσημη υπηρεσία στο https://hangar.feoren.com/api/v1. Χωρίς σύνδεση λειτουργούν όλα εκτός από το παράθυρο Ομάδα.
Αν η ομάδα σου τρέχει δικό της διακομιστή Hangar, γράψε τη διεύθυνσή του στις Ρυθμίσεις, στο Λογαριασμός › Διεύθυνση διακομιστή (αυτοφιλοξενία), και κάνε κλικ στην Εφαρμογή. Αν μείνει κενό, ισχύει ξανά η επίσημη υπηρεσία.
Η διεύθυνση είναι η βάση API του διακομιστή, για παράδειγμα https://team.example.com/api/v1. Πρέπει να ξεκινά με https://· το Hangar επιτρέπει απλό http μόνο για localhost, 127.0.0.1 και [::1]. Όνομα χρήστη, κωδικός πρόσβασης, query και fragment δεν επιτρέπονται. Το Hangar αποθηκεύει τη διεύθυνση στο account.json· οι συνδέσεις σε άλλους διακομιστές μένουν αποθηκευμένες στη συσκευή.
Ένας τέτοιος διακομιστής πρέπει να μιλά την ίδια διεπαφή με την επίσημη υπηρεσία: σύνδεση μέσω OAuth device flow, λογαριασμός και έργα, καθώς και εισιτήρια για το relay που μεταφέρει τα δεδομένα της ομάδας μέσω WebSocket. Οι τύποι δεδομένων του πρωτοκόλλου και η κρυπτογράφησή του είναι ανοιχτά στο αποθετήριο της εφαρμογής, στα crates hangar-team-protocol και hangar-team-crypto με άδεια MIT.
Ό,τι μοιράζεται με την ομάδα κρυπτογραφείται στη συσκευή σου. Ο διακομιστής το αποθηκεύει και το προωθεί, αλλά δεν μπορεί να το διαβάσει. Νέες συσκευές μπαίνουν μόνο αφού κάποιος συγκρίνει έναν αριθμό ασφαλείας και τον επιβεβαιώσει.
Πού βρισκόμαστε: Έτοιμο λογισμικό διακομιστή για αυτοφιλοξενία δεν έχει δημοσιευτεί ακόμη. Η εφαρμογή μπορεί ήδη να χρησιμοποιήσει δική σου διεύθυνση, αλλά εδώ δεν υπάρχει ακόμη οδηγός εγκατάστασης.
Σχεδιάζεις το Hangar για μια εταιρεία και χρειάζεσαι δικό σου διακομιστή; Γράψε μας και θα εξετάσουμε την περίπτωσή σου.