From 5b91dae12ffa09f5842a0c852ef06299c31fe342 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Tue, 14 Jul 2026 20:40:11 +0300 Subject: feat: configure sidebar entry gaps --- docs/next/website/src/content/docs/configuration.mdx | 4 ++++ docs/next/website/src/content/docs/ja/configuration.mdx | 4 ++++ docs/next/website/src/content/docs/zh-cn/configuration.mdx | 4 ++++ docs/next/website/src/data/config-reference.json | 12 ++++++++++++ 4 files changed, 24 insertions(+) (limited to 'docs/next/website/src') diff --git a/docs/next/website/src/content/docs/configuration.mdx b/docs/next/website/src/content/docs/configuration.mdx index 9455f8c3..01d82547 100644 --- a/docs/next/website/src/content/docs/configuration.mdx +++ b/docs/next/website/src/content/docs/configuration.mdx @@ -236,12 +236,14 @@ The expanded desktop sidebar renders each inner array in `rows` as one line. The ```toml [ui.sidebar.agents] +row_gap = 0 rows = [ ["state_icon", "workspace", "tab"], ["agent"], ] [ui.sidebar.spaces] +row_gap = 0 rows = [ ["state_icon", "workspace"], ["branch", "git_status"], @@ -271,6 +273,8 @@ Space rows accept these built-in tokens: Tokens render in their configured order. Herdr normally separates adjacent values with ` · ` and uses a single space after `state_icon`. Missing values and their separators disappear; a row disappears when none of its tokens have a value. Each layout may contain at most 16 rows, with at most 16 tokens in each row. +`row_gap` controls the blank terminal rows between entries, independently for the Agent and Space panels. It defaults to `0`, which packs entries together; set it to `1` to restore the previous spacing. It does not add spacing between the content lines declared in `rows`. Consecutive indented worktree children remain packed as one Space group. + Override the complete Agent layout for a known agent under `rows_by_agent`: ```toml diff --git a/docs/next/website/src/content/docs/ja/configuration.mdx b/docs/next/website/src/content/docs/ja/configuration.mdx index ffc142f4..7105efcd 100644 --- a/docs/next/website/src/content/docs/ja/configuration.mdx +++ b/docs/next/website/src/content/docs/ja/configuration.mdx @@ -235,12 +235,14 @@ yellow = "#f9e2af" ```toml [ui.sidebar.agents] +row_gap = 0 rows = [ ["state_icon", "workspace", "tab"], ["agent"], ] [ui.sidebar.spaces] +row_gap = 0 rows = [ ["state_icon", "workspace"], ["branch", "git_status"], @@ -270,6 +272,8 @@ Space の行では、次の組み込みトークンを使えます: トークンは設定された順序で描画されます。Herdr は通常、隣接する値を ` · ` で区切り、`state_icon` の後には空白を 1 つ入れます。値がない場合、その値と区切りは表示されません。すべてのトークンに値がない行は表示されません。各レイアウトは最大 16 行、各行は最大 16 トークンです。 +`row_gap` は、Agent パネルと Space パネルごとに、エントリ間の空白行数を指定します。デフォルトは `0` で、エントリを詰めて表示します。以前の間隔に戻すには `1` に設定します。`rows` で定義したコンテンツ行の間隔には影響しません。連続するインデントされた worktree の子は、1 つの Space グループとして詰めて表示されます。 + 既知のエージェントについて Agent の完全なレイアウトを上書きするには、`rows_by_agent` を使います: ```toml diff --git a/docs/next/website/src/content/docs/zh-cn/configuration.mdx b/docs/next/website/src/content/docs/zh-cn/configuration.mdx index ccf6c312..8a232cc7 100644 --- a/docs/next/website/src/content/docs/zh-cn/configuration.mdx +++ b/docs/next/website/src/content/docs/zh-cn/configuration.mdx @@ -235,12 +235,14 @@ yellow = "#f9e2af" ```toml [ui.sidebar.agents] +row_gap = 0 rows = [ ["state_icon", "workspace", "tab"], ["agent"], ] [ui.sidebar.spaces] +row_gap = 0 rows = [ ["state_icon", "workspace"], ["branch", "git_status"], @@ -270,6 +272,8 @@ Space 行支持以下内置 token： token 会按配置顺序渲染。Herdr 通常使用 ` · ` 分隔相邻值，并在 `state_icon` 后使用一个空格。缺失值及其分隔符会消失；当一行中的所有 token 都没有值时，该行会消失。每个布局最多可包含 16 行，每行最多可包含 16 个 token。 +`row_gap` 分别控制 Agent 和 Space 面板中条目之间的空白终端行数。默认值为 `0`，会紧密排列条目；设为 `1` 可恢复之前的间距。它不会在 `rows` 声明的内容行之间添加间距。连续缩进的 worktree 子项仍会作为一个 Space 组紧密排列。 + 在 `rows_by_agent` 下为已知智能体覆盖完整的 Agent 布局： ```toml diff --git a/docs/next/website/src/data/config-reference.json b/docs/next/website/src/data/config-reference.json index f84e6da1..65a6f29e 100644 --- a/docs/next/website/src/data/config-reference.json +++ b/docs/next/website/src/data/config-reference.json @@ -668,6 +668,12 @@ "priority" ] }, + { + "key": "ui.sidebar.agents.row_gap", + "type": "integer", + "default": "0", + "description": "Blank terminal rows between expanded Agent sidebar entries. Set to 1 to restore the previous spacing." + }, { "key": "ui.sidebar.agents.rows", "type": "list of token rows", @@ -680,6 +686,12 @@ "default": "{}", "description": "Complete Agent-row overrides keyed by strict canonical agent id. Agents without an override use ui.sidebar.agents.rows." }, + { + "key": "ui.sidebar.spaces.row_gap", + "type": "integer", + "default": "0", + "description": "Blank terminal rows between expanded Space sidebar entries. Set to 1 to restore the previous spacing. Consecutive indented worktree children remain packed as one group." + }, { "key": "ui.sidebar.spaces.rows", "type": "list of token rows", -- cgit v1.2.3