Pierwsze kroki
- Zainstaluj. Pobierz
Hangar-Setup.exei uruchom go. Hangar instaluje się tylko dla twojego użytkownika, bez uprawnień administratora. - Uruchom agenta. Wybierz folder projektu w sekcji „Nowa sesja”, wybierz „Prywatna” lub „Zespół” i kliknij agenta. Hangar pokazuje wszystkie agenty, które znajdzie na twoim komputerze, razem z ich wersją; w trybie „Zespół” tylko te, które mogą działać jako sesje zespołowe.
- Dołącz swój zespół (opcjonalnie). Kliknij „Zaloguj się” na dole paska bocznego, potwierdź kod w przeglądarce, a potem połącz projekt. Osoby z zespołu, które dołączą do tego samego projektu, widzą się nawzajem w oknie Zespół.
- Zdjęcie profilowe (opcjonalnie). Twoje zdjęcie profilowe z konta Hangar pojawia się na pasku bocznym. Wgrasz je na tej stronie w Konto › Ustawienia.
Pobierz Hangar Obsługiwane agenty
Jeśli podczas instalacji Windows pokaże ostrzeżenie SmartScreen, wybierz „Więcej informacji”, a potem „Uruchom mimo to”. Instalator nie jest jeszcze podpisany certyfikatem podpisywania kodu. Aktualizacje w Hangarze są zawsze podpisane i weryfikowane.
Wymagania: Windows 10 w wersji 1809 lub nowszej albo Windows 11 (x64). Agenty instalujesz sam, na własnych kontach. Git jest potrzebny do sesji zespołowych (worktree), śledzenia zmian, commitów i wspólnych notatek.
Skróty klawiszowe
Hangar przechwytuje tylko kombinacje, których nie potrzebują powłoki ani agenty. Ich odpowiedniki bez Shift zostają dla programu w terminalu: Ctrl+B, Ctrl+F czy Ctrl+P nadal trafiają do twojej powłoki lub agenta.
| Klawisze | Działanie |
|---|---|
| Ctrl+Shift+P | Szybki dostęp: znajdź sesje, programy, pliki, ostatnie commity, ustawienia i każde polecenie menu |
| Ctrl+Shift+S | Przeszukaj dane wyjściowe wszystkich sesji |
| Ctrl+Shift+M | Pokaż wszystkie sesje jako kafelki na żywo |
| Ctrl+Shift+H | Pokaż widok startowy; sesje działają dalej |
| Ctrl+Shift+T | Nowa sesja z ostatnio używanym programem |
| Ctrl+Shift+W | Zamknij sesję |
| Ctrl+Tab | Następna sesja |
| Ctrl+Shift+Tab | Poprzednia sesja |
| Ctrl+Shift+A | Przejdź do następnej sesji, która na ciebie czeka |
| Ctrl+Shift+N | Szybka notatka |
| Ctrl+Shift+D | Pokaż lub ukryj zmiany w folderze sesji |
| Ctrl+Shift+F | Przeszukaj historię terminala |
| Ctrl+Shift+B | Zwiń lub rozwiń pasek boczny |
| Ctrl+, | Otwórz ustawienia |
| Ctrl++ | Większy tekst |
| Ctrl+- | Mniejszy tekst |
| Ctrl+0 | Przywróć rozmiar tekstu |
| Klawisze | Działanie |
|---|---|
| Ctrl+C | Kopiuj zaznaczenie; bez zaznaczenia klawisz trafia do programu (przerwanie) |
| Ctrl+Shift+C | Kopiuj zaznaczenie i zachowaj je zaznaczone |
| Ctrl+V | Wklej; gdy w schowku jest obraz, Hangar wkleja ścieżkę zapisanego pliku obrazu |
| Shift+Enter | Nowa linia w prompcie agenta, bez wysyłania |
| Ctrl+Shift+Spacja | Przytrzymaj, aby dyktować; mowa jest rozpoznawana na twoim własnym komputerze |
| Klawisze | Działanie |
|---|---|
| Enter | Następne wystąpienie |
| Shift+Enter | Poprzednie wystąpienie |
| Esc | Zamknij wyszukiwanie |
| Klawisze | Działanie |
|---|---|
| F6 / Shift+F6 | Przy otwartych notatkach przenoś fokus między terminalem, listą notatek a edytorem |
| F2 | Zmień nazwę notatki |
| Alt+↑ / Alt+↓ | Przesuń aktywną sesję w górę lub w dół na pasku bocznym |
| Ctrl+Enter | Wyślij wiadomość do kilku sesji |
Profile w profiles.toml
Twoje własne terminale i agenty są zapisane w profiles.toml w folderze konfiguracji, w systemie Windows %APPDATA%\com.feoren.hangar\profiles.toml. Jeśli pliku brakuje, Hangar tworzy go przy starcie na podstawie szablonu z komentarzami, z PowerShell 7, Windows PowerShell i Wierszem polecenia.
Najszybciej otworzysz plik w Ustawieniach, w Terminale i agenty › Otwórz plik profili.
Agenty z katalogu nie potrzebują profilu, Hangar zna je sam. Aby uruchomić któryś z nich inaczej, utwórz profil z tym samym id: zastępuje on nazwę, ikonę, polecenie, argumenty i pozycję wpisu z katalogu; strona projektu i polecenie instalacji pozostają z katalogu.
| Pole | Znaczenie |
|---|---|
id | Wymagane. Unikalne, bez spacji. Hangar odrzuca dwa identyfikatory, które różnią się tylko wielkością liter. |
name | Wymagane. Nazwa wyświetlana na pasku bocznym. |
command | Wymagane. Nazwa programu z PATH lub pełna ścieżka. Bez składni powłoki: Hangar uruchamia program bezpośrednio. |
args | Argumenty jako lista, na przykład ["--model", "opus"]. |
cwd | Stały folder roboczy. Bez tego pola program startuje w folderze, który wybierzesz. |
icon | Jeden lub dwa znaki jako ikona na pasku bocznym. |
[profile.env] | Zmienne środowiskowe jako osobna tabela. Nie umieszczaj tu sekretów. |
secret_env | Nazwy zmiennych, których wartości Hangar przechowuje w Menedżerze poświadczeń systemu Windows, na przykład ["GITHUB_TOKEN"]. |
resume_args | Argumenty do wznowienia ostatniej rozmowy. Zastępują args, zamiast być do nich dopisywane. |
version_args | Argumenty do odczytu wersji, domyślnie ["--version"]; [] oznacza: nigdy nie uruchamiaj programu, aby odczytać jego wersję. |
latest, packages, self_update, update_hint | Gdzie publikowane są nowe wersje i jak Hangar aktualizuje program jednym kliknięciem. Szablon z komentarzami w pliku objaśnia każde pole. |
Przykład
Pierwszy profil uruchamia Claude Code z katalogu z innym modelem. Drugi to własny PowerShell ze stałym folderem roboczym, jedną zwykłą i jedną tajną zmienną.
[[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"
Tajne zmienne
Wartości z secret_env nigdy nie pojawiają się w pliku. Wpisujesz je w Ustawieniach, tam gdzie edytujesz profil. Hangar przechowuje je w Menedżerze poświadczeń systemu Windows pod usługą hangar i umieszcza je w środowisku sesji dopiero przy jej starcie. Zmienna nie może występować jednocześnie w [profile.env] i w secret_env.
Po zapisaniu Hangar wczytuje plik ponownie, gdy tylko wrócisz do jego okna, albo wybierasz „Wczytaj profile ponownie”. Hangar pokazuje błąd z numerem wiersza i kolumny; działające sesje pozostają bez zmian.
Powiadomienia o czekających agentach
Pasek boczny pokazuje na pierwszy rzut oka, który agent pracuje, który skończył, a który czeka na ciebie. Cała reszta jest w Ustawieniach, w sekcji Sygnalizacja.
- Wyróżniaj oczekujące sesje: sesja delikatnie pulsuje, gdy agent skończył lub czeka na ciebie, a ty patrzysz gdzie indziej. Sam wybierasz, po ilu sekundach ciszy pojawia się wskazówka.
- Kolory i pulsowanie: Pracuje, Gotowe, Pyta cię i Pauza mają każdy własny kolor, siłę i czas pulsowania, z podglądem.
- Dźwięk: cichy dwutonowy sygnał, gdy czeka sesja, której akurat nie widzisz. Jeśli program kończy się błędem, dźwięk jest niższy. Głośność można regulować.
- Powiadomienie na pulpicie: tylko gdy Hangar działa w tle. Kliknij je, aby otworzyć sesję.
- Miganie na pasku zadań: tylko gdy Hangar nie jest na pierwszym planie. Miganie ustaje, gdy tylko przełączysz się do jego okna.
- Licznik na pasku zadań: mała ikona na przycisku paska zadań pokazuje, ile sesji czeka, od 1 do 9, a powyżej 9+.
- Powiadomienie push na telefon: przez ntfy lub Pushover, gdy sesja na ciebie czeka. W przypadku ntfy wybierz temat trudny do odgadnięcia, bo każdy, kto go zna, może czytać.
- Godziny ciszy: w wybranych przez ciebie godzinach nie ma dźwięku, powiadomienia, pusha na telefon ani migania paska zadań. Kolory i liczba czekających sesji pozostają.
- Działanie w obszarze powiadomień: gdy zamkniesz okno, twoje sesje działają dalej, a ikona w obszarze powiadomień pokazuje, ile z nich czeka. Aby zamknąć Hangar, kliknij ikonę prawym przyciskiem myszy.
Ctrl+Shift+A przenosi cię prosto do następnej czekającej sesji.
Sesje zespołowe i worktree
W sekcji „Nowa sesja” wybierasz „Prywatna” lub „Zespół”. Sesja prywatna działa wprost w twoim folderze, tylko dla ciebie. Sesja zespołowa dostaje własny worktree Git i jest widoczna dla twojego zespołu, dzięki czemu kilka agentów może jednocześnie zmieniać ten sam projekt, nie wyciągając sobie nawzajem plików spod rąk.
Dla każdej sesji zespołowej Hangar tworzy gałąź hangar/… z bieżącego stanu. Gdy agent chce edytować plik, nad którym pracuje inna sesja, Hangar go wstrzymuje i pyta ciebie; odpowiedz „zawsze” lub „nigdy” dla pliku lub folderu, a Hangar zapamięta to dla projektu. Claude Code, Codex CLI, OpenCode i Pi działają jako sesje zespołowe.
Worktree znajdują się w folderze danych aplikacji, w %LOCALAPPDATA%\com.feoren.hangar\worktrees\, a nie obok twojego repozytorium. Dzięki temu repozytoria i synchronizowane foldery pozostają czyste.
Gdy agent startuje w świeżym worktree, najpierw sprawdza, czy w upstreamie są nowe commity, i pyta, zanim je pobierze. Możesz to wyłączyć w ustawieniach, w sekcji Terminale i agenty.
Gdy sesja zespołowa się kończy, Hangar ponownie usuwa jej worktree, chyba że nadal zawiera zmiany lub ignorowane pliki, takie jak wyniki kompilacji, albo pracuje w nim jeszcze inna sesja. Jeśli gałąź ma jeszcze niescalone commity, pozostaje. Hangar niczego nie wymusza.
Git musi być zainstalowany, a folder musi leżeć wewnątrz repozytorium Git. Hangar nie uruchamia Gita na udziałach sieciowych, a sprawdzenie przed edycją nie działa wewnątrz WSL.
Notatki
Notatki należą do projektu sesji albo do obszaru Ogólne. To prawdziwe pliki Markdown, które możesz otworzyć także w Eksploratorze plików.
- Ctrl+Shift+N zaczyna szybką notatkę z dowolnego miejsca.
- Wyślij zaznaczony tekst z terminala prosto do notatki albo notatkę do sesji. Tam zostaje wklejona bez Enter, więc możesz ją najpierw sprawdzić.
- Usunięte notatki trafiają do „Ostatnio usunięte”, skąd możesz je przywrócić.
- Na górze panelu notatek przełączasz się między Prywatne a Udostępnione, dzięki czemu twoje notatki pozostają oddzielone od notatek zespołu.
Wspólne, szyfrowane notatki
Gdy włączysz wspólne notatki dla projektu, Hangar szyfruje je i przechowuje w folderze .hangar\notes\ repozytorium. Wędrują razem z twoimi commitami. Każdy, kto ma repozytorium i kod, może je przeczytać. Odszyfrowany tekst nigdy nie trafia na dysk, a Hangar nigdy sam nie tworzy commitów.
Przy włączaniu Hangar jednorazowo pokazuje kod odzyskiwania notatek. Przechowuj go bezpiecznie: bez niego notatki przepadną na dobre, jeśli ten komputer straci swój klucz. Z kodem otworzysz je także w innym klonie.
Jeden plik instrukcji dla wszystkich agentów
HANGAR.md leży w folderze konfiguracji obok profiles.toml i działa jak AGENTS.md lub CLAUDE.md, tylko bez pliku w twoim repozytorium. Hangar przekazuje jego zawartość każdemu agentowi, który przyjmuje dodatkowe instrukcje: Claude Code, Codex CLI i Aider. Domyślnie jest to włączone; szablon jest pusty i niczego nie wysyła, dopóki czegoś do niego nie wpiszesz.
Plik otwierasz w ustawieniach, w sekcji Terminale i agenty › Otwórz HANGAR.md. Tam też włączasz lub wyłączasz „Używaj HANGAR.md dla każdego agenta”. Nie wpisuj tam sekretów: tekst trafia do wiersza poleceń agentów.
Miejsca przechowywania danych
Hangar przechowuje swoje ustawienia w twoim profilu użytkownika, w systemie Windows w %APPDATA% i %LOCALAPPDATA%. Tylko wspólne notatki znajdują się w projekcie.
| Lokalizacja | Zawartość |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Twoje profile |
%APPDATA%\com.feoren.hangar\HANGAR.md | Twoje instrukcje dla wszystkich agentów |
%APPDATA%\com.feoren.hangar\account.json | Wybrany serwer i serwery, na których jesteś zalogowany; bez tokenów |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Otwarte sesje i ich historia, aby Hangar mógł je przywrócić po ponownym uruchomieniu |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Prywatne notatki jako pliki .md, według folderu projektu i w general; usunięte w .trash |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Worktree twoich sesji |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Wklejone zrzuty ekranu; Hangar usuwa je po tygodniu |
%LOCALAPPDATA%\Hangar | Sam program |
.hangar\notes\ | Wspólne notatki, zaszyfrowane, w repozytorium |
| Menedżer poświadczeń systemu Windows | Tajne zmienne profili, twoje logowanie oraz klucze zespołu i wspólnych notatek |
Własny serwer zespołu
Dla zespołów Hangar domyślnie łączy się z oficjalną usługą pod adresem https://hangar.feoren.com/api/v1. Bez logowania działa wszystko poza oknem Zespół.
Jeśli twój zespół ma własny serwer Hangar, wpisz jego adres w Ustawieniach, w Konto › Adres serwera (własny serwer), i kliknij Zastosuj. Gdy pole jest puste, znów obowiązuje oficjalna usługa.
Adres to baza API serwera, na przykład https://team.example.com/api/v1. Musi zaczynać się od https://; zwykłe http Hangar dopuszcza tylko dla localhost, 127.0.0.1 i [::1]. Nazwa użytkownika, hasło, zapytanie i fragment są niedozwolone. Hangar zapisuje adres w account.json; logowania do innych serwerów pozostają zapisane na urządzeniu.
Taki serwer musi obsługiwać ten sam interfejs co oficjalna usługa: logowanie przez OAuth device flow, konto i projekty, a także bilety dla przekaźnika, który przenosi dane zespołu przez WebSocket. Typy danych protokołu i jego szyfrowanie są otwarte w repozytorium aplikacji, w crate’ach hangar-team-protocol i hangar-team-crypto na licencji MIT.
Wszystko, co udostępniasz zespołowi, jest szyfrowane na twoim urządzeniu. Serwer przechowuje to i przekazuje dalej, ale nie może tego odczytać. Nowe urządzenia dołączają dopiero wtedy, gdy ktoś porówna numer bezpieczeństwa i go potwierdzi.
Stan obecny: Gotowe oprogramowanie serwera do samodzielnego hostowania nie zostało jeszcze opublikowane. Aplikacja już teraz może używać własnego adresu, ale nie ma tu jeszcze instrukcji instalacji.
Planujesz Hangar dla firmy i potrzebujesz własnego serwera? Napisz do nas, a przyjrzymy się twojej sytuacji.