Dokumentacja

Hangar po instalacji

Wszystko, czego potrzebujesz do codziennej pracy z Hangarem: od pierwszego agenta po pliki, w których Hangar przechowuje twoje ustawienia.

Pierwsze kroki

  1. Zainstaluj. Pobierz Hangar-Setup.exe i uruchom go. Hangar instaluje się tylko dla twojego użytkownika, bez uprawnień administratora.
  2. 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.
  3. 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ół.
  4. 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.

W dowolnym miejscu Hangara
KlawiszeDziałanie
Ctrl+Shift+PSzybki dostęp: znajdź sesje, programy, pliki, ostatnie commity, ustawienia i każde polecenie menu
Ctrl+Shift+SPrzeszukaj dane wyjściowe wszystkich sesji
Ctrl+Shift+MPokaż wszystkie sesje jako kafelki na żywo
Ctrl+Shift+HPokaż widok startowy; sesje działają dalej
Ctrl+Shift+TNowa sesja z ostatnio używanym programem
Ctrl+Shift+WZamknij sesję
Ctrl+TabNastępna sesja
Ctrl+Shift+TabPoprzednia sesja
Ctrl+Shift+APrzejdź do następnej sesji, która na ciebie czeka
Ctrl+Shift+NSzybka notatka
Ctrl+Shift+DPokaż lub ukryj zmiany w folderze sesji
Ctrl+Shift+FPrzeszukaj historię terminala
Ctrl+Shift+BZwiń lub rozwiń pasek boczny
Ctrl+,Otwórz ustawienia
Ctrl++Większy tekst
Ctrl+-Mniejszy tekst
Ctrl+0Przywróć rozmiar tekstu
W terminalu
KlawiszeDziałanie
Ctrl+CKopiuj zaznaczenie; bez zaznaczenia klawisz trafia do programu (przerwanie)
Ctrl+Shift+CKopiuj zaznaczenie i zachowaj je zaznaczone
Ctrl+VWklej; gdy w schowku jest obraz, Hangar wkleja ścieżkę zapisanego pliku obrazu
Shift+EnterNowa linia w prompcie agenta, bez wysyłania
Ctrl+Shift+SpacjaPrzytrzymaj, aby dyktować; mowa jest rozpoznawana na twoim własnym komputerze
W wyszukiwaniu historii
KlawiszeDziałanie
EnterNastępne wystąpienie
Shift+EnterPoprzednie wystąpienie
EscZamknij wyszukiwanie
Notatki, pasek boczny i wysyłanie do kilku sesji
KlawiszeDziałanie
F6 / Shift+F6Przy otwartych notatkach przenoś fokus między terminalem, listą notatek a edytorem
F2Zmień nazwę notatki
Alt+↑ / Alt+↓Przesuń aktywną sesję w górę lub w dół na pasku bocznym
Ctrl+EnterWyś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.

Pola profilu
PoleZnaczenie
idWymagane. Unikalne, bez spacji. Hangar odrzuca dwa identyfikatory, które różnią się tylko wielkością liter.
nameWymagane. Nazwa wyświetlana na pasku bocznym.
commandWymagane. Nazwa programu z PATH lub pełna ścieżka. Bez składni powłoki: Hangar uruchamia program bezpośrednio.
argsArgumenty jako lista, na przykład ["--model", "opus"].
cwdStały folder roboczy. Bez tego pola program startuje w folderze, który wybierzesz.
iconJeden lub dwa znaki jako ikona na pasku bocznym.
[profile.env]Zmienne środowiskowe jako osobna tabela. Nie umieszczaj tu sekretów.
secret_envNazwy zmiennych, których wartości Hangar przechowuje w Menedżerze poświadczeń systemu Windows, na przykład ["GITHUB_TOKEN"].
resume_argsArgumenty do wznowienia ostatniej rozmowy. Zastępują args, zamiast być do nich dopisywane.
version_argsArgumenty do odczytu wersji, domyślnie ["--version"]; [] oznacza: nigdy nie uruchamiaj programu, aby odczytać jego wersję.
latest, packages, self_update, update_hintGdzie 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.

Miejsca przechowywania danych
LokalizacjaZawartość
%APPDATA%\com.feoren.hangar\profiles.tomlTwoje profile
%APPDATA%\com.feoren.hangar\HANGAR.mdTwoje instrukcje dla wszystkich agentów
%APPDATA%\com.feoren.hangar\account.jsonWybrany 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%\HangarSam program
.hangar\notes\Wspólne notatki, zaszyfrowane, w repozytorium
Menedżer poświadczeń systemu WindowsTajne 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.

Kontakt dla zespołów