From 74916839d885b9a6b6ce5a7ac056597ddb411294 Mon Sep 17 00:00:00 2001 From: threadweaver Date: Fri, 31 Jul 2026 23:10:37 -0700 Subject: [PATCH] Fixing hardcoded absolute paths. --- BOOTSTRAP.md | 70 +++- home/dot_config/btop/btop.conf | 2 +- home/dot_config/foot/foot.ini | 4 +- home/dot_config/kitty/kitty.conf | 2 +- home/dot_config/nushell/env.nu | 16 +- home/dot_config/zellij/config.kdl | 3 - home/dot_config/zellij/config.kdl.bak | 534 -------------------------- 7 files changed, 66 insertions(+), 565 deletions(-) delete mode 100644 home/dot_config/zellij/config.kdl.bak diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index 5e0d8f1..b4da80a 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -17,12 +17,14 @@ This checklist is assuming an install onto zircadia, my custom bootc image. Thi [ ] Launch kitty [ ] `nu` We have to switch to nu, in order to use nushell commands consistently. [ ] `mkdir ~/.ssh` +[ ] `chmod 700 ~/.ssh` [ ] `cd ~/.ssh` -[ ] `ssh-keygen -K` Repeat for each YubiKey. -[ ] Write a very minimal ssh config for tangled, all you need is to have is: - - `IdentityFile ` +[ ] `ssh-keygen -K` Repeat with exactly one YubiKey inserted at a time, and preserve the identity-handle filenames expected by the encrypted SSH inventory. +[ ] Write a temporary minimal `~/.ssh/config` entry for `Host tangled.org`; all you need is: + - `IdentityFile ` - `IdentitiesOnly true` - `IdentityAgent none` +[ ] `chmod 600 ~/.ssh/config` ## Stage 1: Fetching dotfiles from the remote [ ] `ls ~/.local/share/chezmoi` to see if the directory already exists. @@ -38,9 +40,25 @@ This checklist is assuming an install onto zircadia, my custom bootc image. Thi [ ] `chezmoi apply --dry-run` [ ] Check for any issues with the chezmoi deployment and adjust as needed. -## Stage 3: Applying the dotfiles +## Stage 2.5: Restoring licensed fonts +Proprietary fonts (PragmataPro Mono, Berkeley Mono) cannot live in this public repo, so they are restored from a flash drive before `chezmoi apply` installs the configs that reference them. Doing this before apply means the terminals and DankMaterialShell resolve the real families on first launch instead of caching a fallback. +[ ] Insert and mount the flash drive holding the fonts. +[ ] `let font_source = ""` +[ ] `mkdir ~/.local/share/fonts` +[ ] `let font_files = (glob $"($font_source)/**/*.{otf,ttf}")` +[ ] `if ($font_files | is-empty) { error make {msg: "No .otf or .ttf files found on the font drive"} }` +[ ] `$font_files | each {|font| cp $font ~/.local/share/fonts/ }` +[ ] `glob ~/.local/share/fonts/*.{otf,ttf} | each {|font| chmod 644 $font }` +[ ] `fc-cache --force ~/.local/share/fonts` +[ ] `fc-match "PragmataPro Mono"` Confirm it names PragmataPro Mono, not a fallback. +[ ] `fc-match "Berkeley Mono"` Confirm it names Berkeley Mono, not a fallback. +[ ] Unmount the flash drive. + +## Stage 3: Installing packages and applying the dotfiles +The tracked Nushell configuration invokes `carapace` and `starship` during startup, so restore the Brewfile before launching Nushell normally. +[ ] `nu --no-config-file -c 'use ~/.local/share/chezmoi/home/dot_config/nushell/scripts/dotfiles.nu *; dotfiles packages install'` [ ] `chezmoi apply` -[ ] `nu` This will load the helper scripts by refreshing the environment. +[ ] `nu` This will load the applied configuration and helper scripts. ## Stage 4: Applying secrets Step 1 and Step 3 could be a script. @@ -54,14 +72,15 @@ Step 1 and Step 3 could be a script. ### 4.3 - Create the keys.txt [ ] `glob ~/.config/sops/age/yubikey-*.identity.txt | sort | each {|path| open $path } | str join "\n" | save -f ~/.config/sops/age/keys.txt` [ ] `chmod 600 ~/.config/sops/age/keys.txt` -[ ] `$env.SOPS_AGE_KEY_FILE = $"($env.HOME)/.config/sops/age/keys.txt"` +[ ] Confirm `$env.SOPS_AGE_KEY_FILE` resolves to `~/.config/sops/age/keys.txt`; the tracked Nushell configuration sets it persistently. ### 4.4 - Testing and generating the results of the secrets [ ] `dotfiles secrets ssh --check` to test that the nushell helper scripts are installed, and that the secrets helpers are working. [ ] Assuming that the previous step comes back clean `dotfiles secrets ssh --apply` -[ ] `cat ~/.ssh/config.d/20-sops-hosts.conf` to check that everything was placed properly. +[ ] `ssh-keygen -lf ~/.ssh/authorized_keys` Confirm the expected fleet-key fingerprints are installed without printing the key blobs. +[ ] For each YubiKey, insert only that key and run `ssh -G github.com | lines | where {|line| $line | str starts-with "identityfile " }`; repeat for `tangled.org` and `yggdrasil` and confirm exactly one real identity follows `identityfile none`. +[ ] Test real authentication with each YubiKey: `ssh -T github.com`, `ssh -T tangled.org`, and `ssh yggdrasil`. -## Stage 5: Installing packages and checking parity -[ ] `dotfiles packages install` +## Stage 5: Checking package and dotfile parity [ ] `dotfiles packages check` [ ] `dfs` [ ] `dotfiles audit` @@ -71,13 +90,32 @@ Step 1 and Step 3 could be a script. [ ] `cd ~/Pictures` [ ] `git clone https://github.com/p4rfait/rose-pine-wallpapers.git` [ ] Download the [Rose Pine Cursors](https://github.com/rose-pine/cursors/releases/latest/download/BreezeX-RosePine-Linux.tar.xz) -[ ] `tar -xvf ~/Downloads/BreezeX-RosePine-Linux.tar.xz -C ~/.local/share/icons` If that directory doesn't exist, `mkdir ~/.local/share/icons` and re-run. +[ ] `mkdir ~/.local/share/icons` +[ ] `tar -xvf ~/Downloads/BreezeX-RosePine-Linux.tar.xz -C ~/.local/share/icons` The archive contains the required `BreezeX-RosePine-Linux/` top-level directory. [ ] Download [Rose Pine gtk themes and icons](https://github.com/rose-pine/gtk/releases/latest) [ ] `mkdir ~/.themes` -[ ] `tar -xvf ~/Downloads/gtk3.tar.gz -C ~/.themes` This will probably require the clean up of removing a layer or two of nesting. +[ ] `let gtk_staging = (mktemp --directory --tmpdir "rose-pine-gtk.XXXXXX")` +[ ] `tar -xvf ~/Downloads/gtk3.tar.gz -C $gtk_staging` +[ ] `cp --recursive ($gtk_staging | path join "gtk3" "rose-pine-gtk") ~/.themes/rose-pine-gtk` +[ ] `rm --recursive --force $gtk_staging` [ ] `mkdir ~/.icons` -[ ] `tar -xvf ~/Downloads/rose-pine-icons.tar.gz` -[ ] `mv ~/Downloads/rose-pine-icons/icons/rose-pine-icons ~/.icons/rose-pine-icons` -[ ] Set global Wayland env variables -[ ] Build a distrobox for MEGAsync -[ ] MAYBE: Set up launch arguments for VSCode +[ ] `let icon_staging = (mktemp --directory --tmpdir "rose-pine-icons.XXXXXX")` +[ ] `tar -xvf ~/Downloads/rose-pine-icons.tar.gz -C $icon_staging` +[ ] `cp --recursive ($icon_staging | path join "icons" "rose-pine-icons") ~/.icons/rose-pine-icons` +[ ] `rm --recursive --force $icon_staging` +[ ] Confirm `~/.themes/rose-pine-gtk/index.theme` and `~/.icons/rose-pine-icons/index.theme` exist. +[ ] Persist `QT_QPA_PLATFORM=wayland` and `ELECTRON_OZONE_PLATFORM_HINT=auto` in the graphical session environment. They currently exist only in `~/.bash_profile`, which is not a reliable source for a niri/Nushell login. +[ ] After logging out and back in, confirm both variables are present in the graphical session. +[ ] Build a distrobox for MEGAsync. +[ ] MAYBE: Set up launch arguments for VSCode. + +## Stage 7: Final validation +[ ] Log out and back in so `environment.d`, fonts, cursor settings, and session applications start from the applied state. +[ ] `fc-match "PragmataPro Mono"` and `fc-match "Berkeley Mono"` +[ ] `dotfiles packages check` +[ ] `dfs` +[ ] `dotfiles audit` +[ ] `chezmoi status` +[ ] Confirm Kitty, Foot, DankMaterialShell, GTK, Qt, cursor, wallpaper, and default application behavior. +[ ] Confirm the required changes are reachable from the intended jj bookmark and pushed before relying on this procedure for another machine. +[ ] Perform a disposable fresh clone and dry-run from the pushed bookmark before declaring bootstrap-ready. diff --git a/home/dot_config/btop/btop.conf b/home/dot_config/btop/btop.conf index 761cfca..e93f1e0 100644 --- a/home/dot_config/btop/btop.conf +++ b/home/dot_config/btop/btop.conf @@ -2,7 +2,7 @@ #* Name of a btop++/bpytop/bashtop formatted ".theme" file, "Default" and "TTY" for builtin themes. #* Themes should be placed in "../share/btop/themes" relative to binary or "$HOME/.config/btop/themes" -color_theme = "/var/home/breakerofhalos/.config/btop/themes/rose-pine.theme" +color_theme = "$HOME/.config/btop/themes/rose-pine.theme" #* If the theme set background should be shown, set to False if you want terminal background transparency. theme_background = true diff --git a/home/dot_config/foot/foot.ini b/home/dot_config/foot/foot.ini index 9293d4e..bcb3639 100644 --- a/home/dot_config/foot/foot.ini +++ b/home/dot_config/foot/foot.ini @@ -2,7 +2,7 @@ term=xterm-256color title=foot locked-title=yes app-id=foot -shell=/var/home/linuxbrew/.linuxbrew/bin/fish +shell=/usr/bin/nu font=PragmataPro Mono:size=10 font-bold=PragmataPro Mono:size=10 @@ -13,4 +13,4 @@ font-bold-italic=PragmataPro Mono:size=10 style=block [main] -include=/var/home/breakerofhalos/.config/foot/rose-pine +include=~/.config/foot/rose-pine diff --git a/home/dot_config/kitty/kitty.conf b/home/dot_config/kitty/kitty.conf index 57de43e..520ee53 100644 --- a/home/dot_config/kitty/kitty.conf +++ b/home/dot_config/kitty/kitty.conf @@ -1821,7 +1821,7 @@ color17 #db4b4b #: Advanced {{{ -shell /var/home/linuxbrew/.linuxbrew/bin/nu +shell . #: The shell program to execute. The default value of . means to use #: the value of of the SHELL environment variable or if unset, diff --git a/home/dot_config/nushell/env.nu b/home/dot_config/nushell/env.nu index 5394e76..dab96bd 100644 --- a/home/dot_config/nushell/env.nu +++ b/home/dot_config/nushell/env.nu @@ -20,14 +20,14 @@ ## ${UserConfigDir}/nushell/env.nu $env.PATH = [ - '/home/threadweaver/.local/bin' - '/home/threadweaver/bin' - '/home/threadweaver/.cargo/bin' - '/usr/local/bin' - '/usr/bin' - '/usr/local/sbin' - '/home/linuxbrew/.linuxbrew/bin' - '/home/linuxbrew/.linuxbrew/sbin' + ($env.HOME | path join ".local" "bin") + ($env.HOME | path join "bin") + ($env.HOME | path join ".cargo" "bin") + "/usr/local/bin" + "/usr/bin" + "/usr/local/sbin" + "/home/linuxbrew/.linuxbrew/bin" + "/home/linuxbrew/.linuxbrew/sbin" ] $env.CARAPACE_BRIDGES = 'zsh,fish,bash,inshellisense' # optional diff --git a/home/dot_config/zellij/config.kdl b/home/dot_config/zellij/config.kdl index 1b56113..e83a27c 100644 --- a/home/dot_config/zellij/config.kdl +++ b/home/dot_config/zellij/config.kdl @@ -1,6 +1,3 @@ -// -// THIS FILE WAS AUTOGENERATED BY ZELLIJ, THE PREVIOUS FILE AT THIS LOCATION WAS COPIED TO: /var/home/breakerofhalos/.config/zellij/config.kdl.bak -// keybinds clear-defaults=true { locked { diff --git a/home/dot_config/zellij/config.kdl.bak b/home/dot_config/zellij/config.kdl.bak deleted file mode 100644 index 4e71df6..0000000 --- a/home/dot_config/zellij/config.kdl.bak +++ /dev/null @@ -1,534 +0,0 @@ -theme "rose-pine" - -keybinds clear-defaults=true { - locked { - bind "Ctrl g" { SwitchToMode "normal"; } - } - pane { - bind "left" { MoveFocus "left"; } - bind "down" { MoveFocus "down"; } - bind "up" { MoveFocus "up"; } - bind "right" { MoveFocus "right"; } - bind "c" { SwitchToMode "renamepane"; PaneNameInput 0; } - bind "d" { NewPane "down"; SwitchToMode "normal"; } - bind "e" { TogglePaneEmbedOrFloating; SwitchToMode "normal"; } - bind "f" { ToggleFocusFullscreen; SwitchToMode "normal"; } - bind "h" { MoveFocus "left"; } - bind "i" { TogglePanePinned; SwitchToMode "normal"; } - bind "j" { MoveFocus "down"; } - bind "k" { MoveFocus "up"; } - bind "l" { MoveFocus "right"; } - bind "n" { NewPane; SwitchToMode "normal"; } - bind "p" { SwitchFocus; } - bind "Ctrl p" { SwitchToMode "normal"; } - bind "r" { NewPane "right"; SwitchToMode "normal"; } - bind "s" { NewPane "stacked"; SwitchToMode "normal"; } - bind "w" { ToggleFloatingPanes; SwitchToMode "normal"; } - bind "z" { TogglePaneFrames; SwitchToMode "normal"; } - } - tab { - bind "left" { GoToPreviousTab; } - bind "down" { GoToNextTab; } - bind "up" { GoToPreviousTab; } - bind "right" { GoToNextTab; } - bind "1" { GoToTab 1; SwitchToMode "normal"; } - bind "2" { GoToTab 2; SwitchToMode "normal"; } - bind "3" { GoToTab 3; SwitchToMode "normal"; } - bind "4" { GoToTab 4; SwitchToMode "normal"; } - bind "5" { GoToTab 5; SwitchToMode "normal"; } - bind "6" { GoToTab 6; SwitchToMode "normal"; } - bind "7" { GoToTab 7; SwitchToMode "normal"; } - bind "8" { GoToTab 8; SwitchToMode "normal"; } - bind "9" { GoToTab 9; SwitchToMode "normal"; } - bind "[" { BreakPaneLeft; SwitchToMode "normal"; } - bind "]" { BreakPaneRight; SwitchToMode "normal"; } - bind "b" { BreakPane; SwitchToMode "normal"; } - bind "h" { GoToPreviousTab; } - bind "j" { GoToNextTab; } - bind "k" { GoToPreviousTab; } - bind "l" { GoToNextTab; } - bind "n" { NewTab; SwitchToMode "normal"; } - bind "r" { SwitchToMode "renametab"; TabNameInput 0; } - bind "s" { ToggleActiveSyncTab; SwitchToMode "normal"; } - bind "Ctrl t" { SwitchToMode "normal"; } - bind "x" { CloseTab; SwitchToMode "normal"; } - bind "tab" { ToggleTab; } - } - resize { - bind "left" { Resize "Increase left"; } - bind "down" { Resize "Increase down"; } - bind "up" { Resize "Increase up"; } - bind "right" { Resize "Increase right"; } - bind "+" { Resize "Increase"; } - bind "-" { Resize "Decrease"; } - bind "=" { Resize "Increase"; } - bind "H" { Resize "Decrease left"; } - bind "J" { Resize "Decrease down"; } - bind "K" { Resize "Decrease up"; } - bind "L" { Resize "Decrease right"; } - bind "h" { Resize "Increase left"; } - bind "j" { Resize "Increase down"; } - bind "k" { Resize "Increase up"; } - bind "l" { Resize "Increase right"; } - bind "Ctrl n" { SwitchToMode "normal"; } - } - move { - bind "left" { MovePane "left"; } - bind "down" { MovePane "down"; } - bind "up" { MovePane "up"; } - bind "right" { MovePane "right"; } - bind "h" { MovePane "left"; } - bind "Ctrl h" { SwitchToMode "normal"; } - bind "j" { MovePane "down"; } - bind "k" { MovePane "up"; } - bind "l" { MovePane "right"; } - bind "n" { MovePane; } - bind "p" { MovePaneBackwards; } - bind "tab" { MovePane; } - } - scroll { - bind "e" { EditScrollback; SwitchToMode "normal"; } - bind "s" { SwitchToMode "entersearch"; SearchInput 0; } - } - search { - bind "c" { SearchToggleOption "CaseSensitivity"; } - bind "n" { Search "down"; } - bind "o" { SearchToggleOption "WholeWord"; } - bind "p" { Search "up"; } - bind "w" { SearchToggleOption "Wrap"; } - } - session { - bind "a" { - LaunchOrFocusPlugin "zellij:about" { - floating true - move_to_focused_tab true - } - SwitchToMode "normal" - } - bind "c" { - LaunchOrFocusPlugin "configuration" { - floating true - move_to_focused_tab true - } - SwitchToMode "normal" - } - bind "Ctrl o" { SwitchToMode "normal"; } - bind "p" { - LaunchOrFocusPlugin "plugin-manager" { - floating true - move_to_focused_tab true - } - SwitchToMode "normal" - } - bind "s" { - LaunchOrFocusPlugin "zellij:share" { - floating true - move_to_focused_tab true - } - SwitchToMode "normal" - } - bind "w" { - LaunchOrFocusPlugin "session-manager" { - floating true - move_to_focused_tab true - } - SwitchToMode "normal" - } - } - shared_except "locked" { - bind "Alt left" { MoveFocusOrTab "left"; } - bind "Alt down" { MoveFocus "down"; } - bind "Alt up" { MoveFocus "up"; } - bind "Alt right" { MoveFocusOrTab "right"; } - bind "Alt +" { Resize "Increase"; } - bind "Alt -" { Resize "Decrease"; } - bind "Alt =" { Resize "Increase"; } - bind "Alt [" { PreviousSwapLayout; } - bind "Alt ]" { NextSwapLayout; } - bind "Alt f" { ToggleFloatingPanes; } - bind "Ctrl g" { SwitchToMode "locked"; } - bind "Alt h" { MoveFocusOrTab "left"; } - bind "Alt i" { MoveTab "left"; } - bind "Alt j" { MoveFocus "down"; } - bind "Alt k" { MoveFocus "up"; } - bind "Alt l" { MoveFocusOrTab "right"; } - bind "Alt n" { NewPane; } - bind "Alt o" { MoveTab "right"; } - bind "Alt p" { TogglePaneInGroup; } - bind "Alt Shift p" { ToggleGroupMarking; } - bind "Ctrl q" { Quit; } - } - shared_except "locked" "move" { - bind "Ctrl h" { SwitchToMode "move"; } - } - shared_except "locked" "session" { - bind "Ctrl o" { SwitchToMode "session"; } - } - shared_except "locked" "scroll" "search" "tmux" { - bind "Ctrl b" { SwitchToMode "tmux"; } - } - shared_except "locked" "scroll" "search" { - bind "Ctrl s" { SwitchToMode "scroll"; } - } - shared_except "locked" "tab" { - bind "Ctrl t" { SwitchToMode "tab"; } - } - shared_except "locked" "pane" { - bind "Ctrl p" { SwitchToMode "pane"; } - } - shared_except "locked" "resize" { - bind "Ctrl n" { SwitchToMode "resize"; } - } - shared_except "normal" "locked" "entersearch" { - bind "enter" { SwitchToMode "normal"; } - } - shared_except "normal" "locked" "entersearch" "renametab" "renamepane" { - bind "esc" { SwitchToMode "normal"; } - } - shared_among "pane" "tmux" { - bind "x" { CloseFocus; SwitchToMode "normal"; } - } - shared_among "scroll" "search" { - bind "PageDown" { PageScrollDown; } - bind "PageUp" { PageScrollUp; } - bind "left" { PageScrollUp; } - bind "down" { ScrollDown; } - bind "up" { ScrollUp; } - bind "right" { PageScrollDown; } - bind "Ctrl b" { PageScrollUp; } - bind "Ctrl c" { ScrollToBottom; SwitchToMode "normal"; } - bind "d" { HalfPageScrollDown; } - bind "Ctrl f" { PageScrollDown; } - bind "h" { PageScrollUp; } - bind "j" { ScrollDown; } - bind "k" { ScrollUp; } - bind "l" { PageScrollDown; } - bind "Ctrl s" { SwitchToMode "normal"; } - bind "u" { HalfPageScrollUp; } - } - entersearch { - bind "Ctrl c" { SwitchToMode "scroll"; } - bind "esc" { SwitchToMode "scroll"; } - bind "enter" { SwitchToMode "search"; } - } - renametab { - bind "esc" { UndoRenameTab; SwitchToMode "tab"; } - } - shared_among "renametab" "renamepane" { - bind "Ctrl c" { SwitchToMode "normal"; } - } - renamepane { - bind "esc" { UndoRenamePane; SwitchToMode "pane"; } - } - shared_among "session" "tmux" { - bind "d" { Detach; } - } - tmux { - bind "left" { MoveFocus "left"; SwitchToMode "normal"; } - bind "down" { MoveFocus "down"; SwitchToMode "normal"; } - bind "up" { MoveFocus "up"; SwitchToMode "normal"; } - bind "right" { MoveFocus "right"; SwitchToMode "normal"; } - bind "space" { NextSwapLayout; } - bind "\"" { NewPane "down"; SwitchToMode "normal"; } - bind "%" { NewPane "right"; SwitchToMode "normal"; } - bind "," { SwitchToMode "renametab"; } - bind "[" { SwitchToMode "scroll"; } - bind "Ctrl b" { Write 2; SwitchToMode "normal"; } - bind "c" { NewTab; SwitchToMode "normal"; } - bind "h" { MoveFocus "left"; SwitchToMode "normal"; } - bind "j" { MoveFocus "down"; SwitchToMode "normal"; } - bind "k" { MoveFocus "up"; SwitchToMode "normal"; } - bind "l" { MoveFocus "right"; SwitchToMode "normal"; } - bind "n" { GoToNextTab; SwitchToMode "normal"; } - bind "o" { FocusNextPane; } - bind "p" { GoToPreviousTab; SwitchToMode "normal"; } - bind "z" { ToggleFocusFullscreen; SwitchToMode "normal"; } - } -} - -// Plugin aliases - can be used to change the implementation of Zellij -// changing these requires a restart to take effect -plugins { - about location="zellij:about" - compact-bar location="zellij:compact-bar" - configuration location="zellij:configuration" - filepicker location="zellij:strider" { - cwd "/" - } - plugin-manager location="zellij:plugin-manager" - session-manager location="zellij:session-manager" - status-bar location="zellij:status-bar" - strider location="zellij:strider" - tab-bar location="zellij:tab-bar" - welcome-screen location="zellij:session-manager" { - welcome_screen true - } -} - -// Plugins to load in the background when a new session starts -// eg. "file:/path/to/my-plugin.wasm" -// eg. "https://example.com/my-plugin.wasm" -load_plugins { -} -web_client { - font "monospace" -} - -// Use a simplified UI without special fonts (arrow glyphs) -// Options: -// - true -// - false (Default) -// -// simplified_ui true - -// Choose the theme that is specified in the themes section. -// Default: default -// -// theme "dracula" - -// Choose the base input mode of zellij. -// Default: normal -// -// default_mode "locked" - -// Choose the path to the default shell that zellij will use for opening new panes -// Default: $SHELL -// -// default_shell "fish" - -// Choose the path to override cwd that zellij will use for opening new panes -// -// default_cwd "/tmp" - -// The name of the default layout to load on startup -// Default: "default" -// -// default_layout "compact" - -// The folder in which Zellij will look for layouts -// (Requires restart) -// -// layout_dir "/tmp" - -// The folder in which Zellij will look for themes -// (Requires restart) -// -// theme_dir "/tmp" - -// Toggle enabling the mouse mode. -// On certain configurations, or terminals this could -// potentially interfere with copying text. -// Options: -// - true (default) -// - false -// -// mouse_mode false - -// Toggle having pane frames around the panes -// Options: -// - true (default, enabled) -// - false -// -// pane_frames false - -// When attaching to an existing session with other users, -// should the session be mirrored (true) -// or should each user have their own cursor (false) -// (Requires restart) -// Default: false -// -// mirror_session true - -// Choose what to do when zellij receives SIGTERM, SIGINT, SIGQUIT or SIGHUP -// eg. when terminal window with an active zellij session is closed -// (Requires restart) -// Options: -// - detach (Default) -// - quit -// -// on_force_close "quit" - -// Configure the scroll back buffer size -// This is the number of lines zellij stores for each pane in the scroll back -// buffer. Excess number of lines are discarded in a FIFO fashion. -// (Requires restart) -// Valid values: positive integers -// Default value: 10000 -// -// scroll_buffer_size 10000 - -// Provide a command to execute when copying text. The text will be piped to -// the stdin of the program to perform the copy. This can be used with -// terminal emulators which do not support the OSC 52 ANSI control sequence -// that will be used by default if this option is not set. -// Examples: -// -// copy_command "xclip -selection clipboard" // x11 -// copy_command "wl-copy" // wayland -// copy_command "pbcopy" // osx -// -// copy_command "pbcopy" - -// Choose the destination for copied text -// Allows using the primary selection buffer (on x11/wayland) instead of the system clipboard. -// Does not apply when using copy_command. -// Options: -// - system (default) -// - primary -// -// copy_clipboard "primary" - -// Enable automatic copying (and clearing) of selection when releasing mouse -// Default: true -// -// copy_on_select true - -// Path to the default editor to use to edit pane scrollbuffer -// Default: $EDITOR or $VISUAL -// scrollback_editor "/usr/bin/vim" - -// A fixed name to always give the Zellij session. -// Consider also setting `attach_to_session true,` -// otherwise this will error if such a session exists. -// Default: -// -// session_name "My singleton session" - -// When `session_name` is provided, attaches to that session -// if it is already running or creates it otherwise. -// Default: false -// -// attach_to_session true - -// Toggle between having Zellij lay out panes according to a predefined set of layouts whenever possible -// Options: -// - true (default) -// - false -// -// auto_layout false - -// Whether sessions should be serialized to the cache folder (including their tabs/panes, cwds and running commands) so that they can later be resurrected -// Options: -// - true (default) -// - false -// -// session_serialization false - -// Whether pane viewports are serialized along with the session, default is false -// Options: -// - true -// - false (default) -// -// serialize_pane_viewport false - -// Scrollback lines to serialize along with the pane viewport when serializing sessions, 0 -// defaults to the scrollback size. If this number is higher than the scrollback size, it will -// also default to the scrollback size. This does nothing if `serialize_pane_viewport` is not true. -// -// scrollback_lines_to_serialize 10000 - -// Enable or disable the rendering of styled and colored underlines (undercurl). -// May need to be disabled for certain unsupported terminals -// (Requires restart) -// Default: true -// -// styled_underlines false - -// How often in seconds sessions are serialized -// -// serialization_interval 10000 - -// Enable or disable writing of session metadata to disk (if disabled, other sessions might not know -// metadata info on this session) -// (Requires restart) -// Default: false -// -// disable_session_metadata false - -// Enable or disable support for the enhanced Kitty Keyboard Protocol (the host terminal must also support it) -// (Requires restart) -// Default: true (if the host terminal supports it) -// -// support_kitty_keyboard_protocol false -// Whether to make sure a local web server is running when a new Zellij session starts. -// This web server will allow creating new sessions and attaching to existing ones that have -// opted in to being shared in the browser. -// When enabled, navigate to http://127.0.0.1:8082 -// (Requires restart) -// -// Note: a local web server can still be manually started from within a Zellij session or from the CLI. -// If this is not desired, one can use a version of Zellij compiled without -// `web_server_capability` -// -// Possible values: -// - true -// - false -// Default: false -// -// web_server false -// Whether to allow sessions started in the terminal to be shared through a local web server, assuming one is -// running (see the `web_server` option for more details). -// (Requires restart) -// -// Note: This is an administrative separation and not intended as a security measure. -// -// Possible values: -// - "on" (allow web sharing through the local web server if it -// is online) -// - "off" (do not allow web sharing unless sessions explicitly opt-in to it) -// - "disabled" (do not allow web sharing and do not permit sessions started in the terminal to opt-in to it) -// Default: "off" -// -// web_sharing "off" -// A path to a certificate file to be used when setting up the web client to serve the -// connection over HTTPs -// -// web_server_cert "/path/to/cert.pem" -// A path to a key file to be used when setting up the web client to serve the -// connection over HTTPs -// -// web_server_key "/path/to/key.pem" -/// Whether to enforce https connections to the web server when it is bound to localhost -/// (127.0.0.0/8) -/// -/// Note: https is ALWAYS enforced when bound to non-local interfaces -/// -/// Default: false -// -// enforce_https_for_localhost false - -// Whether to stack panes when resizing beyond a certain size -// Default: true -// -// stacked_resize false - -// Whether to show tips on startup -// Default: true -// -// show_startup_tips false - -// Whether to show release notes on first version run -// Default: true -// -// show_release_notes false - -// Whether to enable mouse hover effects and pane grouping functionality -// default is true -// advanced_mouse_actions false - -// The ip address the web server should listen on when it starts -// Default: "127.0.0.1" -// (Requires restart) -// web_server_ip "127.0.0.1" - -// The port the web server should listen on when it starts -// Default: 8082 -// (Requires restart) -// web_server_port 8082 - -// A command to run (will be wrapped with sh -c and provided the RESURRECT_COMMAND env variable) -// after Zellij attempts to discover a command inside a pane when resurrecting sessions, the STDOUT -// of this command will be used instead of the discovered RESURRECT_COMMAND -// can be useful for removing wrappers around commands -// Note: be sure to escape backslashes and similar characters properly -// post_command_discovery_hook "echo $RESURRECT_COMMAND | sed " -- 2.51.2