Paneflow's settings panel groups everything you can tune into four
tabs — Shortcuts, Appearance, AI agents, and Terminal. Every option is also
written to [`paneflow.json`](/docs/configuration), so you can edit it by
hand and hot-reload the change the moment you save.

  ## Keyboard shortcuts [#keyboard-shortcuts]

  The Shortcuts tab lists every action and its current binding — splits,
  focus moves, workspace switches, copy path, reveal in file manager, and
  the "open in editor" commands for Zed, Cursor, VS Code, and Windsurf.
  Rebind any action, or hit **Reset to defaults** to roll back. The same
  bindings live under `shortcuts` in
  [`paneflow.json`](/docs/keybindings).

  ## Appearance [#appearance]

  Pick the terminal font from any monospace family installed on your
  machine — the picker enumerates them via fontconfig on Linux and Core
  Text on macOS — or stick with the embedded defaults: IBM Plex Mono
  (the out-of-the-box terminal font) and Lilex, the ligature-friendly
  alternate. Font and theme both hot-reload from
  [`paneflow.json`](/docs/themes) the instant you save, so you can tune
  the look without restarting.

  ## AI agents [#ai-agents]

  Toggle which agents get a one-click launch button in the workspace bar
  — Claude Code, Codex, OpenCode, Pi, Hermes, Openclaw, Factory's Droid,
  and more. Flip **Bypass permissions** when you want an agent to skip its
  approval prompts, and enable **Read your panes from your agents** to let
  an agent inspect what another pane printed through Paneflow's MCP server
  (list, read, and search panes).

  ## Terminal [#terminal]

  Tune how the terminal itself behaves: default cursor shape and blink,
  how a BEL is surfaced (visual flash, OS sound, both, or off), scrollback
  history per terminal (default 10,000 lines, configurable from 100 to
  100,000 via [`terminal.scrollback_lines`](/docs/configuration/schema#how-do-i-set-terminalscrollback_lines)),
  font size and line height (both hot-reload),
  programming-font ligatures, and Option as Meta for Alt/Option chords.
  Settings that affect the emulator take effect on the next new terminal;
  the display ones apply the moment you change them.

## The paneflow\.json file [#the-paneflowjson-file]

Every option in the panel maps to a key in `paneflow.json`. Edit the
file directly for anything not surfaced in the UI, or to version your
setup alongside your dotfiles. The schema ships with every release, so a
schema-aware editor autocompletes and type-checks your config. See
[Configuration](/docs/configuration) for the file location, the JSON
schema, and what every key does.

## See also [#see-also]

* [Keybindings](/docs/keybindings) — the 23 default shortcuts and the action name for every `paneflow.json` override.
* [Themes](/docs/themes) — the bundled One Dark theme, the 36 terminal color slots, and hot-reload.
* [Configuration](/docs/configuration) — where `paneflow.json` lives and what every key does.