Paneflows Settings-Panel ist die menschliche UI für häufige Präferenzen. Es ist nicht die vollständige Konfigurationsreferenz. Nutze es für Einstellungen, die du oft anpasst: Editor, Shell, Design, Shortcuts, Benachrichtigungen, Terminaldarstellung, Workspace-Templates, Agent-Launcher, KI-Zugriff und MCP-Setup.
TL;DR. Die meisten Settings-Zeilen schreiben in paneflow.json und
laden nach dem Speichern heiß nach. MCP Servers ist anders: Es
installiert oder repariert Paneflows MCP-Bridge in unterstützten
Agent-Konfigurationen. Erweiterte Schlüssel bleiben in
paneflow.json verfügbar.
Settings-Übersicht
| Seite | Was sie steuert | Schreibt nach | Wirkung |
|---|---|---|---|
| General | Standard-Editor und Standard-Shell für neue Terminal-Panes. | external_editor, default_shell | Neue Starts. Laufende Terminals behalten ihren aktuellen Prozess. |
| Themes | Light, Dark, System sowie eigene Windows- und macOS-Steuerelemente für Sidebar-Material, wenn verfügbar. | theme, windows_chrome_material, macos_chrome_material | Theme- und Materialänderungen werden sofort neu geladen. |
| Keyboard Shortcuts | Action-Bindings und Zurücksetzen auf Defaults. | shortcuts | Nach dem Config-Speichern neu geladen. |
| Notifications | Native OS-Benachrichtigungen für wartende Agents. | agent_panel.notify_when_agent_waiting | Hot-Reload. |
| Terminal | Cursorform und -farbe, Schriftfamilie, Schriftgröße, Schriftgewicht, Zeilenhöhe, Zellbreite, integrierte Glyphen, farbige Emoji und Windows-Terminal-Material. | terminal.cursor_shape, terminal.cursor_color, font_family, font_size, font_weight, line_height, cell_width, terminal.integrated_glyphs, terminal.color_emoji, windows_terminal_material | Darstellung lädt heiß nach. Cursorform gilt für das nächste neue Terminal. |
| Workspaces | Wiederverwendbare Workspace-Templates mit Panes, Agents, Shell-Befehlen, cwd, env und Prompt-Prefill. | commands[].workspace | Templates laufen über denselben Workspace-Launch-Pfad wie paneflow up. |
| AI Agent | Sichtbarkeit der Launcher-Buttons, Claude-Code-Bypass-Modus, KI-Free-Access und Injection Fence. | *_button_visible, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence | Launcher- und Zugriffseinstellungen laden heiß nach. |
| MCP Servers | Installiert oder repariert die mitgelieferte paneflow-mcp-Bridge für Claude Code, Codex, Gemini und opencode. | Agent-Konfigurationsdateien, nicht paneflow.json | Nach einem Paneflow-Update oder einer Agent-Config-Änderung erneut ausführen. |
KI-Zugriff vs MCP
Die AI-Agent-Seite steuert, wie Paneflow Agents startet und wie viel Automatisierung ein vertrauenswürdiger Conductor ausführen darf.
claude_code_bypass_permissions betrifft nur Claude-Code-Starts. Wenn
aktiviert, startet Paneflow Claude Code mit
--permission-mode bypassPermissions. Codex, OpenCode, Gemini und MCP
ändern dadurch ihr Verhalten nicht.
MCP Servers ist eine getrennte operative Seite. Sie registriert den
mitgelieferten paneflow-mcp-Server, damit unterstützte Agents
Paneflow-Panes auflisten, lesen und durchsuchen können. Sie schreibt in
die eigenen Konfigurationsdateien der Agents und kann sicher erneut
ausgeführt werden.
Config-only-Einstellungen
Nutze paneflow.json, wenn du eine Einstellung
brauchst, die absichtlich nicht in der primären Settings-UI liegt.
Häufige Beispiele:
terminal.scrollback_linesfür den Scrollback-Verlauf pro Terminal.terminal.backend,terminal.ligatures,terminal.cursor_blink,terminal.envundterminal.scroll_multiplierfür erweitertes Terminalverhalten. Standard-Linux-Builds und unterstützte Windows-x64-MSVC-Builds wählen beiautoGhostty; setzeterminal.backendfür den Rollback aufalacritty. macOS und Builds ohne das native Ghostty-Feature ihres Ziels verwenden Alacritty. Die Backend-Einstellung gilt nur für neue Sessions.commands[]-Einträge, die keine Workspace-Templates sind.- Profile, Telemetry, Window-Decoration und Agent-Panel-Optionen.
Paneflow lädt gültige Config-Änderungen über seinen Watcher neu. Wenn das JSON fehlerhaft ist, behält die laufende App die letzte gültige Config, statt auf Defaults zurückzufallen. Das JSON Schema markiert unbekannte Schlüssel in Editoren; der Runtime bleibt tolerant, damit ältere Builds neuere Schlüssel ignorieren können.
Siehe auch
- Konfiguration - Dateipfad, Schema-Setup und Runtime-Verhalten.
- Schema - jeder Schlüssel, Typ, Default und Stabilität.
- Shortcuts und Actions - Action-Namen für
shortcuts-Overrides. - Designs - mitgelieferte Designnamen und Hot-Reload-Verhalten.