Server settings¶
Edit ~/.config/graffitty/server.toml (or $XDG_CONFIG_HOME/graffitty/server.toml).
These settings apply to the server, including its remote clients.
Shell¶
[terminal]
shell = ["/bin/zsh"]
shell_integration = true
[terminal.environment]
EDITOR = "nvim"
[terminal.limits]
scrollback_bytes = 50000000 # 50 MB per terminal
- Windows: use
shell = ["pwsh.exe", "-NoLogo"]. - Default shell: your
SHELLon Unix; PowerShell on Windows. - Login shell: add
login_shell = falseto disable it on Unix. - New panes: inherit the current pane's working directory.
- Shell and scrollback changes apply to new terminals.
Fonts¶
Change fonts immediately with Edit () → Fonts. No restart is needed.
To set the startup defaults in server.toml:
[terminal.font]
family = "JetBrainsMono Nerd Font Mono"
size = 16
fallbacks = ["Noto Sans CJK KR"]
line_height = 1.0
column_width = 1.0
ligatures = true
- Install fonts on the server. Remote clients download and cache missing fonts automatically.
- Omit
familyto use bundled JetBrains Mono Nerd Font. - Omit
fallbacksto choose an available CJK font automatically. Emoji and math fonts are bundled.
To use font files instead of an installed family:
[terminal.font]
paths = ["fonts/Regular.ttf", "fonts/Bold.ttf", "fonts/Italic.ttf", "fonts/BoldItalic.ttf"]
Paths are relative to server.toml. You can supply just the regular face.
Other server preferences¶
Automatic checkpoints¶
Enabled by default. See checkpoints for what they can recover.
Workspace changes, agent session starts and ends, and server shutdown also trigger a save.
interval_seconds is also the least spacing between history entries; see Checkpoint settings.
CPU percentage¶
all_cores: 100% means all cores are busy.one_core: 100% means one core is busy; four busy cores show 400%.
Filetree¶
The default uses bundled Neovim. To use your own configuration:
See Filetree for customization.
Pane navigation¶
Enable Ctrl+H/J/K/L navigation from the shell and filetree:
[navigator]
enabled = true
filetree = true
algorithm = "spatial"
[navigator.bindings]
"ctrl+h" = "left"
"ctrl+j" = "down"
"ctrl+k" = "up"
"ctrl+l" = "right"
For navigation inside editors and tmux, see Neovim and tmux.
Reload server configuration¶
Changes made directly in server.toml load when the server starts. To reload it
while keeping terminals running:
Save a checkpoint first with gft checkpoint save.
After restarting, verify that the server returned and sessions survived.
If restart fails, do not kill the server or close sessions to work around it.
Font changes through the Fonts dialog apply immediately.
Other settings¶
- Chromium profiles: keep logins or start from a template.
- Dictation: configure a transcription provider.
- Remote access: connect another device.
- Full example: additional limits, fonts, and environment overrides.