diff options
| author | Can Celik <ogulcancelik@gmail.com> | 2026-08-15 15:09:53 +0300 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-08-15 15:09:53 +0300 |
| commit | 15539d3dec40bcc40e6f4bb0eaa4f073ad26b74f (patch) | |
| tree | 2ff7cf0353d3c3228f32d5d7756b45ba2486edb2 /docs/next/website/src | |
| parent | b660cad80450147610091e0e5758faa6276e5983 (diff) | |
feat: make headless terminal size configurable (#2829)
refs #2828
Diffstat (limited to 'docs/next/website/src')
| -rw-r--r-- | docs/next/website/src/content/docs/configuration.mdx | 12 | ||||
| -rw-r--r-- | docs/next/website/src/data/config-reference.json | 18 |
2 files changed, 30 insertions, 0 deletions
diff --git a/docs/next/website/src/content/docs/configuration.mdx b/docs/next/website/src/content/docs/configuration.mdx index 4ba3a07a..9f6a96f3 100644 --- a/docs/next/website/src/content/docs/configuration.mdx +++ b/docs/next/website/src/content/docs/configuration.mdx @@ -50,6 +50,18 @@ 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. +## Headless terminal size + +When no client is attached, the server uses a 120×40 virtual terminal for layout and newly created panes. Change that fallback for headless orchestration with: + +```toml +[server] +headless_cols = 160 +headless_rows = 50 +``` + +An attached client remains authoritative for the shared runtime size. After it detaches, existing pane PTYs retain their last attached size while new headless layout uses the configured fallback. + ## Terminal defaults Set the executable Herdr uses for newly created interactive panes: diff --git a/docs/next/website/src/data/config-reference.json b/docs/next/website/src/data/config-reference.json index c16db7a1..a2f8d7a1 100644 --- a/docs/next/website/src/data/config-reference.json +++ b/docs/next/website/src/data/config-reference.json @@ -13,6 +13,24 @@ ] }, { + "id": "server", + "title": "Server", + "keys": [ + { + "key": "server.headless_cols", + "type": "integer", + "default": "120", + "description": "Virtual terminal width used for layout and newly created panes when no client is attached. Must be greater than zero." + }, + { + "key": "server.headless_rows", + "type": "integer", + "default": "40", + "description": "Virtual terminal height used for layout and newly created panes when no client is attached. Must be greater than zero." + } + ] + }, + { "id": "theme", "title": "Theme", "keys": [ |