diff --git a/README.md b/README.md
index b47b5cf..9a3aad6 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,8 @@ Wird automatisch von [macbook-setup](https://git.motocamp.de/rene/macbook-setup)
 ## Inhalt
 
 ```
-bin/                  Git-Werkzeuge (werden nach ~/ verlinkt)
+bin/                  Skripte (gitcheck, gitsync, gitupdate, toolbox)
+zsh/                  .zshrc mit Aliases, Cheatsheet, Tool-Integrationen
 micro/                Micro-Editor Konfiguration
 nvim/                 Neovim Konfiguration
 oh-my-zsh/custom/     Powerlevel10k, zsh-syntax-highlighting
@@ -39,6 +40,7 @@ Die Repo-Liste ist im Skript hinterlegt. Bei neuen Repos dort einen Eintrag erga
 ### gitcheck - Repository-Status pruefen
 
 Zeigt den Status aller Repositories (lokale Aenderungen, ungepushte/ungepullte Commits).
+Bietet am Ende an, ein dirty Repo direkt in **lazygit** zu öffnen.
 
 ```bash
 gitcheck             # nur Repos mit Aenderungen
@@ -54,6 +56,20 @@ Pullt alle Repositories (ueberspringt Repos mit lokalen Aenderungen).
 gitupdate            # alle Repos pullen
 ```
 
+### toolbox - interaktiver Tool-Launcher
+
+Startet eine fzf-basierte Auswahl aller installierten Tools mit Kategorien und Kurzbeschreibungen.
+TUI-Tools (lazygit, btop, yazi…) öffnen in einem neuen Terminal-Tab, Output-Tools laufen direkt inline.
+Funktioniert auf macOS (iTerm2) und Linux (xfce4-terminal, gnome-terminal, kitty, alacritty).
+
+```bash
+tools                # interaktiver Launcher
+tools-ref            # statisches Cheatsheet (Kurzform: tr)
+```
+
+Mac-only Tools (z.B. `temps`) werden auf Linux automatisch ausgeblendet.
+Linux-Binaries (`batcat`, `fdfind`) werden automatisch aufgelöst.
+
 ### cb - Clipboard bereinigen
 
 Entfernt die 2 fuehrenden Leerzeichen pro Zeile aus der Zwischenablage, die Claude Code bei der Terminal-Ausgabe einfuegt. Nuetzlich beim Kopieren mehrzeiliger Befehle oder Codeblocks.
@@ -64,29 +80,46 @@ cb    # Zwischenablage bereinigen, dann mit Cmd+V einfuegen
 
 Verwendet `pbpaste`/`pbcopy` auf macOS und `xclip` auf Linux.
 
+## Terminal-Tools (installiert & konfiguriert)
+
+| Tool | Zweck | Alias |
+|------|-------|-------|
+| **lazygit** | Git TUI: stagen, committen, rebasen | `lg` |
+| **delta** | Schöne Git-Diffs (side-by-side, automatisch aktiv) | — |
+| **atuin** | Fuzzy History-Suche mit Zeitstempel | `Ctrl+R` |
+| **mise** | Tool-Versionen pro Projekt verwalten | `mise use` |
+| **btop** | Systemmonitor (CPU/RAM/Netz/Prozesse) | `btop` |
+| **yazi** | Terminal-Dateimanager | `yazi` |
+| **bat** | cat mit Syntax-Highlighting | `bat` |
+| **eza** | Modernes ls | `eza -la`, `eza -T` |
+| **fzf** | Fuzzy-Finder | `Ctrl+T`, `Ctrl+R` |
+| **zoxide** | Smart cd (lernt häufige Pfade) | `z` |
+| **nmap** | Netzwerk-Scanner | `nmap` |
+| **units** | Einheitenumrechnung | `units` |
+| **cmatrix** | Matrix-Screensaver | `cmatrix` |
+| **asciiquarium** | Aquarium-Screensaver | `asciiquarium` |
+| **pipes.sh** | Rohre-Screensaver | `pipes.sh` |
+| **cbonsai** | Bonsai-Screensaver | `cbonsai` |
+| **nms** | Sneakers-Entschlüsselungseffekt | `ls \| nms` |
+
+Screensaver rotieren automatisch nach 5 Minuten Idle.
+
 ## Installation
 
 ### Automatisch (via macbook-setup)
 
 `setup-desktop.sh` klont dieses Repo und verlinkt alles automatisch.
 
-### Manuell (bestehender Mac)
+### Manuell (bestehender Mac/Linux)
 
 ```bash
 git clone https://git.motocamp.de/rene/dotfiles-rene.git ~/git-projekte/dotfiles-rene
 
-# Skripte verlinken
-for script in ~/git-projekte/dotfiles-rene/bin/*; do
-    chmod +x "$script" && ln -sf "$script" ~/
-done
+# zshrc installieren
+cd ~/git-projekte/dotfiles-rene/zsh && bash install-zsh-dotfiles.sh
 
-# Aliases in ~/.zshrc
-alias gitcheck="~/git-check-all.sh --short"
-alias gitupdate="~/git-update-all.sh"
-alias cb="pbpaste | sed 's/^  //' | pbcopy"  # macOS
-alias cb="xclip -selection clipboard -o | sed 's/^  //' | xclip -selection clipboard -i"  # Linux
-alias gitsync="~/git-sync-all.sh"
-alias mac-sync="curl -fsSL https://git.motocamp.de/rene/dotfiles-rene/raw/branch/main/bin/git-sync-all.sh | bash"
+# toolbox in den PATH legen
+ln -sf ~/git-projekte/dotfiles-rene/bin/toolbox ~/bin/toolbox
 ```
 
 ## Offline-KI einrichten (neuer Mac)