Configuration Files
pm7-Terminal stores settings in JSON format for easy editing and theme support.
Main Settings
~/.pm7-Terminal/settings.jsonGhostty Config (auto-synced)
~/.pm7-Terminal/configTheme Files
~/.pm7-Terminal/settings-<theme-name>.jsonSession State
~/.pm7-Terminal/session.jsonGeneral Settings
Default working directory for new terminal windows.
Default: nil (uses home directory)
How to start the terminal - restore previous session or start fresh.
Default: "restore"
Options: "restore", "fresh"
What happens when clicking the red close button.
Default: "askMenu"
Options: "askMenu", "closeTab", "closeWindow"
Shell command to use for new terminals.
Default: "/bin/zsh"
Font Settings
The font family to use for terminal text.
Default: "SF Mono"
Font size in points.
Default: 22.0
Font weight/style for terminal text.
Default: "Light"
Options: "Light", "Regular", "Medium", "Semibold", "Bold"
Letter spacing adjustment in pixels (positive = wider, negative = tighter).
Default: 0
Line spacing adjustment in pixels (positive = taller, negative = shorter).
Default: 0
Color Settings
Terminal background color as hex string.
Default: "#FEFFFF"
Terminal text color as hex string.
Default: "#000000"
Cursor color as hex string.
Default: "#000000"
Selection background color as hex string.
Default: "#4977D8"
Selection text color (nil = auto contrast).
Default: nil
Background opacity (0.0 to 1.0).
Default: 1.0
Enable background blur effect.
Default: false
Blur radius when blur is enabled.
Default: 20
Terminal Padding
Padding settings have two modes: Normal (Command Center visible) and Minimized (Command Center hidden).
Top padding in pixels.
Default: 10
Bottom padding in pixels.
Default: 10
Left padding in pixels.
Default: 10
Right padding in pixels.
Default: 10
Background color for the padding area.
Default: "#FEFFFF"
Corner radius for the terminal content area.
Default: 0
Inner padding between terminal edge and text.
Default: 0
Border color when terminal is focused.
Default: nil (no border)
Border color when terminal is not focused.
Default: nil (no border)
Titlebar Settings
Titlebar background color.
Default: "#F8F8F8"
Divider line color below titlebar.
Default: "#E5E5E5"
Command Center Settings
Whether Command Center is visible.
Default: true
Height of Command Center in pixels (80-400).
Default: 160
Font size for Command Center input (10-24).
Default: 13
Font weight for Command Center input.
Default: "Regular"
Font family for Command Center (nil = system default).
Default: nil
Background color for the input field.
Default: "#FEFFFF"
Border color when input is focused.
Default: nil
Border color when input is not focused.
Default: nil
Text color when input is focused.
Default: nil (system)
Text color when input is not focused.
Default: nil (system)
Background for entire Command Center area (normal mode).
Default: "#F8F8F8"
Background for entire Command Center area (minimized mode).
Default: "#F8F8F8"
Divider between Command Center and terminal (normal mode).
Default: "#E4E4E4"
Divider between Command Center and terminal (minimized mode).
Default: "#E4E4E4"
Top padding for Command Center in pixels.
Default: 7
Bottom padding for Command Center in pixels.
Default: 2
Show AI Actions button in toolbar.
Default: true
Show Execute button in toolbar.
Default: true
Show History button in toolbar.
Default: true
Restore height to normal after executing (when maximized).
Default: true
How to send commands to terminal.
Default: "execute"
Options: "execute" (send + Enter), "paste" (send only)
Whether empty input sends Enter to terminal.
Default: true
AI Settings
Global AI provider settings including API keys for various providers (Anthropic, OpenAI, etc.).
Configured AI actions that appear in the Command Center toolbar.
Window Mode Settings
Lock window position and size.
Default: false
Keep window floating above other windows.
Default: false
Whether window is currently maximized.
Default: false
Normal mode window size/position per monitor configuration.
Maximize mode window size/position per monitor configuration.
Theme Settings
Name of the active theme (matches filename: settings-<name>.json).
Default: "default"
Themes are stored as separate JSON files. Create a theme by saving your current settings or create ~/.pm7-Terminal/settings-mytheme.json manually.