Herdr
快速入門

mkdir -p ~/.config/herdr
# 已有 config 時先備份，避免覆蓋現有設定
if [ -f ~/.config/herdr/config.toml ]; then
  cp ~/.config/herdr/config.toml ~/.config/herdr/config.toml.bak
fi

# 想從官方預設值重新開始，才執行下一行
herdr --default-config > ~/.config/herdr/config.toml

# 編輯後重載
herdr server reload-config

只有已存在 config.toml 時才會備份。注意：> 會覆蓋原始檔，請先備份。

這個版本特別設計給同時跑 Claude Code / Codex 等多個 Agent 的情境：Sidebar 不顯示冗餘的 Local、保留 Tab 名稱與 Agent 名稱，若有動態摘要就多一列 cyan 文字。

# ~/.config/herdr/config.toml
# Dracula + 緊湊 Sidebar 範例
onboarding = false

[ui]
status_indicators = "symbols"
pane_borders = "always"
pane_outer_borders = true
pane_scrollbars = false
pane_gaps = true
show_agent_labels_on_pane_borders = true
sidebar_width = 30
sidebar_min_width = 20
sidebar_max_width = 50
tab_bar_position = "top"
copy_on_select = true

[ui.sidebar.agents]
row_gap = 0
rows = [
  ["state_icon", { token = "tab", fg = "#f8f8f2", bold = true, dim = false }, { token = "machine", rules = [{ equals = "Local", hide = true }] }],
  ["agent"],
  [{ token = "$summary", fg = "#8be9fd", dim = true }]
]

[ui.sidebar.spaces]
row_gap = 0
rows = [
  ["state_icon", "workspace"],
  ["branch", "git_status"]
]

[ui.toast]
delivery = "terminal"
delay_seconds = 2

[ui.sound]
enabled = false

[theme]
name = "dracula"
auto_switch = false

[theme.custom]
accent = "#bd93f9"
sidebar_bg = "#282a36"
active_row_bg = "#44475a"
selection_bg = "#44475a"

[keys]
prefix = "ctrl+b"
new_tab = "prefix+c"
goto = "prefix+g"
focus_pane_left = "prefix+h"

設定項目逐項解說

Sidebar 自訂 Rows 的邏輯

每一個陣列就是一行；token 不存在時不會硬畫空字串。可以用 fg、bold、dim 指定單一 token 的樣式，或用 rules 判斷內容並隱藏。例如：

herdr pane report-metadata <pane_id> \
  --source my-agent-hook \
  --token summary="reviewing authentication"

實際使用時把 <pane_id> 替換成有效 Pane ID；內容會顯示在對應 Agent 的 $summary 那一行。

進階：只改 Claude 的 Sidebar Rows

如果只想讓 Claude 顯示較多細節，而其他 Agent 維持預設，可以加以下段落。這份設定是取代 Claude 的 rows，不是附加在一般 rows 後面。

[ui.sidebar.agents.rows_by_agent]
claude = [
  ["state_icon", "agent", "state_text"],
  [{ token = "$summary", fg = "#8be9fd" }],
  ["workspace", "tab"]
]

這個 override 使用 canonical ID claude；Codex 則是 codex。如果你的設定檔中已經有 [ui.sidebar.agents.rows_by_agent]，把內容合併進同一個 table，避免 TOML 重複宣告。

進階：狀態列、視窗名稱、通知方式

這三段是獨立片段，不要把多個 [ui] 或 [ui.toast] table 原封不動重複貼進同一份 TOML。請把 key 加到已存在的區塊即可。

# 把以下 key 合併到現有 [ui] 區塊
tab_bar_right = [
  { type = "zoom" },
  { type = "hostname" },
  { type = "datetime", format = "%H:%M" }
]
tab_bar_right_separator = " · "
window_title = "{hostname}: {workspace}"

# 加到現有 [ui.toast] 內：
# delivery = "herdr"
# delay_seconds = 1

# 加到現有 [ui.sound] 內：
# enabled = true

遇到設定不生效，先檢查這些