Paneflow の Settings パネルは、よく使う設定のための人間向け UI です。完全な設定リファレンスではありません。頻繁に調整するものに使います: エディタ、shell、テーマ、ショートカット、通知、terminal 表示、 workspace template、agent launcher、AI access、MCP setup。
TL;DR. Settings の多くの行は paneflow.json に書き込み、ファイル保存後にホットリロードされます。Plugins は別です。対応する agent config に
Paneflow の MCP bridge をインストールまたは修復します。高度なキーは
paneflow.json で引き続き利用できます。
Settings map
| Page | 制御するもの | 書き込み先 | 適用タイミング |
|---|---|---|---|
| General | 新しい terminal pane 用のデフォルト外部エディタとデフォルト shell。 | external_editor, default_shell | 新規起動時。実行中の terminal は現在のプロセスを保持します。 |
| Appearance | Light、Dark、System、theme preset、Comfortable density、Interface style、Workspace icon、Windows、macOS、Linux の Background style、App icon、Windows、macOS、Linux 専用の sidebar material control。 | theme, comfortable_density, interface_style, workspace_icon, app_icon, windows_chrome_material, windows_terminal_material, macos_chrome_material, linux_chrome_material, linux_terminal_material | theme、density、style、icon、material の変更はホットリロードされます。 |
| Keyboard Shortcuts | action binding と defaults へのリセット。 | shortcuts | config 保存後に再読み込みされます。 |
| Notifications | 待機中 agent と terminal program が送信する notification の 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、minimum contrast、Windows と Linux の terminal material。 | terminal.cursor_shape, terminal.cursor_color, font_family, font_size, font_weight, line_height, cell_width, terminal.integrated_glyphs, terminal.color_emoji, terminal.minimum_contrast, windows_terminal_material, linux_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 を通ります。 |
| Spaces | workspace をまとめるスペース。先頭に Default、続いて各スペースの名前、画像、色、環境変数、そのスペースが設定する config ディレクトリ内の Claude Code と Codex の hook と MCP の状態、確認のうえでその workspace を Default に移す削除操作。スペースは最大 9 個。 | spaces。画像は Paneflow ホームの avatars/ に保存されます | 名前、画像、色はホットリロードされます。環境変数は変更後に開いた terminal に適用されます。 |
| Worktrees | Paneflow が作る worktree のルートディレクトリ、保持上限つきの自動削除、削除操作つきの管理対象 worktree 一覧、削除前に取られたスナップショットの復元と削除。 | worktrees.dir, worktrees.auto_remove, worktrees.keep_limit | ホットリロード。ルートはそれ以降に作る worktree に適用。 |
| Agents | launcher に表示する agent とそのインストール済みバージョンと hook の状態、Claude Code と Codex 用の Paneflow hooks トグル、カスタム agent profile、Claude Code full access、AI free access、injection fence。 | *_button_visible, agent_profiles, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence。Paneflow hooks トグルは agent 自身の hook 設定に書き込みます | launcher と access の変更はホットリロードされます。 |
| Plugins | Claude Code、Codex、Gemini、opencode 用の同梱 paneflow-mcp bridge をインストールまたは修復します。 | agent config files。paneflow.json ではありません。 | Paneflow 更新後、または agent config 変更後に再実行します。 |
インターフェーススタイル
Settings > Appearance の theme preset の下に Interface style があります。コマンドパレットの Interface style でも同じ選択ができます。アプリ全体のレイアウトと角の形を選び、interface_style に保存されます。
| スタイル | 描画内容 |
|---|---|
| Classic (デフォルト) | 端から端まで使うウィンドウ。サイドバー、ペイン、Changes ドックはウィンドウの端まで広がり、間は細い線で区切られます。上部ペインとドックのタブはウィンドウコントロールの横のタイトルバーに並び、その行の空いた部分をドラッグするとウィンドウを動かせます。角は小さな段階の円形で、ダイアログとトーストは 12 px、行、ボタン、ペインのタブは 8 px です。Comfortable density は効果がありません。 |
| Rounded | Paneflow 0.19 以前の見た目。大きな半径の連続曲線の角(スクワークル)を持つペインカードが、全幅のタイトルバーの下に浮かびます。Comfortable density はこのスタイルでのみ有効です。 |
どちらのスタイルでも、すべてのメニューと選択ポップアップは 8 px のパネルで、行の高さは 28 px、ラベルは 14 px、ショートカットは 12 px です。コマンドパレットと Clone repository ダイアログは、どちらのスタイルでも同じ見た目です。変更は開いているすべてのウィンドウにすぐ適用されます。
0.20.0 以降、Paneflow は Classic で開きます。浮かぶペインカードを使い続けるには、Rounded を選ぶか "interface_style": "rounded" を設定します。
背景スタイル
Windows、macOS、Linux では、Settings > Appearance のインターフェーススタイルの下に
Background style があります。コマンドパレットの Background style でも同じ選択ができます。プラットフォームのウィンドウ material をまとめて切り替えます。0.19 まではこの設定の名前が Interface style でした。値とキーはそのままです。
| スタイル | Windows | macOS | Linux |
|---|---|---|---|
| Themed (デフォルト) | windows_chrome_material と windows_terminal_material を false に設定。theme の不透明な色で描画します。 | macos_chrome_material を false に設定。sidebar は不透明になります。 | linux_chrome_material と linux_terminal_material を false に設定。ウィンドウは不透明になります。 |
| Blended | 両方を true に設定。sidebar とターミナルの背後に Mica が透けて見えます。 | macos_chrome_material を true に設定。sidebar の背後にネイティブの Sidebar material が表示されます。 | 両方を true に設定。sidebar の背後に半透明のベール越しでデスクトップが透けて見え、ターミナルの背後にはより濃いベールがかかります。 |
Linux では、"window_backdrop": "blurred" のとき、Paneflow は ext-background-effect
または KDE のぼかしを提供する Wayland compositor に、半透明のウィンドウの背後を角丸に沿ってぼかすよう要求します。X11 や GNOME などそれ以外の環境では、Paneflow
はぼかしを要求しません。ぼかしは compositor が提供することがあります (たとえば
GNOME の Blur my Shell 拡張機能)。ぼかしがない場合、壁紙はぼかされずにベール越しに見えます。
background_style というキーはありません。Paneflow はこれらのスイッチからスタイルを判定します。値が揃っていない場合 (たとえば片方だけ手動でオンにした場合)、この行には Custom と表示されます。
ワークスペースアイコン
Settings > Appearance に Workspace icon があり、コマンドパレットの Workspace icon でも同じ選択ができます。サイドバーの各ワークスペースの前に表示するグリフを選び、workspace_icon に保存されます。
Default は Paneflow の輪郭線のフォルダーです。Standard はフォルダーの代わりに開閉用のシェブロンを表示し、ワークスペースを折りたたむと右向き、開くと下向きになります。
Metal は塗りつぶしたガラスのフォルダー、Windows は黄色のグラデーションのフォルダー、Windows 95 は 16 色のピクセルフォルダー、Pixel は輪郭線のピクセルフォルダーです。どのスタイルにも閉じたグリフと開いたグリフがあり、2 つのピクセルスタイルは表示倍率 100 % または 200 % で最も鮮明です。
アプリアイコン
Settings > Appearance のテーマカードの下部に App icon があります。
Paneflow の実行中のウィンドウに表示するアイコンを選び、app_icon に保存されます。行には現在のアイコンとその名前が表示されます。クリックするとすべてのアイコンのギャラリーが展開され、1 つ選ぶとすぐに適用されます。
| アイコン | 描画内容 |
|---|---|
| Glass (デフォルト) | インストール時のアイコン。紫のタイルに 3 枚のガラスのペイン。 |
| Black | 黒いタイルに、オフホワイトの横縞で描いた Paneflow のマーク。 |
| White | 白いタイルに、濃いインクで描いた同じ横縞。 |
| Black solid | 黒いタイルに、オフホワイトの塗りつぶした形で描いた 3 枚のペイン。 |
| White solid | 白いタイルに、濃いインクで描いた同じ塗りつぶしのペイン。 |
続いて 16 種類のイラストアイコンがあります。どれも同じマークを別の素材で表しています。
| アイコン | app_icon | 描画内容 |
|---|---|---|
| Aubergine | aubergine | 深いナス色のタイルにライラック色のペイン。 |
| Paper | paper | オフホワイトの紙のタイルに、ナス色のインクで描いたペイン。 |
| Midnight matte | midnight-matte | マットな黒のタイルにダークグレーのペイン。 |
| Polar | polar | 氷のような白いタイルに青とシアンのペイン。 |
| Melon | melon | クリーム色のタイルにコーラルとオレンジのペイン。 |
| Honeydew | honeydew | ミントとライムのタイルに濃い緑のペイン。 |
| Berry | berry | 紫とピンクのタイルにプラム色のペイン。 |
| Rainbow | rainbow | 黒いタイルに、6 色のレトロな縞で描いたペイン。 |
| Solarwave | solarwave | 深い紫のタイルにクロームの夕焼けの帯。 |
| Neon | neon | 暗い紫のタイルにシアンとピンクのネオンの輪郭線。 |
| Phosphor | phosphor | 黒い画面のタイルに光る緑のペイン。 |
| Holo | holo | 虹色に光るホイルのタイルに暗いペイン。 |
| Amethyst | amethyst | カットされた紫の宝石にライラック色のペイン。 |
| Blueprint | blueprint | 設計図(ブループリント)のタイルに淡い青のペイン。 |
| Chip | chip | 緑の回路基板に載ったチップに、ヘアライン仕上げの金属のペイン。 |
| Nostalgia | nostalgia | 光沢のある青いタイルにクロームホワイトのペイン。 |
| プラットフォーム | 選択が表示される場所 | タイミング |
|---|---|---|
| Windows | タスクバーのボタン、Alt+Tab、この Paneflow を開くプロファイル内のショートカット(タスクバーにピン留めしたもの、デスクトップのショートカット、スタート メニューの項目)。 | Alt+Tab はすぐに反映。タスクバーのボタンは次回のサインイン時か Windows エクスプローラーの再起動時。ショートカットは Paneflow を閉じている間もアイコンを保ちます。 |
| macOS | Paneflow の実行中の Dock とアプリスイッチャー。 | すぐに反映。 |
| Linux、X11 | ウィンドウマネージャーとタスクスイッチャーが読み取るウィンドウアイコン。 | 変更後に開いたウィンドウ。すべてに適用するには Paneflow を再起動します。 |
| Linux、Wayland | どこにも表示されません。compositor はインストール済みのデスクトップエントリからアイコンを取得します。 | 反映されません。 |
Windows では、タスクバーにピン留めしたボタンはウィンドウではなくショートカットのアイコンを表示します。そのため Paneflow は、Paneflow ホームの icons/ に書き出したアイコンファイルをそのショートカットが指すようにし、起動のたびに確認し直します。
Windows はタスクバーのボタンの画像をキャッシュし、タスクバーを再読み込みするときにだけショートカットを読み直すため、ボタンが変わるのは次回のサインイン時か、Windows エクスプローラーの再起動後です。
Glass を選ぶと、ショートカット本来のアイコンに戻ります。
マシン全体へのインストールで作られたスタート メニューのショートカットは、ユーザーが変更できるものではありません。
Glass 以外のアイコンを選ぶと、Paneflow はそれを自分のスタート メニュー フォルダーの同じ場所にコピーし(Windows はこちらを優先します)、そのコピーにアイコンを設定します。Glass を選ぶとコピーは削除されます。別のアイコンを選んだまま Paneflow をアンインストールすると、コピーが残ります。%APPDATA%\Microsoft\Windows\Start Menu\Programs から削除してください。
macOS と Linux では、インストール済みのランチャーと、実行していない Paneflow の Dock タイルは Glass のアイコンのままです。
ターミナルのコントラスト
プログラムが指定した文字色が背景に近すぎる場合、Paneflow はコントラストを引き上げます。Settings > Terminal の Minimum contrast で設定できます。コマンドパレットの Minimum contrast にも同じ値が用意されています。
| 表示値 | terminal.minimum_contrast | 効果 |
|---|---|---|
| Auto | キーなし | ライト、ダークを問わず、すべてのテーマで APCA Lc 60。 |
| Off | 0 | 補正なし。プログラムが指定した色をそのまま使用します。 |
| 45, 60, 75, 90 | その数値 | 明示的な APCA Lc の目標値。 |
90 を超える値は 90 に制限されます。負の値や無効な値は Auto に戻ります。
補正対象はプログラムが選んだ色だけです。truecolor とパレットインデックス 16 から 255 が該当します。テーマの 16 色の ANSI カラー、前景色、背景色は変更しません。補正ではまず色相を保ちながら明度を調整します。彩度を大きく下げる必要がある場合は、最も近いテーマの色に寄せます。
変更は開いているターミナルにホットリロードされます。すべてのターミナルで補正を無効にするには、paneflow.json の
terminal に "minimum_contrast": 0 を設定します。
スペース
Spaces を開くと、説明文の横に New space ボタンがあり、その下に Default を先頭にしたカードがあります。
Default にはスペースに属さないすべてのワークスペースが入り、Workspaces without a space またはワークスペースの数が表示されます。名前の変更や削除はできません。続いてスペースごとに 1 行が並び、円、名前、ワークスペースと変数の数が表示されます。折りたたまれた行には Agent setup failed や環境変数の警告も表示されます。行をクリックすると展開されます。一度に展開されるスペースは 1 つだけです。
| フィールド | 動作 |
|---|---|
| Name | 名前をクリックして編集し、Enter で保存、Escape でキャンセルします。別の場所をクリックしても保存されます。名前は 1 から 32 文字で、Default は使えず、大文字と小文字の違いを無視して他のスペースと同じ名前にはできません。無効な名前ではフィールドの下に理由が表示され、何も保存されません。 |
| Image | Upload image でファイル選択ダイアログが開きます。スペースの円をクリックしても同じです。画像を設定すると、ボタンは Replace image と Remove image になります。スペースの画像を参照してください。 |
| Color | 色なし、または Red、Green、Yellow、Blue、Magenta、Cyan のいずれか。画像のないスペースは、どのテーマでも同じグラデーションでその色を円に描き、色がなければ輪郭線を描きます。 |
| Environment | スペースの変数の概要と Edit ボタン。スペースの環境変数を参照してください。 |
| Agent setup | スペースが CLAUDE_CONFIG_DIR または CODEX_HOME をデフォルトから変更している場合に表示されます。Claude Code hooks and MCP のようにエージェントごとに 1 行ずつ状態が表示され、エラー後には Retry、未インストールのときは Install が表示されます。 |
展開したスペースの下部にある Delete space は、Delete Work? Its 3 workspaces move to Default. と確認し、Cancel と Delete space を表示します。確定すると、ターミナルを 1 つも閉じずにそのスペースのワークスペースを Default に移し、削除したスペースがアクティブだった場合は Default をアクティブにし、スペースの画像を削除します。
New space は、空いている最小の番号で Space N を追加し、その名前を編集状態にします。サイドバーのスペースメニューの New space… と、コマンドパレットの New space も同じです。スペースが 9 個になるとボタンは無効になり、横に 9 spaces maximum と表示されます。
スペースの画像
画像は、サイドバーのヘッダー、スペースメニュー、Settings で、スペースの円のカラーグラデーションの代わりに表示されます。
PNG、JPEG、WebP、GIF、BMP、TIFF のいずれかで、25 MB 以下、各辺 12,000 ピクセル以下のファイルを選びます。
Paneflow は写真の EXIF の向きを適用し、中央で正方形に切り抜き、96 ピクセルの PNG を Paneflow ホームの avatars/(~/.paneflow/avatars/、Windows では %USERPROFILE%\.paneflow\avatars\)に保存します。ファイル名は paneflow.json のスペースのエントリに avatar として記録されます。読み込めない画像や大きすぎる画像では Image フィールドの下に理由が表示され、スペースは以前の円のままです。画像を置き換えたり削除したりすると、以前のファイルは削除されます。
スペースの環境変数
Environment の下の Edit を押すと、変数ごとに 1 行の編集欄が開きます。値は、そのスペースのワークスペースでそれ以降に開くすべてのターミナルに設定されます。優先順位は terminal.env より上、エージェントプロファイルの env とサーフェス自身の env より下です。先頭の ~ はホームディレクトリを表し、$NAME は Paneflow の環境からその値を取り込みます。行の下に展開後の値が表示されます。
CLAUDE_CONFIG_DIR、CODEX_HOME、GH_CONFIG_DIR を別のディレクトリに向けると、そのスペースで 2 つ目の Claude Code、Codex、GitHub CLI のアカウントを使えます。この 3 つは絶対パスでなければなりません。存在しないディレクトリは、最初のターミナルが起動する前に Paneflow が作成し(Linux と macOS では本人だけがアクセスできる権限で)、作成できなければトーストでそのディレクトリを知らせます。
2 つのアカウントが分離されるのは、各 CLI がそのディレクトリ変数に従う間だけです。また、GH_TOKEN または GITHUB_TOKEN が設定されている間は、GH_CONFIG_DIR は何も分離しません。
Save は次の値を拒否し、その理由を行またはフォームの下に表示します。名前のない値、2 回出てくる名前、変数名として有効でない名前、PANEFLOW_ で始まる名前、TERM など Paneflow がすべてのターミナルに設定する変数、LD_PRELOAD のようにプログラムの読み込み方やエージェントの実行方法を変える変数、CLAUDECODE のようなエージェントのセッションマーカー、CLAUDE_CONFIG_DIR、CODEX_HOME、GH_CONFIG_DIR の相対パス、Paneflow の環境で設定されていない変数を指す $NAME です。
Windows では、ターミナルには名前が大文字に変換されて渡されますが、paneflow.json には入力したとおりの大文字と小文字で保存されます。名前に KEY、TOKEN、SECRET、PASSWORD を含む変数には Stored in plain text in paneflow.json; prefer a config directory と表示されます。
Paneflow 自身の環境で ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、CLAUDE_CODE_OAUTH_TOKEN、OPENAI_API_KEY、GH_TOKEN、GITHUB_TOKEN が設定されていて、スペースがそれを再定義していない場合は、警告が表示されます。これらの変数は、設定ディレクトリに保存されたアカウントより優先されるためです。
開いているターミナルは、起動時の環境を保持します。環境の異なるスペースにワークスペースを移すと Open terminals keep their previous environment と表示され、何も再起動されません。
.zshrc などの rc ファイルで同じ変数を export するシェルでは、そのターミナル内でスペースの値が上書きされます。
スペースが CLAUDE_CONFIG_DIR または CODEX_HOME をデフォルトから変更している場合、保存すると、Settings > Agents でインストール済みの各エージェントについて、Paneflow のフックと MCP ブリッジがそのディレクトリにインストールされます。これにより、サイドバーには引き続きエージェントの作業中と待機中の状態が表示されます。リリースビルドを起動するたびに、Claude Code と Codex のディレクトリの組み合わせごとに 1 回、これらが更新されます。
Agent setup にはエージェントごとの状態が表示され、エラー後には Retry、未インストールのときは Install が表示されます。
スペースを削除しても、そのフックは残ります。削除するには、スペースの CLAUDE_CONFIG_DIR にある settings.json の hooks から "_paneflow_managed": true が付いたエントリを、同じディレクトリの .claude.json から paneflow サーバーを削除し、skills/paneflow-conductor/SKILL.md も削除します。Codex では、CODEX_HOME にある hooks.json から同じエントリを、config.toml から [mcp_servers.paneflow] テーブルを削除します。スペースの記録は ~/.paneflow/integrations/spaces/<space id>/ にあり、これも削除できます。
スペースは作業を整理するためのもので、セキュリティ境界ではありません。すべてのターミナルは引き続きあなたの権限で動作し、paneflow.json の値は、ホームディレクトリを読み取れるものなら何でも読み取れます。
AI access vs MCP
Agents ページは、Paneflow が agent をどう起動するか、信頼された conductor がどれだけ自動化できるかを制御します。
claude_code_bypass_permissions が影響するのは Claude Code の起動だけです。有効にすると、Paneflow は Claude Code を
--permission-mode bypassPermissions 付きで起動します。Codex、OpenCode、
Gemini、MCP の挙動は変わりません。
Plugins は別の運用ページです。同梱の 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.ligatures、terminal.cursor_blink、terminal.env、terminal.scroll_multiplier。Paneflow のすべての build は、固定バージョンを静的リンクした単一のlibghostty-vtエンジンでペインをエミュレートするため、選択できるエンジンはありません。 - 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。