Paneflow の Settings パネルは、よく使う設定のための人間向け UI です。 完全な設定リファレンスではありません。頻繁に調整するものに使います: エディタ、shell、テーマ、ショートカット、通知、terminal 表示、 workspace template、agent launcher、AI access、MCP setup。
TL;DR. Settings の多くの行は paneflow.json に書き込み、ファイル保存後に
ホットリロードされます。MCP Servers は別です。対応する agent config に
Paneflow の MCP bridge をインストールまたは修復します。高度なキーは
paneflow.json で引き続き利用できます。
Settings map
| Page | 制御するもの | 書き込み先 | 適用タイミング |
|---|---|---|---|
| General | 新しい terminal pane 用のデフォルト外部エディタとデフォルト shell。 | external_editor, default_shell | 新規起動時。実行中の terminal は現在のプロセスを保持します。 |
| Themes | Light、Dark、System、利用可能な場合は Windows と macOS 専用の sidebar material control。 | theme, windows_chrome_material, macos_chrome_material | theme と material の変更はホットリロードされます。 |
| Keyboard Shortcuts | action binding と defaults へのリセット。 | shortcuts | config 保存後に再読み込みされます。 |
| Notifications | 待機中 agent の native OS notification。 | agent_panel.notify_when_agent_waiting | ホットリロードされます。 |
| Terminal | cursor shape と color、font family、font size、font weight、line height、cell width、integrated glyphs、color emoji、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 | 表示系の control はホットリロードされます。cursor shape は次の新しい terminal に適用されます。 |
| Workspaces | pane、agent、shell command、cwd、env、prompt prefill を持つ再利用可能な workspace template。 | commands[].workspace | template は paneflow up と同じ workspace launch path を通ります。 |
| AI Agent | launcher button visibility、Claude Code bypass mode、AI free access、injection fence。 | *_button_visible, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence | launcher と access の変更はホットリロードされます。 |
| MCP Servers | Claude Code、Codex、Gemini、opencode 用の同梱 paneflow-mcp bridge をインストールまたは修復します。 | agent config files。paneflow.json ではありません。 | Paneflow 更新後、または agent config 変更後に再実行します。 |
AI access vs MCP
AI Agent ページは、Paneflow が agent をどう起動するか、信頼された conductor がどれだけ自動化できるかを制御します。
claude_code_bypass_permissions が影響するのは Claude Code の起動だけです。
有効にすると、Paneflow は Claude Code を
--permission-mode bypassPermissions 付きで起動します。Codex、OpenCode、
Gemini、MCP の挙動は変わりません。
MCP Servers は別の運用ページです。同梱の paneflow-mcp server を登録し、
対応する agent が Paneflow pane を list、read、search できるようにします。
agent 自身の config file に触れ、安全に再実行できます。
Config-only controls
主要な Settings UI に意図的に置いていない設定が必要な場合は、
paneflow.json を使います。
よくある例:
- terminal ごとの scrollback history を調整する
terminal.scrollback_lines。 - 高度な terminal behavior 用の
terminal.backend、terminal.ligatures、terminal.cursor_blink、terminal.env、terminal.scroll_multiplier。標準の Linux build と対応する Windows x64 MSVC build はautoで Ghostty を選択します。 ロールバックするにはterminal.backendをalacrittyに設定します。macOS と 対象の native Ghostty feature を含まない build は Alacritty を使用します。 backend 設定は新しいセッションにのみ適用されます。 - workspace template ではない
commands[]entry。 - profiles、telemetry、window-decoration、agent-panel options。
Paneflow は watcher 経由で有効な config 変更を再読み込みします。JSON が 不正な場合、実行中の app は defaults に戻らず、直前の有効な config を 保持します。JSON Schema は editor 上で未知のキーを示しますが、runtime は 古い build が新しいキーを無視できるよう寛容なままです。
関連
- Configuration - file location、schema setup、runtime behavior。
- Schema - すべての key、type、default、stability。
- Shortcuts and actions -
shortcutsoverride 用の action name。 - Themes - 同梱 theme name と hot-reload behavior。