Configuratie

De meeste blijvende Zshell-instellingen staan in één bestand:

~/.config/zshell/config.toml

Het instellingenvenster (Cmd+,) schrijft naar hetzelfde bestand. Enkele door macOS beheerde instellingen, zoals taal en automatische updates, staan elders en worden onderaan deze pagina vermeld.

Nieuwe configuraties schakelen Vim-opdrachthulp, herstel van sessiegeschiedenis en meldingen van mislukte opdrachten standaard in. Automatische update-downloads staan ook standaard aan. Bestaande configuraties en opgeslagen keuzes blijven behouden.

Hoe het bestand werktLink kopiëren

Handig om te weten voordat je handmatig bewerkt:

• Wijzigingen worden tijdens het draaien gelezen. Geldige externe wijzigingen gelden automatisch; instellingen voor nieuwe terminals vereisen nog een nieuw paneel. Onleesbare of ongeldige bestanden behouden de laatste geldige instellingen. Een bewust leeg bestand herstelt na korte tijd de standaardwaarden.
• Zshell herschrijft het wanneer een bestandsgebonden instelling verandert. Het bestand wordt volledig opnieuw gegenereerd. Je opmerkingen en onbekende sleutels verdwijnen dus wanneer je de volgende keer een van die instellingen wijzigt. Kies één manier om het bestand te bewerken of houd een leidende kopie bij in je dotfiles.
• De meeste standaardwaarden worden weggelaten. font-size, terminal.vim-command-hints, terminal.restore-history, terminal.notify-on-error worden altijd opgeslagen. Het verwijderen van een van deze drie terminalsleutels in een bestaand bestand schakelt de functie uit; bij andere sleutels wordt de standaard hersteld.
• De parser is bewust beperkt. Hij ondersteunt platte sleutels, sleutels met punten, [table]-koppen, #-opmerkingen en tekenreeks-, getal- en booleaanse waarden. Arrays, inline-tabellen en tekenreeksen met meerdere regels worden niet ondersteund.
• Ongeldige waarden vallen veilig terug. Een grootte buiten het bereik, onbekende backend of verkeerd gespeld thema verhindert niet dat Zshell start.

Opslaan behoudt symbolische links naar bestanden en mappen, werkt het doel atomair bij en behoudt de rechten. Externe wijzigingen herschrijven geen opmerkingen of onbekende sleutels; later opslaan via Instellingen maakt het bestand nog steeds opnieuw zoals hierboven beschreven.

Aanwezigheid van de appLink kopiëren

app-presenceLink kopiëren

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

Kies Instellingen → Algemeen → Zshell weergeven in om direct te wisselen. "dock" toont alleen het Dock-symbool, "dock-and-menu-bar" beide symbolen en "menu-bar" alleen het menubalksymbool.

De menubalk opent de huidige werkruimte, de snelle terminal, instellingen en de updatecontrole. In beide menubalkmodi wordt het laatste werkruimtevenster bij sluiten verborgen terwijl terminals en taken actief blijven. Werkruimte openen keert terug naar hetzelfde venster, project en dezelfde sessie. Andere vensters, panelen of projecten sluiten beëindigt hun taken nog steeds. Stop volgt terminal.preserve-sessions; Stop en beëindig alle sessies beëindigt ze. De modus blijft na opnieuw starten bewaard.

WeergaveLink kopiëren

themeLink kopiëren

"system" · "light" · "dark" — standaard "system"

Kiest de weergave van de app. "system" volgt macOS; de andere twee zetten Zshell vast op één weergave.

theme-dark en theme-lightLink kopiëren

Tekenreeks — standaard "Default Dark" en "Default Light"

Het kleurthema voor elke weergave. Een thema kleurt terminaldeelvensters, vensterranden, zijbalken, de editor en diffs gezamenlijk. De ingebouwde standaardthema's behouden de doorschijnende zijbalk van Zshell; andere thema's kleuren die volgens hun palet.

Instellingen toont de samengestelde themacatalogus die beide terminalbackends delen. Een handmatig ingevoerde naam moet exact overeenkomen met een van die weergavenamen, inclusief hoofdletters. Anders gebruikt Zshell het bijbehorende standaardthema.

toolbar.visibilityLink kopiëren

"hide" · "auto" · "always" — standaard "hide"

Regelt de compacte werkbalk onder het actieve tabblad:

• "hide" houdt hem verborgen.
• "auto" toont hem alleen wanneer de projectmap een Git-repository is.
• "always" houdt de Git-toegang zichtbaar in elk project, inclusief de status Geen Git-repository.

Zie De Git-werkbalk voor wat hij toont.

TekstLink kopiëren

font-familyLink kopiëren

Tekenreeks — standaard "", voor het meegeleverde JetBrains Mono

De terminal, editor en diffviewer delen deze Latijnse lettertypefamilie. Geef een familienaam op, geen variant: "IBM Plex Mono", niet "IBM Plex Mono Regular". Onbekende of niet-monospacefamilies vallen terug op het meegeleverde standaardlettertype.

De fallbackvolgorde van de terminal is de Latijnse familie, de optionele CJK-fallback hieronder, het meegeleverde Symbols Nerd Font en daarna de systeemfallback van de backend. De editor en diffviewer blijven hun normale macOS-/WebKit-fallback gebruiken.

terminal.font-fallback-familyLink kopiëren

Tekenreeks — standaard "", voor de backend-/systeemfallback

Voegt één geïnstalleerde CJK-familie toe aan de geordende fallbackketen van de terminal. De kiezer in Instellingen bevat families met representatieve Chinese, Japanse of Koreaanse tekens. Die hoeven niet strikt monospace te zijn, omdat ze alleen tekens leveren die ontbreken in het primaire Latijnse lettertype.

font-sizeLink kopiëren

Getal, 8–32 — standaard 13

De gedeelde lettergrootte van terminal, editor en diff, in punten. Dit is de enige sleutel die Zshell ook schrijft als hij de standaardwaarde heeft.

interface.scaleLink kopiëren

Getal, 0.9–1.5 — standaard 1

Schaalt tabbladen, pictogrammen, knoppen, zijbalken en de rest van de app-interface. De inhoud van terminal, editor en diffs behoudt de hierboven afzonderlijk ingestelde lettergrootte.

sidebar.font-sizeLink kopiëren

Getal, 9–24 — standaard 14

De basistekstgrootte voor beide zijbalken. Sectiekoppen, rijen, metadata en bedieningselementen behouden hun onderlinge hiërarchie wanneer de basis verandert.

terminal.font-thickenLink kopiëren

Booleaans — standaard false

Tekent terminaltekens met iets dikkere lijnen, vergelijkbaar met klassieke macOS-lettertypeverzachting. Beide backends ondersteunen dit en het voorbeeld in Instellingen toont het resultaat. Oudere font-thicken-configuraties worden nog gelezen en vervolgens herschreven met de huidige sleutel met punt.

terminal.font-thicken-strengthLink kopiëren

Geheel getal, 0–255 — standaard 255

Regelt de verdikking wanneer terminal.font-thicken true is. Nul is de lichtste beschikbare verdikking, niet uit. Ghostty gebruikt zijn native macOS-sterkte; Alacritty vertaalt hetzelfde bereik naar een CoreText-lijndikte. Richting en eindpunten komen overeen, maar gerasterde pixels kunnen verschillen.

terminal.line-heightLink kopiëren

Getal, 0.75–2 — standaard 1

Vermenigvuldigt de natuurlijke celhoogte van elke terminalbackend en houdt tekens verticaal gecentreerd. Dit verandert alleen terminalregels, niet de regelafstand in editor of diff.

Zshell biedt geen instelling voor het basislettergewicht. Ghostty kiest benoemde stijlen of variatieassen, terwijl Alacritty/CoreText normale en vette varianten op basis van eigenschappen bepaalt. Eén gedeelde waarde zou het onderscheid tussen normaal en vet of fallbackgewichten niet consistent behouden voor statische en variabele lettertypen.

editor.wrap-linesLink kopiëren

Booleaans — standaard true

Breekt lange regels visueel af op de deelvensterbreedte in de bestandseditor. Bij false scrollen lange regels horizontaal. Dit verandert regelafbreking in terminals of diffs niet.

TerminalLink kopiëren

terminal.startup-program / terminal.startup-argumentsLink kopiëren

Tekenreeksen — standaard niet ingesteld

Kies het uitvoerbare programma en de argumentvector voor terminals die hierna worden gemaakt. Zonder terminal.startup-program blijft Zshell de inlogshell van het account gebruiken met -l. Het programma moet een absoluut pad naar een uitvoerbaar bestand zijn. Een ontbrekend of niet-uitvoerbaar pad valt terug op de inlogshell in plaats van een onbruikbaar deelvenster te openen.

terminal.startup-arguments wordt in argumenten gesplitst zonder een shell aan te roepen. Aanhalingstekens en backslashes behouden grenzen, inclusief spaties en lege argumenten. Variabelen, globs en opdrachtvervangingen worden niet uitgebreid. Ongeldige aanhalingstekens leiden ook tot een terugval op de inlogshell. Een expliciete argv vanuit de Zshell-CLI heeft nog steeds voorrang voor die terminal.

terminal.backendLink kopiëren

"libghostty" · "alacritty" — standaard "libghostty"

Kiest de emulator voor terminals die hierna worden gemaakt. Bestaande deelvensters behouden hun oorspronkelijke backend. Beide opties zijn native, GPU-versneld, ondersteunen afbeeldingen en gebruiken dezelfde Zshell-thema's; Alacritty gebruikt doorgaans minder geheugen.

Zie Terminalbackends voor omgevingsvariabelen en compatibiliteitsafspraken.

terminal.macos-option-as-altLink kopiëren

Booleaans — standaard false

Bij true worden Option-toetscombinaties als Alt-/Meta-sneltoetsen naar terminalprogramma's gestuurd. Standaard blijft Option bij de actieve macOS-invoerbron, zodat indelingen zoals Polish Pro hun samengestelde tekens kunnen typen.

terminal.bellLink kopiëren

Booleaans — standaard true

Regelt het waarschuwingsgeluid en de visuele aandacht van macOS wanneer een terminalprogramma een belsignaal geeft. Bij false speelt Zshell geen geluid af, stuurt het geen terminalbelmelding en vraagt het geen aandacht in het Dock. Toegankelijkheidstechnologieën ontvangen de bel nog wel als semantische aankondiging. Beide terminalbackends respecteren deze instelling.

terminal.vim-command-hintsLink kopiëren

Booleaans — standaard true

Toont modusafhankelijke Vim-/Neovim-opdrachten onder de sessiegegevens in de zijbalk Info. Dit geldt onmiddellijk op beide terminalbackends, ook voor herkenbare editors via SSH. Zie Vim-opdrachthulp voor de voorwaarden van modusdetectie.

terminal.restore-historyLink kopiëren

Booleaans — standaard true

Herstelt na een herstart de eerdere uitvoergeschiedenis van elke terminal boven een nieuwe shell. De herstelde inhoud is statische tekst, geen proces dat is blijven draaien.

Herstelde geschiedenis wordt op schijf opgeslagen en kan dus geheimen bevatten die in de terminal zijn weergegeven. Projecten, tabbladen en deelvensterindeling worden in beide gevallen hersteld.

AutomatiseringLink kopiëren

ai.enabledLink kopiëren

Booleaans — standaard true

Laat ondersteunde programmeeragents Zshell-deelvensters op de achtergrond coördineren wanneer je dat in gewone taal vraagt, en toont door de aanbieder gemelde levenscyclusstatus in de interface. Zshell leidt geen status af uit terminaltekst. Gebruik bij voorkeur de schakelaar in Instellingen: fouten worden daar direct getoond en conflicterende bestaande configuraties blijven intact.

De werkwijze voor gebruikers staat in Werken met AI-agents.

Bij een gedeelde Codex app-server koppelt Zshell geverifieerde gespreks-ID’s aan het voorgrondpaneel. Onduidelijke overeenkomsten blijven ongekoppeld. De beheerde integratie voegt session-id toe aan de Codex-titel en behoudt andere titelonderdelen.

ai.resume-conversationsLink kopiëren

boolean — standaard true

Bij het herstellen van terminalpanelen wordt het precieze opgeslagen gesprek van Claude Code, Codex, Pi of OpenCode hervat als het oorspronkelijke PTY niet beschikbaar is. Vereist ai.enabled = true. Zonder geverifieerd gesprek opent het paneel een nieuwe shell; Zshell kiest nooit het nieuwste gesprek op basis van de map.

Gebruik Instellingen → Automatisering → Agentgesprekken hervatten. Deze optie staat los van terminal.restore-history.

Aanvullende instellingenLink kopiëren

Back-up en migratieLink kopiëren

Gebruik Zshell → Instellingen exporteren… om een TOML-bestand op te slaan en Instellingen importeren… om het te laden. Importeren vraagt bevestiging voor het vervangen en probeert een back-up van het huidige bestand als config.toml.bak in dezelfde map te maken.

Importeren leest alle ondersteunde instellingen. Ontbrekende sleutels volgen de standaardwaarden van de lezer; zonder ai.enabled blijft de huidige AI-instelling behouden. Taal en omgevingsvariabelen van projecten en tabbladen worden apart opgeslagen.

Een volledig voorbeeldLink kopiëren

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

Elke sleutel is optioneel. Verwijder een sleutel om de instelling op de standaard terug te zetten.

SneltoetsenLink kopiëren

Open Instellingen → Sneltoetsen om een nieuwe sneltoets voor een kernopdracht vast te leggen. Zshell weigert conflicterende combinaties en noemt de opdracht die ze al gebruikt. Standaardsneltoetsen herstellen wist alle aanpassingen. Het sneltoetsenoverzicht vermeldt de meegeleverde standaardcombinaties.

Instellingen buiten dit bestandLink kopiëren

• Taal. Instellingen biedt Systeemstandaard en 17 talen, net als de website. Wijzigingen gelden onmiddellijk terwijl terminalsessies blijven draaien. De keuze gebruikt de macOS-taalvoorkeur per app en staat daarom in de voorkeuren van Zshell, niet in TOML. Systeemstandaard volgt de macOS-taalvolgorde.
• Automatische updates. De schakelaars voor automatisch controleren, downloaden en installeren onder Instellingen → Updates gebruiken app-voorkeuren buiten TOML en onthouden je keuzes na herstarts. Installeren verschijnt alleen als automatisch downloaden aanstaat. Zie Installatie.
• Venster- en indelingsstatus. Venstergrootte, zijbalkbreedtes, geselecteerde panelen, projecten, tabbladen, deelvensters, browser-URL's en diffvoorkeuren staan in de macOS-voorkeuren van Zshell en de sessiemomentopname.
• Backendconfiguraties. Zshell leest ~/.config/ghostty noch een Alacritty-configuratie. De instellingen van Zshell vormen de ondersteunde configuratie voor beide.