init

README.md

@@ -0,0 +1,107 @@
+# ZellIDE
+
+Eine Terminal-basierte IDE-Umgebung gebaut auf Zellij, Helix, Yazi und lazygit.
+
+## Vision
+
+Weg von VSCode, zurück ins Terminal - aber mit modernem Komfort. Eine IDE-Erfahrung die sich anfühlt wie eine richtige IDE, aber komplett im Terminal läuft und keine Electron-Bloat mitbringt.
+
+## Kernideen
+
+### Auto-Detection & Session Management
+
+**Git-basierte Projekterkennung:**
+- Beim `cd` in ein Git-Repository wird automatisch erkannt ob es ein IDE-Projekt ist
+- Session-Namen werden vom Git-Root-Namen abgeleitet
+- Format: `ide:projektname`
+- Eine `.zellij-ide` Datei im Git-Root markiert das Projekt
+
+**Intelligentes Session-Handling:**
+- Beim Betreten eines Projekts: Angebot die IDE zu starten oder zu einer laufenden Session zu attachen
+- Kein Nesting: Wenn bereits in einer Zellij-Session, kein erneuter Prompt
+- Manuelles Attachen jederzeit möglich via Helper-Script
+
+### Session-Naming-Schema
+
+Verschiedene Session-Typen für verschiedene Use-Cases:
+
+**IDE Sessions:** `ide:projektname`
+- Immer für Git-Projekte
+- Name vom Repository-Root abgeleitet
+- Persistente Layout-Konfiguration
+
+**Shell Sessions:** `zsh:fancy-name` oder `zsh:verzeichnisname`
+- Fancy-Names: Zufällige Kombinationen wie "super-koala", "elegant-mammoth"
+- Oder: Aktuelles Verzeichnis als Name
+- Für ad-hoc Terminal-Arbeit
+
+**Custom Sessions:** Offen für weitere Typen
+- Prefix-System ermöglicht Erweiterung
+- z.B. `debug:`, `monitor:`, etc.
+
+### Layout-Struktur
+
+**Haupt-Layout für IDE:**
+```
+┌─────────────┬──────────────────────────┐
+│   yazi      │                          │
+│ (file tree) │       helix              │
+│             │    (main editor)         │
+│             │                          │
+├─────────────┤                          │
+│  lazygit    │                          │
+│             │                          │
+└─────────────┴──────────────────────────┘
+```
+
+**Floating Pane:**
+- Ad-hoc Terminal via Keybind (z.B. Ctrl+t)
+- Für schnelle Befehle ohne Layout zu zerstören
+- Ansible-Playbooks ausführen, docker-compose up, etc.
+
+### Integration & Features
+
+**Helix LSP Support:**
+- YAML (ansible-language-server)
+- Docker Compose
+- TOML/JSON für Configs
+- Bash/Shell Scripts
+- Später: Rust (rust-analyzer)
+
+**Git-Integration:**
+- Inline Git-Gutter in Helix
+- lazygit für visuelle Git-Operationen
+- Beide Tools arbeiten auf dem gleichen Repo
+
+**File Navigation:**
+- yazi als File-Explorer mit Previews
+- Helix fuzzy file finder (Space+f)
+- Buffer-Switcher (Space+b)
+
+## Workflow-Beispiel
+
+1. `cd ~/git/infrastructure`
+2. Prompt: "IDE für 'infrastructure' starten? [y/N]"
+3. Bei 'y': Zellij startet mit IDE-Layout, Session `ide:infrastructure`
+4. Bei 'n': Normale Shell, später `ide-attach` zum Starten
+5. Arbeit in der IDE: yazi für Navigation, helix zum Editieren, lazygit für Commits
+6. Floating Terminal (Ctrl+t) für ansible-playbook Ausführung
+7. Detach jederzeit, Re-Attach von überall im Projekt
+
+## Ziele
+
+- **Komfort:** Fühlt sich an wie eine richtige IDE
+- **Performance:** Kein Electron, native Terminal-Tools
+- **Flexibilität:** Erweiterbar, anpassbar, scriptbar
+- **Konsistenz:** Gleiche Umgebung lokal und auf Remote-Servern
+- **Muscle Memory:** Helix-Keybinds lernen und überall nutzen
+
+## Nächste Schritte
+
+1. Basis-Setup: Zsh-Hooks, Session-Detection
+2. Zellij-Layout definieren
+3. Helix-Konfiguration mit LSP
+4. Helper-Scripts für Session-Management
+5. Testing mit infrastructure-Repo
+6. Migration von tmux auf Servern
+7. Rust-Entwicklungsumgebung aufsetzen