From bb7b1c00fe6babfc0701480436bdbb4c2443ef2e Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Sat, 23 May 2026 18:01:21 +0300 Subject: docs: finalize next release docs --- website/src/content/docs/configuration.mdx | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) (limited to 'website/src/content/docs/configuration.mdx') diff --git a/website/src/content/docs/configuration.mdx b/website/src/content/docs/configuration.mdx index 72dc610c..2fe30027 100644 --- a/website/src/content/docs/configuration.mdx +++ b/website/src/content/docs/configuration.mdx @@ -45,7 +45,7 @@ You can also open the global menu in Herdr and choose `reload config`. Reload applies most UI settings without restarting panes. Startup-only settings still need a restart. -## Default shell +## Terminal defaults Set the executable Herdr uses for newly created interactive panes: @@ -56,6 +56,15 @@ default_shell = "nu" When unset or empty, Herdr uses `$SHELL`, then `/bin/sh`. This is an executable name or path, not a shell command line. Existing panes keep their current shell until they are recreated. Command panes still run through `/bin/sh -c`; detached custom command keybindings use Herdr's existing `/bin/sh -lc` path. +Set the working directory policy for new panes, tabs, and workspaces: + +```toml +[terminal] +new_cwd = "follow" +``` + +`new_cwd = "follow"` keeps the default behavior and inherits the source pane or workspace. Use `"home"` to always start in `$HOME`, `"current"` to use Herdr's process directory, or a fixed path such as `"~/Projects"`. Explicit `--cwd` values from the CLI or socket API still take precedence. + ## Worktrees Set the root directory Herdr uses for Git worktree checkouts created from the sidebar: @@ -65,7 +74,7 @@ Set the root directory Herdr uses for Git worktree checkouts created from the si directory = "~/.herdr/worktrees" ``` -Herdr creates checkouts under `//`. For sibling-style checkouts, set this to a directory such as `~/Projects/herdr-worktrees`. +Herdr creates checkouts under `//`. For sibling-style checkouts, set this to a directory such as `~/Projects/herdr-worktrees`. Relative values are resolved to an absolute path when the app applies the config. Worktree actions are available from Git workspace rows. `New worktree` creates a branch and checkout, opens it as a new Herdr workspace, and groups it under the source workspace. `Open worktree...` lists existing Git worktree checkouts for that repo; choosing an already-open checkout focuses it, and choosing a closed checkout opens it in the same group. -- cgit v1.2.3