İlk adımlar
- Kur.
Hangar-Setup.exedosyasını indir ve çalıştır. Hangar yalnızca senin kullanıcın için, yönetici hakları olmadan kurulur. - Bir ajan başlat. "Yeni oturum" altında bir proje klasörü seç, "Özel" ya da "Ekip" seç ve bir ajana tıkla. Hangar bilgisayarında bulduğu her ajanı sürümüyle birlikte listeler; "Ekip" altında yalnızca ekip oturumu olarak çalışabilenleri.
- Ekibini dahil et (isteğe bağlı). Kenar çubuğunun altındaki "Oturum aç" düğmesine tıkla, kodu tarayıcında onayla, ardından projeyi bağla. Aynı projeye katılan ekip arkadaşları Ekip penceresinde birbirini görür.
- Profil fotoğrafı (isteğe bağlı). Hangar hesabındaki profil fotoğrafın kenar çubuğunda görünür. Onu bu sitede Hesap › Ayarlar altından yüklersin.
Hangar'ı indir Desteklenen ajanlar
Kurulum sırasında Windows bir SmartScreen uyarısı gösterirse önce "Ek bilgi", ardından "Yine de çalıştır" seçeneğini seç. Kurulum programı henüz bir kod imzalama sertifikasıyla imzalanmadı. Hangar içindeki güncellemeler her zaman imzalı ve doğrulanmıştır.
Gereksinimler: Windows 10 sürüm 1809 veya üstü ya da Windows 11 (x64). Ajanları kendi hesaplarınla kendin kurarsın. Ekip oturumları (worktree'ler), değişiklik takibi, commit'ler ve paylaşılan notlar için Git gerekir.
Klavye kısayolları
Hangar yalnızca kabukların ve ajanların ihtiyaç duymadığı kombinasyonları yakalar. Shift olmayan karşılıkları terminaldeki programda kalır: Ctrl+B, Ctrl+F veya Ctrl+P yine kabuğuna ya da ajanına ulaşır.
| Tuşlar | İşlem |
|---|---|
| Ctrl+Shift+P | Hızlı erişim: oturumları, programları, dosyaları, son commit'leri, ayarları ve her menü komutunu bul |
| Ctrl+Shift+S | Tüm oturumların çıktısında ara |
| Ctrl+Shift+M | Tüm oturumları canlı kutucuklar olarak göster |
| Ctrl+Shift+H | Ana görünümü göster; oturumlar çalışmaya devam eder |
| Ctrl+Shift+T | En son kullanılan programla yeni oturum |
| Ctrl+Shift+W | Oturumu kapat |
| Ctrl+Tab | Sonraki oturum |
| Ctrl+Shift+Tab | Önceki oturum |
| Ctrl+Shift+A | Seni bekleyen bir sonraki oturuma git |
| Ctrl+Shift+N | Hızlı not |
| Ctrl+Shift+D | Oturum klasöründeki değişiklikleri göster veya gizle |
| Ctrl+Shift+F | Terminal geçmişinde ara |
| Ctrl+Shift+B | Kenar çubuğunu daralt veya genişlet |
| Ctrl+, | Ayarları aç |
| Ctrl++ | Daha büyük metin |
| Ctrl+- | Daha küçük metin |
| Ctrl+0 | Metin boyutunu sıfırla |
| Tuşlar | İşlem |
|---|---|
| Ctrl+C | Seçimi kopyala; seçim yoksa tuş programa gider (kesme) |
| Ctrl+Shift+C | Seçimi kopyala ve seçili bırak |
| Ctrl+V | Yapıştır; panoda bir resim varsa Hangar kaydedilen resim dosyasının yolunu yapıştırır |
| Shift+Enter | Bir ajanın prompt’unda göndermeden yeni satır |
| Ctrl+Shift+Boşluk | Dikte için basılı tut; konuşma kendi bilgisayarında tanınır |
| Tuşlar | İşlem |
|---|---|
| Enter | Sonraki eşleşme |
| Shift+Enter | Önceki eşleşme |
| Esc | Aramayı kapat |
| Tuşlar | İşlem |
|---|---|
| F6 / Shift+F6 | Notlar açıkken odağı terminal, not listesi ve düzenleyici arasında taşı |
| F2 | Notu yeniden adlandır |
| Alt+↑ / Alt+↓ | Odaktaki oturumu kenar çubuğunda yukarı veya aşağı taşı |
| Ctrl+Enter | Birden çok oturuma mesaj gönder |
profiles.toml içindeki profiller
Kendi terminallerin ve ajanların yapılandırma klasöründeki profiles.toml dosyasında durur, Windows'ta %APPDATA%\com.feoren.hangar\profiles.toml. Dosya yoksa Hangar başlangıçta onu açıklamalı bir şablondan PowerShell 7, Windows PowerShell ve Komut İstemi ile oluşturur.
Dosyayı açmanın en hızlı yolu Ayarlar içinde Terminaller ve ajanlar › Profil dosyasını aç seçeneğidir.
Katalogdaki ajanların profile ihtiyacı yoktur, Hangar onları kendisi tanır. Birini farklı başlatmak için aynı id ile bir profil oluştur: katalog girdisinin adını, simgesini, komutunu, argümanlarını ve konumunu değiştirir; proje sayfası ve kurulum komutu katalogdan kalır.
| Alan | Anlamı |
|---|---|
id | Zorunlu. Benzersiz, boşluksuz. Hangar yalnızca büyük ve küçük harf farkıyla ayrılan iki ID'yi reddeder. |
name | Zorunlu. Kenar çubuğundaki görünen ad. |
command | Zorunlu. PATH'teki program adı veya tam yol. Kabuk sözdizimi yok: Hangar programı doğrudan başlatır. |
args | Liste olarak argümanlar, örneğin ["--model", "opus"]. |
cwd | Sabit çalışma klasörü. Bu alan olmadan program seçtiğin klasörde başlar. |
icon | Kenar çubuğundaki simge için bir veya iki karakter. |
[profile.env] | Ayrı bir tablo olarak ortam değişkenleri. Buraya gizli bilgi koyma. |
secret_env | Değerlerini Hangar'ın Windows Kimlik Bilgileri Yöneticisi'nde tuttuğu değişkenlerin adları, örneğin ["GITHUB_TOKEN"]. |
resume_args | Son konuşmaya devam etmek için argümanlar. args'ın sonuna eklenmez, onun yerine geçer. |
version_args | Sürüm sorgusu için argümanlar, varsayılan ["--version"]; [] şu anlama gelir: sürümünü okumak için programı asla başlatma. |
latest, packages, self_update, update_hint | Yeni sürümlerin nerede yayımlandığı ve Hangar'ın programı tek tıklamayla nasıl güncellediği. Dosyadaki açıklamalı şablon her alanı açıklar. |
Örnek
İlk profil katalogdaki Claude Code'u farklı bir modelle başlatır. İkincisi sabit çalışma klasörüne, bir düz ve bir gizli değişkene sahip kendi PowerShell'indir.
[[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"
Gizli değişkenler
secret_env içindeki değerler dosyada asla görünmez. Onları Ayarlar'da, profili düzenlediğin yerde girersin. Hangar bunları Windows Kimlik Bilgileri Yöneticisi'nde hangar hizmeti altında tutar ve yalnızca bir oturum başlarken onun ortamına koyar. Bir değişken hem [profile.env] hem de secret_env içinde bulunamaz.
Kaydettikten sonra Hangar, penceresine döndüğün anda dosyayı yeniden yükler ya da sen "Profilleri yeniden yükle" seçeneğini seçersin. Hangar hataları satır ve sütunla gösterir; çalışan oturumlar olduğu gibi kalır.
Bekleyen ajanlar için bildirimler
Kenar çubuğu hangi ajanın çalıştığını, hangisinin bittiğini ve hangisinin seni beklediğini bir bakışta gösterir. Geri kalan her şey Ayarlar içinde Uyarılar bölümündedir.
- Bekleyen oturumları vurgula: sen başka yere bakarken bir ajan işini bitirdiğinde veya seni beklediğinde oturum hafifçe nabız gibi atar. İpucunun kaç saniyelik sessizlikten sonra görüneceğini sen seçersin.
- Renkler ve nabız: Çalışıyor, Bitti, Sana soruyor ve Duraklama durumlarının her biri önizlemeyle birlikte kendi rengini, nabız gücünü ve nabız süresini alır.
- Ses çal: şu anda göremediğin bir oturum beklerken yumuşak, iki tonlu bir zil sesi. Bir program hatayla biterse ses daha pes çıkar. Ses düzeyi ayarlanabilir.
- Bir oturum beklerken bildirim göster: yalnızca Hangar arka plandayken. Oturumu açmak için bildirime tıkla.
- Bir oturum beklediğinde görev çubuğunu yanıp söndür: yalnızca Hangar ön planda değilken. Penceresine geçtiğin anda yanıp sönme durur.
- Görev çubuğunda sayı: görev çubuğu düğmesindeki küçük bir simge kaç oturumun beklediğini gösterir, 1'den 9'a kadar, üstü için 9+.
- Telefonuna push: bir oturum seni beklediğinde ntfy ya da Pushover üzerinden. ntfy ile tahmin edilmesi zor bir konu seç, çünkü onu bilen herkes okuyabilir.
- Sessiz saatler: seçtiğin saatlerde ses, bildirim, telefona push ve yanıp sönen görev çubuğu olmaz. Renkler ve bekleyen oturumların sayısı kalır.
- Pencereyi kapattığında bildirim alanında çalışmaya devam et: pencereyi kapattığında oturumların çalışmaya devam eder ve bildirim alanındaki simge kaç tanesinin beklediğini gösterir. Hangar'dan çıkmak için simgeye sağ tıkla.
Ctrl+Shift+A seni doğrudan bekleyen bir sonraki oturuma götürür.
Ekip oturumları ve worktree'ler
"Yeni oturum" altında "Özel" ya da "Ekip" seçersin. Özel bir oturum doğrudan klasöründe, yalnızca senin için çalışır. Ekip oturumu kendi Git worktree'sini alır ve ekibine görünür; böylece birden çok ajan aynı projeyi aynı anda, birbirinin ayağının altından dosya çekmeden değiştirebilir.
Hangar her ekip oturumu için mevcut durumdan bir hangar/… dalı oluşturur. Bir ajan, başka bir oturumun üzerinde çalıştığı bir dosyayı düzenlemek istediğinde Hangar onu bekletir ve sana sorar; bir dosya ya da klasör için "her zaman" ya da "asla" diye cevap ver, Hangar bunu proje başına hatırlar. Claude Code, Codex CLI, OpenCode ve Pi ekip oturumu olarak çalışır.
Worktree'ler deponun yanında değil, uygulama veri klasöründe %LOCALAPPDATA%\com.feoren.hangar\worktrees\ altında durur. Böylece depolar ve eşitlenen klasörler temiz kalır.
Bir ajan yeni bir worktree’de başladığında önce upstream’de yeni commit olup olmadığına bakar ve onları çekmeden önce sorar. Bunu ayarlarda Terminaller ve ajanlar altından kapatabilirsin.
Bir ekip oturumu bittiğinde Hangar onun worktree'sini yeniden kaldırır; ancak içinde hâlâ değişiklikler ya da derleme çıktısı gibi yok sayılan dosyalar varsa veya başka bir oturum hâlâ onun içinde çalışıyorsa kaldırmaz. Dalda henüz birleştirilmemiş commit'ler varsa dal kalır. Hangar hiçbir şeyi zorlamaz.
Git'in kurulu olması ve klasörün bir Git deposunun içinde olması gerekir. Hangar ağ paylaşımlarında Git çalıştırmaz ve düzenlemelerden önceki denetim WSL içinde geçerli değildir.
Notlar
Notlar bir oturumun projesine veya Genel alanına aittir. Dosya Gezgini'nde de açabileceğin gerçek Markdown dosyalarıdır.
- Ctrl+Shift+N her yerden hızlı bir not başlatır.
- Seçili terminal metnini doğrudan bir nota ya da bir notu bir oturuma gönder. Orada Enter olmadan yapıştırılır, böylece önce kontrol edebilirsin.
- Silinen notlar "Son silinenler" bölümüne gider, oradan onları geri yükleyebilirsin.
- Not panelinin üstünde Özel ile Paylaşılan arasında geçiş yaparsın; böylece kendi notların ekibin notlarından ayrı kalır.
Paylaşılan, şifreli notlar
Bir proje için paylaşılan notları açtığında Hangar onları şifreler ve deponun .hangar\notes\ klasöründe tutar. Commit'lerinle birlikte taşınırlar. Depoya ve koda sahip olan herkes onları okuyabilir. Şifresi çözülmüş metin asla diske yazılmaz ve Hangar asla kendiliğinden commit yapmaz.
Açtığında Hangar bir kez not kurtarma kodu gösterir. Onu güvenle sakla: bu bilgisayar anahtarını kaybederse, kod olmadan notlar kalıcı olarak kaybolur. Kodla notları başka bir klonda da açarsın.
Tüm ajanlar için tek talimat dosyası
HANGAR.md, yapılandırma klasöründe profiles.toml dosyasının yanında durur ve AGENTS.md ya da CLAUDE.md gibi çalışır, yalnızca deponda bir dosya gerekmez. Hangar içeriğini ek talimat kabul eden her ajana iletir: Claude Code, Codex CLI ve Aider. Varsayılan olarak açıktır; şablon boştur ve sen içine yazana kadar hiçbir şey göndermez.
Dosyayı ayarlarda Terminaller ve ajanlar › HANGAR.md’yi aç ile açarsın. “Her ajan için HANGAR.md kullan” seçeneğini de orada açıp kapatırsın. İçine gizli bilgi yazma: metin ajanların komut satırında görünür.
Depolama konumları
Hangar ayarlarını kullanıcı profilinde, Windows'ta %APPDATA% ve %LOCALAPPDATA% içinde tutar. Yalnızca paylaşılan notlar projede durur.
| Konum | İçerik |
|---|---|
%APPDATA%\com.feoren.hangar\profiles.toml | Profillerin |
%APPDATA%\com.feoren.hangar\HANGAR.md | Tüm ajanlar için talimatların |
%APPDATA%\com.feoren.hangar\account.json | Seçilen sunucu ve oturum açtığın sunucular; token yok |
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\ | Açık oturumlar ve geçmişleri, böylece Hangar yeniden başlatmadan sonra onları geri yükler |
%LOCALAPPDATA%\com.feoren.hangar\notes\ | Özel notlar .md dosyaları olarak, proje klasörü başına ve general altında; silinenler .trash içinde |
%LOCALAPPDATA%\com.feoren.hangar\worktrees\ | Oturumlarının worktree'leri |
%LOCALAPPDATA%\com.feoren.hangar\pastes\ | Yapıştırılan ekran görüntüleri; Hangar bunları bir hafta sonra siler |
%LOCALAPPDATA%\Hangar | Programın kendisi |
.hangar\notes\ | Paylaşılan notlar, şifreli, depoda |
| Windows Kimlik Bilgileri Yöneticisi | Gizli profil değişkenleri, oturum açma bilgin ve ekip ile paylaşılan notlar için anahtarlar |
Kendi ekip sunucun
Ekipler için Hangar varsayılan olarak https://hangar.feoren.com/api/v1 adresindeki resmi hizmete bağlanır. Oturum açmadan Ekip penceresi dışında her şey çalışır.
Ekibin kendi Hangar sunucusunu çalıştırıyorsa, adresini Ayarlar içinde Hesap › Sunucu adresi (kendi sunucun) alanına gir ve Uygula'ya tıkla. Boş bırakılırsa yeniden resmi hizmet geçerli olur.
Adres, sunucunun API tabanıdır, örneğin https://team.example.com/api/v1. https:// ile başlamalıdır; Hangar düz http'ye yalnızca localhost, 127.0.0.1 ve [::1] için izin verir. Kullanıcı adı, parola, query ve fragment kullanılamaz. Hangar adresi account.json içinde saklar; başka sunuculardaki oturumlar cihazda kayıtlı kalır.
Böyle bir sunucu resmi hizmetle aynı arayüzü konuşmalıdır: OAuth device flow ile oturum açma, hesap ve projeler, ayrıca ekip verilerini WebSocket üzerinden taşıyan relay için biletler. Protokolün veri türleri ve şifrelemesi uygulama deposunda, MIT lisansı altındaki hangar-team-protocol ve hangar-team-crypto crate'lerinde açıktır.
Ekiple paylaşılan her şey senin cihazında şifrelenir. Sunucu bunları saklar ve iletir ama okuyamaz. Yeni cihazlar ancak biri bir güvenlik numarasını karşılaştırıp onayladıktan sonra katılır.
Mevcut durum: Kendi sunucunda barındırmak için hazır sunucu yazılımı henüz yayımlanmadı. Uygulama kendi adresini zaten kullanabiliyor, ancak burada henüz bir kurulum kılavuzu yok.
Hangar'ı bir şirket için mi planlıyorsun ve kendi sunucuna mı ihtiyacın var? Bize yaz, durumuna bakalım.