BranchNexus

BranchNexus, birden fazla Git branch'i aynı anda izole worktree'lerde açıp tmux panelleriyle yöneten bir CLI aracıdır.

Özellikler

• Multi-branch worktree - Her branch için izole çalışma alanı
• tmux entegrasyonu - Grid, horizontal, vertical layout desteği
• Cross-platform - Windows (WSL), macOS, Linux
• Oturum yönetimi - Session restore ve cleanup politikaları
• İnteraktif panel - Terminal tabanlı konfigürasyon ve branch seçimi
• GitHub entegrasyonu - Repo tarayıcı ve branch cache desteği
• Preset sistemi - Kayıtlı yapılandırmalar ile hızlı başlatma
• Command hook'ları - Worktree sonrası otomatik komut çalıştırma
• Tema desteği - Kırmızı, yeşil, mavi, sarı, cyan, magenta renk temaları

Kurulum

npm install -g branch-nexus

Veya npx ile doğrudan çalıştırın:

npx branch-nexus init

Hızlı Başlangıç

# İlk kurulum sihirbazı
branchnexus init

# İnteraktif oturum başlat
branchnexus

# Seçeneklerle çalıştır
branchnexus --layout grid --panes 4 --cleanup session

Kullanım

1. Konfigürasyon Paneli

branchnexus komutunu çalıştırdığınızda interaktif konfigürasyon paneli açılır. Repository URL, layout tipi, pane sayısı, cleanup politikası ve renk temasını ayarlayabilirsiniz.

| Tuş | İşlev | |-----|-------| | ↑↓ | Alanlar arası gezinme | | ←→ | Değer değiştirme | | Enter | Düzenleme / Başlat | | P | Preset yükleme | | G | GitHub repo tarayıcı | | Esc | Çıkış |

2. Branch Seçimi

Her pane için ayrı branch seçimi yapabilir, pane ismi verebilir ve başlangıç komutu tanımlayabilirsiniz.

| Tuş | İşlev | |-----|-------| | ↑↓ | Pane'ler arası gezinme | | ←→ | Branch değiştirme | | N | Pane ismi düzenleme | | C | Başlangıç komutu | | Enter | Onayla | | Esc | Geri |

3. tmux Oturumu

Onayladıktan sonra BranchNexus seçilen layout'a göre tmux oturumunu oluşturur. Her pane kendi worktree'sinde ilgili branch'e checkout edilmiş olarak açılır.

CLI Komutları

branchnexus                          # İnteraktif oturum başlat
branchnexus init                     # İlk kurulum sihirbazı
branchnexus kill                     # Aktif session'ı sonlandır
branchnexus attach                   # Detach edilmiş session'a bağlan
branchnexus status                   # Durum bilgisi
branchnexus preset list              # Kayıtlı preset'leri listele
branchnexus preset save <isim>       # Mevcut ayarlardan preset kaydet
branchnexus preset load <isim>       # Preset yükle
branchnexus preset delete <isim>     # Preset sil
branchnexus config show              # Yapılandırmayı göster
branchnexus config set <key> <value> # Değer ayarla
branchnexus config reset             # Varsayılana sıfırla
branchnexus config export            # Config'i JSON olarak dışa aktar
branchnexus config import <dosya>    # Config içe aktar

Seçenekler

| Seçenek | Açıklama | Varsayılan | |---------|----------|------------| | --root <path> | Çalışma dizini | ~/workspace | | --layout <type> | horizontal, vertical, grid | grid | | --panes <n> | Panel sayısı (2-6) | 4 | | --cleanup <policy> | session veya persistent | session | | --session <name> | Session ismi | branchnexus | | --fresh | Temiz başlangıç (restore atla) | - | | --no-hooks | Hook'ları atla | - | | --log-level <level> | DEBUG, INFO, WARN, ERROR | INFO |

Yapılandırma

Config dosyası: ~/.config/branchnexus/config.json

{
  "defaultRoot": "~/workspace",
  "defaultLayout": "grid",
  "defaultPanes": 4,
  "cleanupPolicy": "session",
  "colorTheme": "red",
  "wslDistribution": "Ubuntu-22.04",
  "tmuxAutoInstall": true,
  "sessionRestoreEnabled": true,
  "commandHooks": {
    "post-setup": ["npm install"]
  },
  "presets": {
    "quick": { "layout": "horizontal", "panes": 2, "cleanup": "persistent" }
  }
}

Gereksinimler

• Node.js >= 18.0.0
• tmux >= 2.0
• Git >= 2.17 (worktree desteği)
• WSL (Windows kullanımı için)

Geliştirme

git clone https://github.com/wkaandemir/branch-nexus.git
cd branch-nexus
npm install

npm run build          # Compile
npm run dev            # Watch mode
npm run typecheck      # Type check
npm run lint           # Lint
npm run test           # Test
npm run test:coverage  # Coverage report

Proje Yapısı

ts-src/
├── cli.ts              # Entry point
├── commands/           # CLI komutları (run, kill, attach, status, preset, config)
├── core/               # Orchestrator, config, session, presets
├── git/                # Branch, worktree, clone işlemleri
├── github/             # GitHub API client
├── hooks/              # Command hook runner
├── tmux/               # Bootstrap, layouts, session
├── runtime/            # Platform detection, WSL, shell
├── prompts/            # İnteraktif paneller (panel, branch, GitHub browser)
├── types/              # TypeScript tipleri (Zod schemas)
└── utils/              # Logger, retry, theme, validators

Lisans

MIT © BranchNexus Team