path: root/tmuxrdr/config/config.toml

# tmuxrdr's herdr config: herdr aligned with tmux -- this machine's
# dot/config/tmux.conf plus ~/.tmux.conf.local over tmux 3.7c's defaults.
# Every entry quotes the tmux line it mirrors; defaults are left explicit
# where they already agree. ~/.config/tmuxrdr/config.toml is a link to this
# file (tmuxrdr/scripts/install), so tmuxrdr reads it -- and its settings
# screen writes it, in place -- here, under git. Stock herdr reads
# ~/.config/herdr/config.toml, untouched by any of this. Apply edits to a
# running tmuxrdr with prefix+r (or tmuxrdr server reload-config).

# First-run onboarding already done.
onboarding = false

[theme]
# tmux's colours come from ~/.local/share/tmux/color.conf, which bin/theme
# generates from the host terminal's palette. herdr's "terminal" theme follows
# the host terminal's ANSI palette directly -- same source, no generated file.
name = "terminal"
auto_switch = false

[terminal]
# tmux runs its panes' shells as login shells (default-command empty). herdr
# "auto" is login shells on macOS -- the same; --login runs ~/.zprofile, which
# restores PATH order after macOS rebuilds it.
shell_mode = "auto"
# tmux.conf: bind-key c new-window -c "#{pane_current_path}" -- and % and "
# likewise. New windows and splits start where the pane is. herdr "follow"
# inherits the source pane/workspace cwd.
new_cwd = "follow"

[keys]
# tmux.conf: set-option -g prefix C-b -- herdr's default prefix, left explicit.
prefix = "ctrl+b"

# tmux's default: prefix+d detaches. herdr's default is prefix+q; take tmux's.
detach = "prefix+d"

# tmux.conf: bind r source-file ~/.tmux.conf \; display-message "Config
# reloaded..." -- prefix+r reloads. herdr's default is prefix+shift+r; take
# tmux's.
reload_config = "prefix+r"

# prefix+r above was herdr's resize mode; moved here. tmux has no resize mode
# at all -- it resizes directly on prefix+C-arrows / prefix+M-arrows, below.
resize_mode = "prefix+ctrl+r"

# tmux's default: prefix+M-arrow resizes the pane by 5 cells (resize-pane -L 5,
# ...). herdr resizes by a fraction of the area, not cells; its native step is
# 0.05 -- about 5 cells of a 100-column pane. prefix+C-arrow, tmux's 1-cell
# resize, is a custom command with a 0.01 step at the end of [keys]. tmux
# repeats both (-r) without re-pressing the prefix; herdr's prefix is one-shot.
resize_pane_left = "prefix+alt+left"
resize_pane_down = "prefix+alt+down"
resize_pane_up = "prefix+alt+up"
resize_pane_right = "prefix+alt+right"

# tmux.conf: bind h select-pane -L (and j/k/l -D/-U/-R); tmux's default:
# prefix+arrow does the same (select-pane -L, ...).
focus_pane_left = ["prefix+h", "prefix+left"]
focus_pane_down = ["prefix+j", "prefix+down"]
focus_pane_up = ["prefix+k", "prefix+up"]
focus_pane_right = ["prefix+l", "prefix+right"]

# tmux.conf: bind-key c new-window -c ... -- herdr's default already.
new_tab = "prefix+c"

# tmux's default: prefix+n / prefix+p next/previous window -- herdr's defaults.
next_tab = "prefix+n"
previous_tab = "prefix+p"

# tmux.conf: set-option -g base-index 1 -- windows number from 1, so prefix+1
# is the first window. herdr's prefix+1..9 counts tabs by their place in the
# tab bar, from 1, and an unnamed tab shows that place -- tmux with
# renumber-windows on, where this tmux leaves gaps after a close (tmuxrdr/ROADMAP.md).
# prefix+0 is the plugin's select-window-0 below: nothing at index 0 under
# base-index 1, in tmux and here.
switch_tab = "prefix+1..9"

# tmux's default: prefix+, renames the window. herdr's default is
# prefix+shift+t; take tmux's comma.
rename_tab = "prefix+comma"

# tmux's sessions are herdr's workspaces, its windows herdr's tabs.
# tmux's default: prefix+$ renames the session; herdr's prefix+shift+w kept.
rename_workspace = ["prefix+$", "prefix+shift+w"]
# tmux's default: prefix+( / prefix+) previous / next session.
previous_workspace = "prefix+("
next_workspace = "prefix+)"

# tmux's default: prefix+s chooses a session (choose-tree -Zs) -- herdr's
# workspace picker, moved here from prefix+w.
workspace_picker = "prefix+s"
# tmux's default: prefix+w chooses a window (choose-tree -Zw) and prefix+f finds
# one by name; herdr's navigator lists every tab and pane, with / to search.
# prefix+q (display-panes) shows numbers to jump by in tmux -- the navigator is
# the nearest herdr has (tmuxrdr/ROADMAP.md). herdr's own prefix+g kept.
goto = ["prefix+w", "prefix+f", "prefix+q", "prefix+g"]
# tmux's default: prefix+C (customize-mode) -- herdr's settings, moved from
# prefix+s.
settings = "prefix+C"
# tmux's default: prefix+? lists the keys, prefix+/ describes one; herdr's help
# lists them and filters with /.
help = ["prefix+?", "prefix+/"]

# tmux's default: prefix+o selects the next pane; herdr's prefix+tab kept.
cycle_pane_next = ["prefix+o", "prefix+tab"]
# herdr's "jump to the notification" was on prefix+o; tmux has nothing on a.
open_notification_target = "prefix+a"

# tmux's default: prefix+M-n / prefix+M-p go to the next / previous window
# with an alert. herdr's alerts are agents waiting or done, and these walk the
# agent list -- close, not the same.
next_agent = "prefix+alt+n"
previous_agent = "prefix+alt+p"

# herdr's directional swaps sat on prefix+shift+h/j/k/l, and tmux's prefix+L
# (switch-client -l, the plugin's last-session below) needs shift+l. tmux binds
# no directional swap; its prefix+{ / prefix+} swap by pane order, below.
swap_pane_left = "prefix+alt+h"
swap_pane_down = "prefix+alt+j"
swap_pane_up = "prefix+alt+k"
swap_pane_right = "prefix+alt+l"

# tmux's default copy-mode binding ([), vi keys inside it (mode-keys vi): v
# begins a selection, y copies to the clipboard -- herdr's copy mode is
# vi-style by default with the same keys.
copy_mode = "prefix+["

# tmux.conf: bind V send-keys C-c C-u 'tmux capture-pane -Jp -S- | vim -'
# Enter -- the whole scrollback in the editor. herdr's equivalent opens the
# pane scrollback in $EDITOR; same key as tmux's V.
edit_scrollback = "prefix+shift+v"

# tmux.conf rebinds % (side by side) and " (stacked), both with
# -c "#{pane_current_path}". tmux's own keys: herdr's parser takes named
# punctuation far past the docs' example list (src/config/keybinds.rs:
# "percent" -> '%', "double_quote" -> '"', "quote" -> '\'') and bare
# characters too, and its matcher maps both input encodings onto them --
# legacy terminals deliver the literal char, kitty-protocol ones deliver
# shift+5 / shift+' with the shifted codepoint (shifted_char_matches_expected).
# herdr's v kept alongside (tmux leaves prefix+v unbound); its minus is not,
# being tmux's prefix+- (delete-buffer). tmux 3.7's prefix+* (new-pane) splits
# the current pane stacked, as " does.
split_vertical = ["prefix+%", "prefix+v"]
split_horizontal = ["prefix+\"", "prefix+*"]

# tmux's default: prefix+; jumps back to the previously focused pane
# (select-pane -l). Semicolon is a named key too; herdr's last_pane is unset
# by default, so tmux's takes it.
last_pane = "prefix+;"

# tmux's default: prefix+z zooms the pane -- herdr's default already.
zoom = "prefix+z"

# tmux's default: prefix+x kills the pane after asking (confirm-before). herdr
# closes without asking, so its binding is cleared and prefix+x is the plugin's
# (y/n) popup below. herdr's own closes stay in the pane's right-click menu.
close_pane = ""

# tmux's default: prefix+C-arrow resizes the pane by 1 cell (resize-pane -L,
# ...). herdr's CLI resizes by a fraction of the area; 0.01 is about one cell
# of a 100-column pane, keeping tmux's 1:5 ratio against prefix+M-arrow above.
# tmux.conf's bind-key C-b send-prefix needs nothing: in herdr, pressing the
# prefix twice sends a literal prefix (src/client/shell/input.rs).
[[keys.command]]
key = "prefix+ctrl+left"
type = "shell"
command = '"$HERDR_BIN_PATH" pane resize --direction left --amount 0.01 --pane "$HERDR_ACTIVE_PANE_ID"'
description = "resize pane left 1 cell (tmux C-Left)"

[[keys.command]]
key = "prefix+ctrl+down"
type = "shell"
command = '"$HERDR_BIN_PATH" pane resize --direction down --amount 0.01 --pane "$HERDR_ACTIVE_PANE_ID"'
description = "resize pane down 1 cell (tmux C-Down)"

[[keys.command]]
key = "prefix+ctrl+up"
type = "shell"
command = '"$HERDR_BIN_PATH" pane resize --direction up --amount 0.01 --pane "$HERDR_ACTIVE_PANE_ID"'
description = "resize pane up 1 cell (tmux C-Up)"

[[keys.command]]
key = "prefix+ctrl+right"
type = "shell"
command = '"$HERDR_BIN_PATH" pane resize --direction right --amount 0.01 --pane "$HERDR_ACTIVE_PANE_ID"'
description = "resize pane right 1 cell (tmux C-Right)"

# The rest of tmux's default prefix table, from tmuxrdr's tmux-mode plugin
# (tmuxrdr/plugin), which tmuxrdr/scripts/install links as
# ~/.local/share/tmuxrdr/plugin -- the stable path the popups below run from --
# and registers with `tmuxrdr plugin link`. Each
# script there says what of tmux it reproduces and how. Popups stand in for
# tmux's status-line prompts; toasts for its status-line messages.

[[keys.command]]
key = "prefix+!"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.break-pane"
description = "break-pane (tmux !)"

[[keys.command]]
key = "prefix+0"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.select-window-0"
description = "select-window -t :=0 (tmux 0)"

[[keys.command]]
key = "prefix+'"
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/select-window"'
width = 30
height = 3
description = "select-window by index (tmux ')"

[[keys.command]]
key = "prefix+."
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/move-window"'
width = 30
height = 3
description = "move-window to an index (tmux .)"

[[keys.command]]
key = "prefix+{"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.swap-prev"
description = "swap-pane -U (tmux {)"

[[keys.command]]
key = "prefix+}"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.swap-next"
description = "swap-pane -D (tmux })"

[[keys.command]]
key = "prefix+ctrl+o"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.rotate-up"
description = "rotate-window (tmux C-o)"

[[keys.command]]
key = "prefix+alt+o"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.rotate-down"
description = "rotate-window -D (tmux M-o)"

[[keys.command]]
key = "prefix+m"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.mark"
description = "select-pane -m, toggle mark (tmux m)"

[[keys.command]]
key = "prefix+M"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.clear-mark"
description = "select-pane -M, clear mark (tmux M)"

# tmux's prefix+l (last-window) is this tmux.conf's select-pane -R, so it has
# no key in either; tmuxrdr.tmux-mode.last-window and the : prompt still have it.
[[keys.command]]
key = "prefix+L"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.last-session"
description = "switch-client -l (tmux L)"

[[keys.command]]
key = "prefix+]"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.paste-buffer"
description = "paste-buffer -p (tmux ])"

[[keys.command]]
key = "prefix+i"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.display-message"
description = "display-message (tmux i)"

[[keys.command]]
key = "prefix+E"
type = "plugin_action"
command = "tmuxrdr.tmux-mode.spread-layout"
description = "select-layout -E (tmux E)"

[[keys.command]]
key = "prefix+x"
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/confirm-kill" pane'
width = 30
height = 3
description = "kill-pane, after y/n (tmux x)"

[[keys.command]]
key = "prefix+&"
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/confirm-kill" window'
width = 40
height = 3
description = "kill-window, after y/n (tmux &)"

[[keys.command]]
key = "prefix+:"
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/command-prompt"'
width = "70%"
height = 12
description = "command-prompt (tmux :)"

[[keys.command]]
key = "prefix+t"
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/clock-mode"'
width = "60%"
height = 11
description = "clock-mode (tmux t)"

[[keys.command]]
key = "prefix+~"
type = "popup"
command = 'sh "$HOME/.local/share/tmuxrdr/plugin/bin/show-messages"'
width = "90%"
height = "90%"
description = "show-messages (tmux ~)"

[ui]
# tmux.conf: set-option -g mouse on -- herdr's default, left explicit.
mouse_capture = true

# Mouse selections copy on release, herdr's default -- a deliberate departure
# from this tmux.conf. In tmux a drag enters copy mode (MouseDrag1Pane ->
# copy-mode -M), and the tmux.conf unbinds copy-mode-vi MouseDragEnd1Pane so
# the selection stays there until y copies it. herdr's mouse selection is not
# copy mode: y would go to the pane, and only Ctrl+C copies a kept selection.
# Until tmuxrdr makes a drag enter copy mode (ROADMAP.md), release copies. The
# keyboard is tmux's either way: prefix+[, v, y.
copy_on_select = true

# tmux.conf: WheelUp/DownPane -N 3 scroll -- "3 lines at a time instead of
# default 5". herdr's default is already 3, left explicit.
mouse_scroll_lines = 3

# tmux's status line sits at the bottom of the screen; herdr draws its tab bar
# at the top by default. Bottom, like tmux.
tab_bar_position = "bottom"

# tmux's status line, drawn by tmuxrdr's own ui.tab_style
# (src/client/shell/tabs_tmux.rs): "[session] 1:name* 2:name- 3:name ",
# window-status-format "#I:#W#{?window_flags,#{window_flags}, }", plain text
# one space apart, the session cut to status-left-length 10, tabs nobody named
# called after their pane's directory (this tmux.conf's automatic-rename-format
# '#{b:pane_current_path}'). herdr's own style draws padded blocks, and shows
# a named tab's name without its number.
tab_style = "tmux"

# tmux.conf: set-option -g status-right '#h %a %d-%b %H:%M', replaced by
# ~/.tmux.conf.local with '%d-%b %H:%M' -- day-month and time at the right edge
# of the status line. herdr's tab_bar_right is the same right-hand slot.
# { type = "hostname" } first, if ever the hostname is wanted back.
tab_bar_right = [
    { type = "datetime", format = "%d-%b %H:%M" },
]

# tmux always shows its status line; herdr's default already does the same.
hide_tab_bar_when_single_tab = false

# tmux's new-window never asks for a name; herdr asks by default.
prompt_new_tab_name = false

# tmux.conf: automatic-rename on, automatic-rename-format
# '#{b:pane_current_path}', status-interval 5 -- windows name themselves after
# their pane's directory. tab_style = "tmux" above already shows tabs that way,
# in this client. herdr itself names no tab: everywhere else -- the navigator,
# the CLI -- an unnamed tab is its number. tmux-mode's bin/automatic-rename
# gives tabs real names on the server, a manual rename switching it off for
# that tab as in tmux, run every 5 s as a tab_bar_right command entry that
# prints nothing. Not in tab_bar_right above; to have it, add this entry
# there:
#   { type = "command", command = "sh ~/.local/share/tmuxrdr/plugin/bin/automatic-rename", interval_seconds = 5, timeout_seconds = 4 }

# tmux draws pane borders only when a window is split; a lone pane has none.
# herdr's "auto" is the same.
pane_borders = "auto"

# tmux panes share thin divider lines: no gaps, no frame around the pane
# area. herdr's config reference names this exact combination "tmux-style
# internal splitters without an outside frame".
pane_gaps = false
pane_outer_borders = false

# tmux has no scrollbars beside its panes.
pane_scrollbars = false

# tmux never writes the outer terminal's title (set-titles off by default,
# left off) -- and the terminals pin their own titles anyway
# (dynamic_title = false / title =). Empty leaves the outer title alone.
# window_title = ""

# tmux.conf: set-window-option -g monitor-activity on -- other windows'
# activity shows as marks in the status line. herdr's equivalent is the live
# agent state in the sidebar and tab bar; "symbols" distinguishes
# blocked/working/done by shape as well as colour.
status_indicators = "symbols"

[ui.toast]
# tmux.conf: set-option -g visual-activity on -- a status-line message the
# moment another window turns active. herdr's in-app toast for background
# agents finishing or needing input is the closest match; 0 sends it
# immediately, like tmux, rather than after the default 1s debounce.
delivery = "herdr"
# delay_seconds = 0

[update]
# tmuxrdr is built from this checkout (tmuxrdr/scripts/build); herdr's update
# would download stock herdr over it. No background checks for a release it
# must not install, then -- a new herdr arrives through scripts/sync-upstream.
# Agent-detection manifest updates (manifest_check) stay on.
version_check = false

[ui.sound]
# No tmux counterpart -- tmux is silent. Kept from this machine's existing
# config rather than from tmux; delete this block for strict tmux behaviour.
enabled = true

# [advanced]
# # tmux.conf: set-option -g history-limit 100000. tmux counts lines, herdr
# # bytes: 100000 lines of a ~250-byte average line ≈ 25 MB. herdr's default is
# # 10 MB ("matches Ghostty's default scrollback-limit behaviour"); this is the
# # tmux-sized version.
# scrollback_limit_bytes = 25000000

# [server]
# # A tmux session with no client attached is 80x24 until a client reattaches
# # and everything reflows. herdr's headless fallback is 120x40 by default;
# # tmux's.
# headless_cols = 80
# headless_rows = 24

# [experimental]
# # tmux scrollback dies with the server. herdr can persist pane screen history
# # across restarts; off, like tmux.
# pane_history = false

# --- tmux.conf lines with no herdr 0.9.3 equivalent -----------------------
# set -g focus-events on -- no switch; herdr forwards what it can itself.
# set -g exit-unattached off / destroy-unattached off -- inherent: the server
#   and every pane keep running with no client attached; nothing to configure.
# set -g escape-time 0 -- no input-delay switch.
# set-window-option -g aggressive-resize on -- no switch; herdr already sizes
#   each tab to the client that most recently focused or interacted with it
#   (the per-session smallest client is not herdr's model), which is the same
#   intent.
# bind ` setw synchronize-panes -- no broadcast/synchronize-panes equivalent;
#   tmuxrdr/ROADMAP.md in the tmuxrdr repo has it with the other fork-only gaps.
# ctrl+d on the last pane: tmux exits its client and, under exec tmux, the
#   terminal window closes. herdr closes the pane, its tab and its workspace,
#   then opens a fresh workspace when the session has none -- the client and
#   the server both stay up, the window stays open (verified on 0.9.3). No
#   config key changes that; `herdr server stop` is the only full teardown.
# set -g status-interval 5 -- no equivalent; the datetime above is live and
#   command entries take their own interval_seconds.
# set -g allow-rename off -- no switch; apps cannot rename herdr tabs anyway.
# set -g status-keys emacs -- herdr's own text fields are emacs-style by
#   default (ctrl+a/e etc.).
# default-terminal / terminal-features / terminal-overrides / allow-passthrough
#   / extended-keys -- herdr owns the emulation and negotiates with the outer
#   terminal itself; there is nothing to configure from inside.
# set -wg mode-style ... -- no copy-mode selection colour key; the "terminal"
#   theme above follows the host palette instead.