Konfiguration

Die meisten dauerhaften Einstellungen stehen in einer Datei:

~/.config/zshell/config.toml

Das Einstellungsfenster (Cmd+,) schreibt dieselbe Datei. Einige von macOS verwaltete Einstellungen, etwa Sprache und automatische Updates, werden anderswo gespeichert. Sie stehen am Ende dieser Seite.

Neue Konfigurationen aktivieren Vim-Befehlshinweise, die Wiederherstellung des Sitzungsverlaufs und Mitteilungen bei fehlgeschlagenen Befehlen. Automatische Update-Downloads sind ebenfalls standardmäßig aktiviert. Bestehende Konfigurationen und gespeicherte Entscheidungen bleiben erhalten.

Verhalten der DateiLink kopieren

Vor dem manuellen Bearbeiten sollten Sie Folgendes wissen:

• Änderungen werden im laufenden Betrieb gelesen. Gültige externe Änderungen gelten automatisch; Einstellungen für neue Terminals benötigen weiterhin einen neuen Bereich. Unlesbare oder fehlerhafte Dateien lassen die letzten gültigen Einstellungen bestehen. Eine bewusst leere Datei stellt nach kurzer Verzögerung die Standardwerte wieder her.
• Zshell schreibt die Datei bei jeder darin gespeicherten Einstellungsänderung neu. Dabei gehen Kommentare und unbekannte Schlüssel verloren. Bearbeiten Sie sie möglichst auf nur einem Weg oder halten Sie eine maßgebliche Kopie in Ihren Dotfiles vor.
• Die meisten Standardwerte werden weggelassen. font-size, terminal.vim-command-hints, terminal.restore-history, terminal.notify-on-error werden immer gespeichert. Das Entfernen eines dieser drei Terminalschlüssel in einer vorhandenen Datei deaktiviert die Funktion; bei anderen Schlüsseln wird der Standard wiederhergestellt.
• Der Parser ist bewusst klein. Er unterstützt einfache und punktgetrennte Schlüssel, [table]-Kopfzeilen, #-Kommentare sowie Zeichenketten, Zahlen und boolesche Werte. Arrays, Inline-Tabellen und mehrzeilige Zeichenketten werden nicht unterstützt.
• Ungültige Werte verwenden sichere Ersatzwerte. Eine Größe außerhalb des Bereichs, ein unbekanntes Backend oder ein falsch geschriebener Themenname verhindert den Start nicht.

Beim Speichern bleiben symbolische Datei- und Verzeichnislinks erhalten; ihr Ziel wird atomar und mit unveränderten Rechten aktualisiert. Externe Änderungen schreiben Kommentare und unbekannte Schlüssel nicht neu. Späteres Speichern in Einstellungen erzeugt die Datei weiterhin wie oben beschrieben neu.

AnwendungspräsenzLink kopieren

app-presenceLink kopieren

"dock" · "dock-and-menu-bar" · "menu-bar" — Standard "dock"

Unter Einstellungen → Allgemein → Zshell anzeigen in wird die Änderung sofort wirksam. "dock" zeigt nur das Dock-Symbol, "dock-and-menu-bar" beide Symbole und "menu-bar" nur das Menüleistensymbol.

Die Menüleiste öffnet den aktuellen Arbeitsbereich, das Schnellterminal, Einstellungen und die Updateprüfung. In beiden Menüleistenmodi wird das letzte Arbeitsbereichsfenster beim Schließen ausgeblendet, während Terminals und Aufgaben weiterlaufen. Arbeitsbereich öffnen kehrt zum selben Fenster, Projekt und zur selben Sitzung zurück. Das Schließen anderer Fenster, Bereiche oder Projekte beendet weiterhin deren Aufgaben. Beenden folgt terminal.preserve-sessions; Beenden und alle Sitzungen schließen beendet sie. Der Modus bleibt nach einem Neustart erhalten.

ErscheinungsbildLink kopieren

themeLink kopieren

"system" · "light" · "dark" – Standard: "system"

Bestimmt das Erscheinungsbild. "system" folgt macOS; die anderen Werte legen Zshell auf hell oder dunkel fest.

theme-dark und theme-lightLink kopieren

Zeichenkette – Standard: "Default Dark" und "Default Light"

Das Farbthema für jedes Erscheinungsbild. Ein Thema färbt Terminalbereiche, Fensterrahmen, Seitenleisten, Editor und Diffs gemeinsam ein. Die eingebauten Standardthemen erhalten die durchscheinende Seitenleiste; andere Themen verwenden dort ihre eigene Palette.

Die Einstellungen zeigen den für beide Terminal-Backends gemeinsamen Themenkatalog. Ein manuell eingetragener Name muss einschließlich Groß- und Kleinschreibung genau einem Anzeigenamen entsprechen. Andernfalls verwendet Zshell das jeweilige Standardthema.

toolbar.visibilityLink kopieren

"hide" · "auto" · "always" – Standard: "hide"

Steuert die kompakte Werkzeugleiste unter dem aktiven Tab:

• "hide" blendet sie aus.
• "auto" zeigt sie nur, wenn das Projektverzeichnis ein Git-Repository ist.
• "always" lässt den Zugang zum Git-Panel in jedem Projekt sichtbar, einschließlich des Zustands Kein Git-Repository.

Ihre Inhalte beschreibt Die Git-Werkzeugleiste.

TextLink kopieren

font-familyLink kopieren

Zeichenkette – Standard: "", die mitgelieferte JetBrains Mono

Terminal, Editor und Diff-Ansicht teilen diese lateinische Schriftfamilie. Geben Sie eine Familie an, etwa "IBM Plex Mono", keinen einzelnen Schnitt wie "IBM Plex Mono Regular". Unbekannte oder nicht dicktengleiche Familien fallen auf den mitgelieferten Standard zurück.

Im Terminal werden zuerst die lateinische Familie, dann die optionale CJK-Ersatzschrift, danach die mitgelieferte Symbols Nerd Font und schließlich die Systemersatzschrift des Backends verwendet. Editor und Diff-Ansicht behalten ihren normalen macOS-/WebKit-Fallback.

terminal.font-fallback-familyLink kopieren

Zeichenkette – Standard: "", der Fallback des Backends oder Systems

Fügt eine installierte CJK-Schriftfamilie zur geordneten Ersatzschriftkette des Terminals hinzu. Die Auswahl enthält Familien mit repräsentativen chinesischen, japanischen oder koreanischen Zeichen. Sie müssen nicht streng dicktengleich sein, da sie nur fehlende Zeichen der primären lateinischen Schrift ergänzen.

font-sizeLink kopieren

Zahl, 8–32 – Standard: 13

Gemeinsame Schriftgröße von Terminal, Editor und Diff in Punkten. Dieser Schlüssel wird auch mit seinem Standardwert gespeichert.

interface.scaleLink kopieren

Zahl, 0.9–1.5 – Standard: 1

Skaliert Tabs, Symbole, Schaltflächen, Seitenleisten und die übrige Oberfläche. Inhalte von Terminal, Editor und Diff behalten die separat eingestellte Schriftgröße.

sidebar.font-sizeLink kopieren

Zahl, 9–24 – Standard: 14

Grundschriftgröße beider Seitenleisten. Abschnittsüberschriften, Zeilen, Metadaten und Steuerelemente behalten dabei ihre relative Größenhierarchie.

terminal.font-thickenLink kopieren

Boolescher Wert – Standard: false

Zeichnet Terminalzeichen mit etwas kräftigeren Strichen, ähnlich der klassischen macOS-Schriftglättung. Beide Backends berücksichtigen dies; die Vorschau in den Einstellungen zeigt das Ergebnis. Ältere Konfigurationen mit font-thicken werden weiterhin gelesen und anschließend mit dem aktuellen punktgetrennten Schlüssel gespeichert.

terminal.font-thicken-strengthLink kopieren

Ganzzahl, 0–255 – Standard: 255

Steuert die Verstärkung bei aktiviertem terminal.font-thicken. Null bedeutet die geringste verfügbare Verstärkung, nicht ausgeschaltet. Ghostty verwendet seine native macOS-Stärke, Alacritty bildet denselben Bereich auf einen CoreText-Konturstrich ab. Richtung und Endpunkte stimmen überein, einzelne gerasterte Pixel können sich unterscheiden.

terminal.line-heightLink kopieren

Zahl, 0.75–2 – Standard: 1

Multipliziert die natürliche Zellenhöhe des jeweiligen Terminal-Backends und hält Zeichen vertikal zentriert. Nur Terminalzeilen ändern sich; Abstände in Editor und Diff bleiben erhalten.

Zshell bietet keinen Regler für eine grundlegende Schriftstärke. Ghostty wählt benannte Schnitte oder Variationsachsen, während Alacritty/CoreText normale und fette Schnitte über Schriftmerkmale auflöst. Ein gemeinsamer Wert würde bei statischen und variablen Schriften weder die Unterscheidung normal/fett noch die Ersatzschriftstärke zuverlässig erhalten.

editor.wrap-linesLink kopieren

Boolescher Wert – Standard: true

Bricht lange Zeilen im Dateieditor an der Bereichsbreite optisch um. Bei false scrollen lange Zeilen horizontal. Der Umbruch in Terminal und Diff wird nicht verändert.

TerminalLink kopieren

terminal.startup-program / terminal.startup-argumentsLink kopieren

Zeichenketten – standardmäßig nicht gesetzt

Bestimmen Programm und Argumente für danach neu erstellte Terminals. Ohne terminal.startup-program startet Zshell weiterhin die Login-Shell des Benutzerkontos mit -l. Das Programm muss als absoluter Pfad auf eine ausführbare Datei zeigen. Fehlt sie oder ist sie nicht ausführbar, startet die Login-Shell statt eines funktionslosen Bereichs.

terminal.startup-arguments wird ohne Shell-Aufruf in Argumente zerlegt. Anführungszeichen und Backslashes erhalten Argumentgrenzen, einschließlich Leerzeichen und leerer Argumente. Variablen, Globs und Befehlssubstitutionen werden nicht expandiert. Ungültige Anführungszeichen führen ebenfalls zur Login-Shell. Explizit über die Zshell-CLI übergebene argv-Argumente haben für das betreffende Terminal weiterhin Vorrang.

terminal.backendLink kopieren

"libghostty" · "alacritty" – Standard: "libghostty"

Bestimmt den Emulator für danach erstellte Terminals. Bestehende Bereiche behalten ihr bisheriges Backend. Beide sind nativ, GPU-beschleunigt, unterstützen Bilder und verwenden dieselben Zshell-Themen. Alacritty benötigt im Allgemeinen weniger Arbeitsspeicher.

Umgebungsvariablen und Kompatibilitätszusagen stehen unter Terminal-Backends.

terminal.macos-option-as-altLink kopieren

Boolescher Wert – Standard: false

Bei true werden Option-Tastenkombinationen als Alt-/Meta-Kürzel an Terminalprogramme gesendet. Standardmäßig bleibt Option bei der aktiven macOS-Eingabequelle, damit etwa Polish Pro seine zusammengesetzten Zeichen eingeben kann.

terminal.bellLink kopieren

Boolescher Wert – Standard: true

Steuert Ton und visuelle Aufmerksamkeit unter macOS, wenn ein Terminalprogramm die Glocke auslöst. Bei false spielt Zshell keinen Ton, sendet keine Terminalglocken-Mitteilung und fordert keine Aufmerksamkeit im Dock an. Bedienungshilfen erhalten die Glocke weiterhin als semantische Meldung. Beide Backends berücksichtigen diese Einstellung.

terminal.vim-command-hintsLink kopieren

Boolescher Wert – Standard: true

Zeigt vom Modus abhängige Vim-/Neovim-Befehle unter den Sitzungsinformationen in der Info-Seitenleiste. Die Einstellung wirkt sofort bei beiden Backends, auch für erkennbare Editoren über SSH. Voraussetzungen für die Moduserkennung stehen unter Vim-Befehlshinweise.

terminal.restore-historyLink kopieren

Boolescher Wert – Standard: true

Stellt nach einem Neustart die bisherige Terminalausgabe über einer neuen Shell wieder her. Sie ist statischer Text, kein weiterlaufender Prozess.

Der Verlauf wird auf dem Datenträger gespeichert und kann im Terminal angezeigte Geheimnisse enthalten. Projekte, Tabs und Bereichsanordnung werden unabhängig davon wiederhergestellt.

AutomatisierungLink kopieren

ai.enabledLink kopieren

Boolescher Wert – Standard: true

Ermöglicht unterstützten Programmieragenten, auf Ihre natürlichsprachliche Bitte Hintergrundbereiche zu koordinieren, und zeigt den vom Anbieter gemeldeten Lebenszyklusstatus an. Zshell leitet den Status nicht aus Terminaltext ab. Ändern Sie dies vorzugsweise im Einstellungsfenster: Dort erscheinen Fehler direkt, und widersprüchliche bestehende Konfigurationen bleiben unangetastet.

Den Ablauf beschreibt Mit KI-Agenten arbeiten.

Bei gemeinsamem Codex app-server ordnet Zshell verifizierte Gesprächs-IDs dem Vordergrundbereich zu. Mehrdeutige Zuordnungen bleiben offen. Die verwaltete Integration ergänzt session-id im Codex-Terminaltitel und erhält andere Titelelemente.

ai.resume-conversationsLink kopieren

Boolescher Wert — Standard true

Beim Wiederherstellen von Terminalbereichen wird das genaue gespeicherte Gespräch mit Claude Code, Codex, Pi oder OpenCode fortgesetzt, wenn das ursprüngliche PTY nicht verfügbar ist. Erfordert ai.enabled = true. Ohne bestätigtes Gespräch öffnet der Bereich eine neue Shell; Zshell wählt niemals das letzte Gespräch anhand des Verzeichnisses.

Die Option steht unter Einstellungen → Automatisierung → Agentengespräche fortsetzen. Sie ist unabhängig von terminal.restore-history.

Weitere EinstellungenLink kopieren

Sicherung und ÜbertragungLink kopieren

Mit Zshell → Einstellungen exportieren… speichern Sie eine TOML-Datei, mit Einstellungen importieren… laden Sie sie. Der Import fragt vor dem Ersetzen nach und versucht, die aktuelle Datei als config.toml.bak im selben Verzeichnis zu sichern.

Der Import liest alle unterstützten Einstellungen. Fehlende Schlüssel verwenden die Vorgaben des Konfigurationslesers; ohne ai.enabled bleibt die aktuelle KI-Einstellung erhalten. Sprache sowie Projekt- und Tab-Umgebungsvariablen werden separat gespeichert.

Ein vollständiges BeispielLink kopieren

theme = "dark"
theme-dark = "Catppuccin Mocha"
theme-light = "Catppuccin Latte"
font-family = "IBM Plex Mono"
font-size = 14
interface.scale = 1.25
sidebar.font-size = 13
toolbar.visibility = "auto"
terminal.font-fallback-family = "PingFang SC"
terminal.font-thicken = true
terminal.font-thicken-strength = 180
terminal.line-height = 1.15
terminal.macos-option-as-alt = false
terminal.bell = false
terminal.startup-program = "/opt/homebrew/bin/fish"
terminal.startup-arguments = "--no-config"
terminal.backend = "alacritty"
terminal.restore-history = true
editor.wrap-lines = true
ai.enabled = true
ai.resume-conversations = true

Jeder Schlüssel ist optional. Entfernen Sie einen Schlüssel, um dessen Standardwert wiederherzustellen.

TastenkürzelLink kopieren

Unter Einstellungen → Tastenkürzel zeichnen Sie neue Kürzel für zentrale Befehle auf. Zshell weist Konflikte zurück und nennt den Befehl, der die Kombination bereits verwendet. Standardtastenkürzel wiederherstellen setzt alle eigenen Belegungen zurück. Die Tastenkürzelübersicht enthält die ausgelieferten Vorgaben.

Einstellungen außerhalb dieser DateiLink kopieren

• Sprache. Die Einstellungen bieten den Systemstandard und dieselben 17 Sprachen wie die Website. Änderungen wirken sofort, während Terminalsitzungen weiterlaufen. Die Auswahl verwendet die macOS-Sprachpräferenz pro Anwendung und liegt deshalb in Zshells Voreinstellungen statt in TOML. Der Systemstandard folgt der macOS-Sprachreihenfolge.
• Automatische Updates. Die Schalter für automatische Prüfung, Download und Installation unter Einstellungen → Updates liegen ebenfalls außerhalb von TOML und bleiben über Neustarts erhalten. Die Installationsoption erscheint nur bei aktivierten automatischen Downloads. Siehe Installation.
• Fenster und Anordnung. Fenstergröße, Seitenleistenbreiten, ausgewählte Panels, Projekte, Tabs, Bereiche, Browser-URLs und Diff-Voreinstellungen liegen in Zshells macOS-Voreinstellungen und Sitzungsabbild.
• Backend-Konfigurationsdateien. Zshell liest weder ~/.config/ghostty noch eine Alacritty-Konfiguration. Für beide Backends sind Zshells Einstellungen maßgeblich.