Settings

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, so you can edit it by hand and hot-reload the change the moment you save.

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.

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 the instant you save, so you can tune the look without restarting.

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

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), 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

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 for the file location, the JSON schema, and what every key does.

See also

• Keybindings — the 23 default shortcuts and the action name for every paneflow.json override.
• Themes — the bundled One Dark theme, the 36 terminal color slots, and hot-reload.
• Configuration — where paneflow.json lives and what every key does.