Çalışma alanları ve worktree'ler
Nethür her göreve nasıl kendi git worktree'sini veya klasör çalışma alanını verir.
Nethür çalışma alanı önceliklidir. Tek bir kopyada dal açıp stash'lemek yerine her görev, deponun kendi disk üzerindeki kopyasını git worktree ile veya proje bir git deposu değilse bir klasör çalışma alanı olarak alır. Paralel ajanları güvenli kılan budur — birbirlerinin dosyalarına asla basmazlar.
Model
- Her deponun bir temel refi vardır (genellikle
origin/main). - Her çalışma alanının bir başlangıç refi vardır — neyden dallandığı.
- Her çalışma alanının kendi dalı, diskteki kendi dosyaları ve kendi ajan terminalleri vardır.
- Bir çalışma alanını silmek hem dizini hem dalı kaldırır (onayla). Git, birleştirilmemiş commit'ler içerebileceği için yerel bir dalı tutarsa Nethür bir inceleme adımı sunabilir — bkz. Korunan dallar.
Özellik başına yaşam döngüsü
- Oluştur — görev adı, başlangıç seçici, isteğe bağlı GitHub / Linear / Jira / GitLab bağlantısı.
- Çalış — ajan terminalleri, editör sekmeleri, tarayıcı sekmeleri, terminal panelleri bu çalışma alanına kapsamlı.
- İncele — başlangıç ref'ine karşı diff görünümü, AI diff'ini işaretle, atıf.
- Gönder — commit, push, PR aç, kontrolleri bekle — hepsi satır içi.
- Arşivle veya sil — tek tık çalışma alanını ve dalı kaldırır.
Oluşturma arka planda çalışır
Çalışma Alanı Oluştur iletişim kutusunu göndermek onu hemen kapatır — git fetch ve git worktree add işi siz Nethür'ü kullanmaya devam ederken arka planda sürer. Yeni çalışma alanı kenar çubuğunda bir ilerleme satırıyla görünür ve çalışma alanının sekmesi kopya bitip terminale geçene kadar canlı kurulum durumu gösterir. Oluşturma sürerken diğer çalışma alanlarına geçebilir, ilerlemeyi izleyebilir veya sekme içi panelden iptal edebilirsiniz. Oluşturma başarısız olursa panel hatayı Yeniden dene ile gösterir.
Başlangıç seçici
Çalışma alanı oluştururken neyden dallanacağınızı seçersiniz. Bu şunlardan biri olabilir:
- Deponun temel ref'i (hızlı yol).
- Başka bir yerel dal — incelemedeki bir PR'ın üstüne iş yığmak için kullanışlıdır.
- Belirli bir commit SHA'sı.
- Mevcut bir uzak dal — Nethür getirir ve check-out eder.
Paylaşılan dizinler ve gitignore'lanmış dosyalar
Yepyeni bir çalışma alanı temiz bir kopyadır. Gitignore'lanmış yollarda yaşayan bağımlılıklar, önbellekler ve yerel sırlar siz yeniden oluşturana kadar eksiktir.
Nethür bu boşluğu üç tamamlayıcı yolla doldurur:
- Worktree paylaşılan yolları (depo başına, Ayarlar → Depo) — yollar birincil kopyadan her yeni çalışma alanına taşınır (macOS'ta mümkün olduğunda APFS klon kopyası, aksi halde sembolik bağlantı).
nethur.yamliçindekiworktree.sharedDirectories— bağlantıyla paylaşılacak gitignore'lanmış dizinlerin depoya işlenmiş listesi (APFS dahil).node_modulesveya.cachegibi büyük, yeniden derlenebilir ağaçlar için kullanın. Girişler birincil kopyada dizin olarak var ve gitignore'lanmış olmalıdır; izlenen veya eksik yollar atlanır.- Depo kökündeki
.worktreeinclude— her yeni çalışma alanına kopyalanacak (sembolik bağlantı değil) gitignore'lanmış dosya veya dizinlerin listesi; böylece her çalışma alanı kendi kopyasına sahip olur. Tipik girişler:.env,.vscode/altındaki yerel yapılandırma. Boş satırlar ve#yorumlarına izin verilir. Bugün yalnızca değişmez yollar desteklenir — glob'lar ve olumsuzlama bir uyarıyla atlanır. İzlenen, eksik veya gitignore'lanmamış yollar kopyalanmaz.
nethur.yaml paylaşılan dizinleri kullanıcı başına Worktree paylaşılan yolları listesine eklenir; onun yerini asla almaz. Zaten paylaşılan/bağlanan yollar .worktreeinclude'dan yeniden kopyalanmaz.
Kurulum betikleri, varsayılan sekmeler, komut seçimi, yol kuralları, limitler ve her ayarı hangi kopyanın sağladığı için nethur.yaml ve .worktreeinclude referansı sayfasına bakın.
# nethur.yaml (depo kökü)
worktree:
sharedDirectories:
- node_modules
- .cache# .worktreeinclude (depo kökü)
.env
.env.local
.vscode/settings.jsonOluşturma iletişim kutusu: Proje, Şurada çalıştır, ajan ve görev bağlantıları
Çalışma Alanı Oluştur iletişim kutusu Proje ve Şurada çalıştır için önceden yazmalı açılır listeler kullanır:
- Filtrelemek için yazın; Enter hazır satırı onaylar.
- Proje her zaman Yeni proje ekle'yi altta sabit tutar — kurulumda henüz proje yoksa oluşturma çıkmaza girmez.
- Şurada çalıştır, hazır hostları ve tarifleri, ayrıca o makinede hâlâ proje kurulumu gereken hostları listeler. Kurulum gereken bir hostta oluşturma formundan çıkmadan Proje konumunu ayarla seçin, sonra mevcut bir kopyaya/klasöre göz atın veya Git deposunu o hosta klonlayın. Nethür yeni hazır konumu seçer; böylece çalışma alanını oluşturmaya devam edebilirsiniz. Bağlantısı kesilmiş SSH / uzak hostlar çalıştırma hedefi olarak seçilmeden Bağlan sunabilir. Host ekle, SSH veya Uzak Nethür Sunucusu hedefleri için sabit kalır.
- Ajan seçici (daraltılmış veya genişletilmiş) oluşturmada seçtiğiniz ajan için, Boş Terminal dahil, Varsayılan olarak ayarla yapabilir.
- Ad alanından bir GitHub PR, Linear sorunu, GitLab MR veya Jira sorunu bağlayın (bir Jira URL'si yapıştırın veya Jira modunda arayın). Bağlı sorunlar çalışma alanı kartında görünür. Bkz. Jira öğeleri paneli.
Bkz. Nethür'ü çalıştırma yolları.
Emoji çalışma alanı adları
Çalışma alanı adı alanında Slack tarzı kısa kodlar (:rocket:) yazabilir ve bir kısa kod öneri açılır penceresinden seçebilirsiniz. Aynı seçici bir çalışma alanını yeniden adlandırmak için çift tıkladığınızda, Çalışma alanı ayrıntılarını düzenle'de düzenlediğinizde veya Worktree geçiş paletinde (Cmd-J) kısa kod yazdığınızda da çalışır. Görünen ad emojiyi korur; Nethür bir git dal adı türettiğinde bilinen emojiyi okunabilir kısa kodlara çevirir (örneğin 🚀 → rocket). Geçiş paleti araması emoji adlı çalışma alanlarını o kısa koddan türetilen parçayla eşleştirir.
Dalı adlandırma
Varsayılan olarak Nethür yeni çalışma alanının dal adını yazdığınız çalışma alanı adından veya çalışma alanı bunlardan biriyle oluşturulduysa bağlı GitHub PR, Linear/Jira sorunu ya da GitLab MR'ından türetir. Bunun yerine açık bir dal adı ayarlamak için Çalışma Alanı Oluştur iletişim kutusundaki Gelişmiş çekmecesini genişletin ve Dal adı alanına yazın (yer tutucu feature/my-branch).
Aynı çekmece, yeni çalışma alanının Üst çalışma alanı olarak aynı depodan etkin bir çalışma alanı seçmenizi sağlar. Bu yalnızca çalışma alanlarını Nethür'ün kenar çubuğunda iç içe yerleştirir; Git geçmişini veya dallarını değiştirmez. Nethür arşivlenmiş çalışma alanlarını ve döngü oluşturacak seçimleri hariç tutar.
Bir Linear sorunundan oluşturduğunuzda Nethür, yalnızca sorun başlığını slug'lamak yerine o sorun için Linear'ın kendi dal adını (Linear bir tane sağladığında) dal geçersiz kılması olarak kullanır — Linear'ın arayüzünde önereceği aynı ad.
Dal adı alanı yalnızca yazılan bir çalışma alanı adından veya temel daldan oluştururken sunulur. Çalışma alanı izlenen bir iş öğesine bağlıysa dal o öğeden türetilir — bağlı bir GitHub PR gönderimde dalı yeniden çözümler bile — bu yüzden Nethür sessizce yok sayılan bir geçersiz kılmayı önlemek için alanı gizler.
Kenar çubuğu düzeni
Kenar çubuğu çalışma alanlarını varsayılan olarak projeye göre gruplar — üst düzey satırlar projelerdir (bir proje = bir git deposu veya ilgili bir küme) ve üzerinde etkin çalıştığınız çalışma alanlarına genişler. Başlığın kendi filtre girişi vardır (genel aramadan ayrı); böylece kenar çubuğundan çıkmadan listeyi daraltabilirsiniz.
Kenar çubuğu başlık filtre menüsü host ve proje kapsamını ortak bir Göster bölümü altında gruplar (Hostlar ve projeler için alt menü satırları), sonra gizleme anahtarları:
- Uyuyan çalışma alanları — her projenin giriş noktası / ana çalışma alanı bu filtre altında görünür kalır; böylece o kopya boştayken proje satırı kaybolmaz
- Varsayılan dal hariç (yalnızca Uyuyanları gizle açıkken) — uyuyan taraması sırasında varsayılan dallı çalışma alanlarını görünür tutar; uyuyan çalışma alanları zaten gösteriliyorsa alt seçenek gizlenir
- Varsayılan dal çalışma alanları (ana kopya satırı)
- Otomasyon tarafından oluşturulan çalışma alanları
- CLI tarafından oluşturulan çalışma alanları —
nethur worktree createile oluşturulanlar (Nethür CLI kaynak ayrıntısı için kartın üzerine gelin) - Diğer istemci çalışma alanları — paylaşılan bir Uzak Nethür Sunucusunda başka bir eşleştirilmiş istemciden oluşturulmuş çalışma alanları olduğunda Diğer istemci çalışma alanlarını gizle görünür; bu cihazın listesini burada oluşturduğunuz çalışma alanlarında tutmak için açın. Boş
Cmd-Json öğeleri ve sayı kısayolları aynı filtreyi izler; bir sorgu yazmak gizli satırları yine bulur. - Ayrık HEAD çalışma alanları — dal yerine bir commit üzerinde duran kopyalar
Etkin filtre sayısı filtre kontrolünde görünür; Temizle yalnızca açık filtreleri sıfırlar. Metin araması ve Worktree geçiş paleti (Cmd-J), bir sorgu yazdığınızda yalnızca gizleme anahtarlarıyla gizlenen çalışma alanlarına da ulaşır. Cmd-J açıldığında kenar çubuğunun host ve proje kapsamını korur; geçici host ve tek depo filtrelerini ayarlamak için Tab tuşlayın.
Birden fazla Git deposu içeren bir üst klasör eklediğinizde Nethür seçili depoları ayrı ayrı içe aktarabilir veya tek bir proje grubu altında gruplayabilir.
Kenar çubuğunun üstündeki bir Ara düğmesi Worktree geçiş paletini (Cmd-J) açar — aynı yüzey, gezinme için klavyeye yaslanmayan kullanıcılar için tıklamayla. Durum çubuğu ajan etkinliğini satır içi gösterir; okunmamış çalışma alanları rozetlenmek yerine kalın yazılır.
Uzun süren işi görünümde tutmak için bir çalışma alanını projesinin en üstüne sabitleyebilirsiniz; bir çalışma alanına sağ tıklamak arşivle / uyut / sil eylemlerini açar. Silmeyi klavyeden başlatmak için bir çalışma alanının veya klasör çalışma alanının üzerine gelin ve macOS'ta Cmd-Shift-Backspace, Windows / Linux'ta Ctrl-Shift-Backspace tuşlayın; normal onay iletişim kutusu yine görünür. Çalışma alanlarını çoklu seçime eklemek için tıklarken Cmd (Linux/Windows'ta Ctrl) basılı tutun veya bitişik bir aralık seçmek için Shift basılı tutun — seçili herhangi bir çalışma alanına sağ tıklamak eylemi seçimdeki her çalışma alanına uygular. Depo satırları sürükleyerek yeniden sıralanabilir.
Bir çalışma alanının iç içe alt çalışma alanları varsa (örneğin orkestrasyondan veya üst öğeli worktree create ile), bağlam menüsü Alt çalışma alanlarıyla uyut (N) ve Alt çalışma alanlarıyla sil… de sunabilir. Alt çalışma alanlarıyla uyut, seçili çalışma alanında ve aynı proje, depo ve hosttaki her doğrulanmış iç içe alt çalışma alanında etkin panelleri kapatır — yalnızca canlı terminali veya tarayıcı sekmesi olan çalışma alanları uyku için hedeflenir. Alt çalışma alanlarıyla sil, mevcut basamaklı silmeyi açık hale getirir. Bayat soy bağlantıları, döngüler ve host veya depo sınırları arasındaki alt öğeler hariç tutulur.
Bir üst çalışma alanı iç içe alt öğelerini bir N alt öğe çipi altında gösterir; göstermek veya gizlemek için çipe tıklayın. Aynısını klavyeden yapmak için Ayarlar → Kısayollar altında Alt çalışma alanlarını aç/kapat atayın. İşaretçinin altındaki çalışma alanında veya hiçbir şeyin üzerinde değilken etkin çalışma alanında çalışır ve o kartın çipinin yaptığını yapar. Kendi çipi olmayan bir kartta (alt öğesi yok veya bir kenar çubuğu filtresi hepsini gizliyor) kartın üst öğesindeki çipi kullanır; o da yoksa hiçbir şey yapmaz.
Yeniden adlandırmak için kenar çubuğundaki bir çalışma alanı başlığına çift tıklayın. Kartın başka bir yerine çift tıklamak yine tam düzenleme iletişim kutusunu açar. Çalışma alanı ayrıntılarını düzenle'de sorun alanı GitHub veya Linear kabul eder (alan üzerindeki çip; otomatik algılamak için bir URL yapıştırın). Çalışma alanı başına tek bağlı sorun — sağlayıcıyı değiştirmek veya alanı temizlemek öncekini bağlantısız bırakır. Hostu bağlantısı kesilmiş SSH çalışma alanları için kart başlığı satırı satır içi bir yeniden bağlan kontrolü gösterebilir (bkz. SSH worktree'leri).
Kaynak Yöneticisi temizliği
Kaldırmadan önce kurulumunuzdaki çalışma alanlarını incelemek istediğinizde Kaynak Yöneticisi → Çalışma alanlarını temizle kullanın. Liste yerel çalışma alanlarını, ana çalışma alanlarını, klasör çalışma alanlarını ve bağlantısı kesilmiş SSH hostlarındaki çalışma alanlarını içerir. Kaldırmak için bir şey seçmeden önce her çalışma alanının durumunu, son etkinliğini, boyutunu, Git durumunu ve bağlı incelemesini incelemek için listeyi arayın, filtreleyin veya sıralayın.
Korunan dallar
Çalışma alanlarını toplu silmek (kenar çubuğu çoklu seçim veya Kaynak Yöneticisi temizliği) diskteki klasörleri yine kaldırır. Git, birleştirilmemiş commit'ler içerebileceği için yerel bir dalı bırakmayı reddederse Nethür o dalları korur ve N dalı incele gibi bir bildirim gösterir. Açmak korunan dalları listeler; bazılarını zorla silebilir, bazılarını bırakabilirsiniz. Seçilmeyen dallar depoda kalır; çalışma alanı klasörleri geri yüklenmez.
Çok depolu proje grupları ve klasör çalışma alanları
Birkaç Git deposu içeren bir üst klasörü içe aktardığınızda Nethür o depoları kenar çubuğunda tek bir proje grubu altında gruplayabilir. Her proje grubu bir klasör çalışma alanı akışı sunar — üst klasör düzeyinde yaşayan ve görev kaynağını altındaki depolardan birine bağlayan worktree benzeri bir giriş; böylece bir özelliğin GitHub/GitLab/Linear/Jira görev yüzeyi, çalışma alanı kenar çubuğunda kardeşleriyle gruplanmış olsa bile doğru depoya bağlı kalır.
Bir tane oluşturmak için kenar çubuğunda proje grubunun başlık satırının üzerine gelin ve + eylemine tıklayın (ipucu: "grup için çalışma alanı oluştur"). Oluşturma iletişim kutusu ("Klasör Çalışma Alanı Oluştur") çalışma alanının görev kaynağı için kaynak projeyi seçmenizi, çalışma alanını adlandırmanızı ve isteğe bağlı olarak bağlı bir sorun veya PR eklemenizi ister. Gönderin; klasör çalışma alanı proje grubu altında normal depo kapsamlı worktree'lerin yanında görünür.
Bir proje grubunu silerken Nethür, grubun içerdiği projeleri (altındaki depo kayıtlarını) aynı eylemde kaldırmak için bir onay kutusu da sunar — böylece artık kullanılmayan bir kümenin temizliği birkaç onay değil tek onaydır.
Düz git kullanma
Her Nethür çalışma alanı gerçek bir git worktree'sidir. İçinde bir terminal açıp git status, git rebase, git cherry-pick ve başka her şeyi kullanabilirsiniz — Nethür değişiklikleri sonraki oluşturmada alır.
git worktree add ile kendiniz oluşturduğunuz çalışma alanları, Nethür'de gösterene kadar harici kalır. Bir depo onları gizlerse kenar çubuğu bir gizli worktree'ler kartı gösterir. Nethür dışı worktree'ler'i açmak için tıklayın, sonra kenar çubuğunda istediğiniz worktree'ler için Göster'i seçin.
Ayarlar → Genel → Çalışma alanı altında harici worktree kaynakları için genel varsayılanları ayarlayın: Claude Code worktree'leri, GSD worktree'leri, diğer konumlar ve eklediğiniz özel mutlak yol konumları. Bu varsayılanlar o hosttaki mevcut ve gelecekteki worktree'lere uygulanır; yeni genel özel kökler gizli başlar. Bir projenin Nethür dışı worktree'ler iletişim kutusunda o proje için bir kaynağı geçersiz kılabilir veya genel ayara döndürebilir, sonra tek tek gizli worktree'leri arayıp kurtarabilirsiniz.