Projekte und Sitzungen

ProjekteLink kopieren

Ein Projekt entspricht einer Aufgabe, meist einem Repository, mit eigenen Terminals, Tabs und Panel-Einstellungen.

Cmd+N erstellt ein Projekt mit einem Terminal. Es startet im Verzeichnis der aktuellen Sitzung oder, wenn keine vorhanden ist, in Ihrem Benutzerordner. Wechseln Sie anschließend mit cd an den gewünschten Ort. Zshell richtet Dateibaum und Git-Panel automatisch auf das Repository aus, das dieses Verzeichnis enthält.

Um sich das cd zu sparen, klicken Sie im Finder mit der rechten Maustaste auf einen Ordner und wählen Dienste → Neues Zshell-Projekt hier. Das neue Projekt startet sein Terminal direkt darin.

Zwischen Projekten wechseln Sie so:

Ein Projekt trägt den Namen seiner ausgewählten Sitzung und folgt damit, wie ein Tab-Titel, dem Terminal. Sein Kontextmenü in der Seitenleiste bietet Umbenennen…, Automatischen Titel verwenden zum Zurücksetzen, Projektverzeichnis festlegen… und Projekt schließen. Beim Schließen werden seine Sitzungen beendet; Dateien auf dem Datenträger bleiben unverändert.

Bei gemeinsamen Remote-Sitzungen trennt das Schließen eines Bereichs oder Projekts nur diesen Client; Shell und Aufgaben laufen auf dem Host weiter.

Gespeicherte SSH-ProjekteLink kopieren

Öffnen Sie die Befehlspalette (Cmd+P) und wählen Sie Neues SSH-Projekt…. Geben Sie Host, optional Benutzer und Port sowie das entfernte Startverzeichnis an. Zur Authentifizierung stehen SSH-Agent, Passwort, Private Schlüsseldatei und Privater Schlüssel als Text zur Wahl. Speichern Sie die Verbindung und wählen Sie Verbinden.

Gespeicherte Verbindungen bleiben nach einem Neustart verfügbar. Über das optionale Feld Gruppe ordnen Sie die Liste; Schaltflächen zum Bearbeiten und Löschen verwalten die Einträge. Passwörter und eingefügte private Schlüssel werden im macOS-Schlüsselbund gespeichert. Bei einer privaten Schlüsseldatei merkt sich Zshell den Pfad zu Ihrer vorhandenen Datei.

Für Befehle oder SSH-Aufrufe mit zusätzlichen Optionen siehe Schnellstart.

Gruppen in der SeitenleisteLink kopieren

Mit Neue Gruppe am unteren Rand der Seitenleiste erstellen Sie eine Einfache Gruppe oder Ordnergruppe…. Einfache Gruppen starten neue Terminals im Benutzerordner, Ordnergruppen verwenden den ausgewählten Ordner. Ein ausdrücklich festgelegtes Projektverzeichnis hat weiterhin Vorrang. Das Verschieben zwischen Gruppen verändert weder laufende Terminals noch das festgelegte Verzeichnis.

Ziehen Sie ein Projekt auf einen Gruppenkopf oder ein anderes Projekt, um es einzuordnen. Ziehen auf + (Neues Projekt) am unteren Rand löst die Gruppenzugehörigkeit. Auch Gruppenköpfe lassen sich durch Ziehen umordnen. Ein Klick klappt die Gruppe ein oder aus, ein Doppelklick benennt sie um; weitere Aktionen stehen im Kontextmenü. Farbmarkierung festlegen… gibt der Gruppe eine Farbe, Farbmarkierung entfernen löscht sie. Gruppe entfernen lässt alle Projekte geöffnet. Ziffernkürzel beziehen sich auf die gerade sichtbaren Projektzeilen. Die Navigation zum nächsten oder vorherigen Projekt kann Mitglieder eingeklappter Gruppen einblenden.

Ordner aus dem Finder können Sie überall in der Projektliste ablegen. Ist ein Ordner bereits geöffnet, wird sein Projekt fokussiert statt ein Duplikat angelegt.

Das ProjektverzeichnisLink kopieren

Dateibaum und Git-Panel müssen wissen, welchen Ordner sie anzeigen sollen. Standardmäßig ermittelt Zshell ihn aus dem aktuellen Terminalverzeichnis und geht bis zum nächsten übergeordneten Git-Repository nach oben.

Darum springt der Dateibaum beim Wechsel mit cd innerhalb eines Repositorys nicht umher: Seine Wurzel bleibt das Repository-Verzeichnis. Außerhalb eines Repositorys folgen die Panels dem Terminalverzeichnis.

Wechselt das Vordergrundprogramm in einen anderen Checkout, etwa wenn ein Agent seinen eigenen Git-Worktree betritt, folgen Dateien, Git und Info diesem Checkout. Kehrt der Vordergrundprozess zurück, folgen die Panels ebenfalls. Ein manuell festgelegtes Projektverzeichnis hat immer Vorrang und deaktiviert diesen automatischen Wechsel.

Zum Festlegen wählen Sie im Projektkontextmenü Projektverzeichnis festlegen…. Der Ordner bleibt nach Neustarts gespeichert. Automatisches Verzeichnis verwenden aktiviert wieder die automatische Auswahl.

SitzungenLink kopieren

Ein Projekt kann beliebig viele Sitzungen enthalten, dargestellt als Tabs am oberen Rand. Jede Sitzung ist eine echte Login-Shell – etwa zsh, fish oder bash, entsprechend Ihrem Benutzerkonto – mit eigenem Arbeitsverzeichnis und Ausgabeverlauf.

Eine neue lokale Sitzung beginnt zuerst im festgelegten Projektverzeichnis, andernfalls im Standardverzeichnis ihrer Seitenleistengruppe. Fehlt beides, übernimmt sie das Verzeichnis der aktuellen Sitzung und verwendet ersatzweise den Benutzerordner.

Tab-GruppenLink kopieren

Klicken Sie mit der rechten Maustaste auf einen Tab und wählen Sie In Gruppe verschieben → Neue Tab-Gruppe. Der Tab gehört dann zur neuen Gruppe, die als farbiger Pfeil ohne Namen erscheint. Neue Sitzungen aus einem gruppierten Tab bleiben in derselben Gruppe. Über Neue Sitzung in Gruppe im Kontextmenü des Gruppenpfeils erstellen Sie direkt darin eine Sitzung.

Ziehen Sie einen Tab auf einen Gruppenpfeil oder anderen Tab, um ihn zu verschieben. Im Kontextmenü stehen außerdem die Gruppen und Aus Gruppe entfernen. Ein Klick auf den Pfeil klappt die Gruppe ein oder aus. Beim Einklappen bleibt das aktive Terminal sichtbar und läuft weiter; der Wechsel zu einem verborgenen Mitglied klappt die Gruppe auf. Das Entfernen einer Gruppe lässt ihre Tabs und Sitzungen geöffnet. Wird ein gruppierter Tab angeheftet, wechselt er in den festen Bereich außerhalb der Gruppen. Das Kontextmenü des Gruppenpfeils bietet Farbmarkierung festlegen… und Farbmarkierung entfernen. Farben und eingeklappter Zustand werden beim nächsten Start wiederhergestellt.

Ein Tab lässt sich auch auf ein Projekt in der Seitenleiste ziehen oder auf einen Gruppenkopf, um darin ein neues Projekt zu erstellen. Ablegen auf + (Neues Projekt) erstellt ein Projekt außerhalb aller Seitenleistengruppen. Tab in Projekt verschieben im Tab-Menü erreicht auch Projekte anderer Fenster. Laufende Terminals und Bereichsanordnung bleiben dabei erhalten. Die Projekte müssen denselben lokalen oder SSH-Ort haben; ein aus einem Tab erstelltes Projekt übernimmt dessen Herkunftsort. Tabs mit Diffs bleiben in ihrem bisherigen Projekt.

Tab-TitelLink kopieren

Tab-Titel stammen aus den Meldungen des Terminals: aus der Escape-Sequenz Ihres Shell-Prompts oder vom laufenden Programm. Im Kontextmenü können Sie mit Umbenennen… einen eigenen Titel setzen und mit Automatischen Titel verwenden wieder dem Terminal folgen.

Weitere Einträge sind Schließen, Andere schließen, Tabs rechts schließen, Alle schließen sowie Im Finder zeigen und Absoluten Pfad kopieren für das Sitzungsverzeichnis. Dateien schließen und Diffs schließen entfernen diese Inhalte im gesamten Projekt; Terminals und Browserbereiche bleiben offen.

FensterLink kopieren

Cmd+Shift+N öffnet ein weiteres Fenster. Jedes Fenster hat unabhängige Projekte und Seitenleisteneinstellungen und wird separat wiederhergestellt.

Was nach einem Neustart erhalten bleibtLink kopieren

Zshell speichert während der Arbeit regelmäßig die Anordnung. Nach dem Beenden und erneuten Öffnen erhalten Sie zurück:

• alle Projekte in ihrer Reihenfolge;
• alle Tabs einschließlich eigener Namen, Anheftungen und Farbmarkierungen;
• Seitenleistengruppen mit Namen, Farben, Reihenfolge, Mitgliedern und eingeklapptem Zustand;
• Tab-Gruppen mit Farben, Reihenfolge, Mitgliedern und eingeklapptem Zustand;
• festgelegte Projektverzeichnisse und leere Projekte;
• die Bereichsanordnung jedes Tabs;
• die geöffneten Seitenleisten und das ausgewählte rechte Panel.

Ist das ursprüngliche PTY nicht verfügbar und sind Agentengespräche fortsetzen sowie die KI-Unterstützung aktiv, setzt Zshell das bestätigte Gespräch mit Claude Code, Codex, Pi oder OpenCode fort. Andere Bereiche öffnen neue Shells im bisherigen Verzeichnis. Das Gespräch behält seine Identität; ein laufender Build wird nicht durch erneutes Ausführen von Befehlen wiederhergestellt.

Die bisherige Ausgabe wird bei aktiviertem terminal.restore-history wiederhergestellt. Neue Konfigurationen aktivieren dies standardmäßig; der Verlauf wird auf dem Datenträger gespeichert.

Terminalumgebung und InitialisierungLink kopieren

Wählen Sie ein Projekt und dann Terminal → Terminalumgebung des Projekts…, um Umgebungsvariablen und einen Initialisierungsbefehl festzulegen. Mit Terminal → Terminalumgebung des Tabs… setzen Sie abweichende Werte für den aktuellen Tab.

Änderungen betreffen nur Terminals, die nach dem Speichern erstellt werden. Laufende Prozesse behalten ihre Umgebung. Die Initialisierung läuft für die normale Login-Shell, nicht für ein eigenes Startprogramm oder explizite argv-Argumente. ZSHELL_*, TERM, COLORTERM, TERM_PROGRAM und TERM_PROGRAM_VERSION werden von Zshell verwaltet und können nicht überschrieben werden.