설정 항목 레퍼런스 · Herdr 한국어 문서

config.toml에서 사용하는 모든 설정 키를 검색하고 확인하세요. 각 설정의 사용 방법과 배경은 환경 설정 문서에서 설명합니다.

주석이 포함된 전체 기본 설정을 터미널에 출력하려면 다음 명령어를 실행하세요.

bash

herdr --default-config

사용자 정의 명령 바인딩([[keys.command]])은 사용자 정의 테이블이며 여기에 키별로 나열되지 않습니다. 사용자 정의 명령 키 설정을 참조하세요.

210개 설정 항목

일반

onboarding boolean 기본값unset

시작 시 첫 실행 설정을 표시합니다. 누락되거나 사실인 쇼 온보딩; 온보딩에서 계속해서 onboarding = false를 씁니다.

서버

server.headless_cols integer 기본값120

클라이언트가 연결되지 않은 경우 레이아웃 및 새로 생성된 패널에 사용되는 가상 터미널 너비입니다. 0보다 커야 합니다.
server.headless_rows integer 기본값40

클라이언트가 연결되지 않은 경우 레이아웃 및 새로 생성된 패널에 사용되는 가상 터미널 높이입니다. 0보다 커야 합니다.

테마

theme.name string 기본값"catppuccin"

내장 테마 이름.
theme.auto_switch boolean 기본값false

호스트 터미널의 밝은/다크 모드을 따르고 테마 이름을 전환합니다.
theme.dark_name string 기본값unset

`auto_switch`가 다크 모드을 선택할 때 사용되는 테마 이름입니다.
theme.light_name string 기본값unset

`auto_switch`가 라이트 모드을 선택할 때 사용되는 테마 이름입니다.
theme.custom.accent color 기본값unset

기본 테마의 accent 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.panel_bg color 기본값unset

기본 테마의 panel_bg 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.sidebar_bg color 기본값unset

다른 패널의 배경을 바꾸지 않고 데스크톱 사이드바 배경만 설정합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.active_row_bg color 기본값unset

구분선과 스크롤바 트랙을 바꾸지 않고 활성 작업 공간과 포커스된 에이전트 행의 배경만 설정합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.selection_bg color 기본값unset

다른 선택 영역을 바꾸지 않고 사이드바 탐색 모드에서 커서가 있는 행의 배경만 설정합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.surface0 color 기본값unset

기본 테마의 surface0 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.surface1 color 기본값unset

기본 테마의 surface1 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.surface_dim color 기본값unset

기본 테마의 surface_dim 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.overlay0 color 기본값unset

기본 테마의 overlay0 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.overlay1 color 기본값unset

기본 테마의 overlay1 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.text color 기본값unset

기본 테마의 text 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.subtext0 color 기본값unset

기본 테마의 subtext0 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.mauve color 기본값unset

기본 테마의 mauve 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.green color 기본값unset

기본 테마의 green 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.yellow color 기본값unset

기본 테마의 yellow 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.red color 기본값unset

기본 테마의 red 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.blue color 기본값unset

기본 테마의 blue 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.teal color 기본값unset

기본 테마의 teal 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.peach color 기본값unset

기본 테마의 peach 색상 토큰을 덮어씁니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.accent color 기본값unset

auto_switch가 라이트 모드를 선택할 때 accent 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.panel_bg color 기본값unset

auto_switch가 라이트 모드를 선택할 때 panel_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.sidebar_bg color 기본값unset

auto_switch가 라이트 모드를 선택할 때 sidebar_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.active_row_bg color 기본값unset

auto_switch가 라이트 모드를 선택할 때 active_row_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.selection_bg color 기본값unset

auto_switch가 라이트 모드를 선택할 때 selection_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.surface0 color 기본값unset

auto_switch가 라이트 모드를 선택할 때 surface0 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.surface1 color 기본값unset

auto_switch가 라이트 모드를 선택할 때 surface1 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.surface_dim color 기본값unset

auto_switch가 라이트 모드를 선택할 때 surface_dim 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.overlay0 color 기본값unset

auto_switch가 라이트 모드를 선택할 때 overlay0 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.overlay1 color 기본값unset

auto_switch가 라이트 모드를 선택할 때 overlay1 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.text color 기본값unset

auto_switch가 라이트 모드를 선택할 때 text 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.subtext0 color 기본값unset

auto_switch가 라이트 모드를 선택할 때 subtext0 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.mauve color 기본값unset

auto_switch가 라이트 모드를 선택할 때 mauve 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.green color 기본값unset

auto_switch가 라이트 모드를 선택할 때 green 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.yellow color 기본값unset

auto_switch가 라이트 모드를 선택할 때 yellow 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.red color 기본값unset

auto_switch가 라이트 모드를 선택할 때 red 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.blue color 기본값unset

auto_switch가 라이트 모드를 선택할 때 blue 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.teal color 기본값unset

auto_switch가 라이트 모드를 선택할 때 teal 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.light.peach color 기본값unset

auto_switch가 라이트 모드를 선택할 때 peach 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.accent color 기본값unset

auto_switch가 다크 모드를 선택할 때 accent 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.panel_bg color 기본값unset

auto_switch가 다크 모드를 선택할 때 panel_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.sidebar_bg color 기본값unset

auto_switch가 다크 모드를 선택할 때 sidebar_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.active_row_bg color 기본값unset

auto_switch가 다크 모드를 선택할 때 active_row_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.selection_bg color 기본값unset

auto_switch가 다크 모드를 선택할 때 selection_bg 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.surface0 color 기본값unset

auto_switch가 다크 모드를 선택할 때 surface0 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.surface1 color 기본값unset

auto_switch가 다크 모드를 선택할 때 surface1 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.surface_dim color 기본값unset

auto_switch가 다크 모드를 선택할 때 surface_dim 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.overlay0 color 기본값unset

auto_switch가 다크 모드를 선택할 때 overlay0 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.overlay1 color 기본값unset

auto_switch가 다크 모드를 선택할 때 overlay1 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.text color 기본값unset

auto_switch가 다크 모드를 선택할 때 text 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.subtext0 color 기본값unset

auto_switch가 다크 모드를 선택할 때 subtext0 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.mauve color 기본값unset

auto_switch가 다크 모드를 선택할 때 mauve 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.green color 기본값unset

auto_switch가 다크 모드를 선택할 때 green 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.yellow color 기본값unset

auto_switch가 다크 모드를 선택할 때 yellow 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.red color 기본값unset

auto_switch가 다크 모드를 선택할 때 red 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.blue color 기본값unset

auto_switch가 다크 모드를 선택할 때 blue 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.teal color 기본값unset

auto_switch가 다크 모드를 선택할 때 teal 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.
theme.custom.dark.peach color 기본값unset

auto_switch가 다크 모드를 선택할 때 peach 색상 토큰을 덮어씁니다. theme.custom 설정 이후에 적용합니다. 16진수 색상, 색상 이름, rgb(r,g,b), 기본값 복원 별칭을 사용할 수 있습니다.

터미널

terminal.default_shell string 기본값""

새로운 대화형 패널에 사용되는 실행 파일입니다. 비어 있음은 SHELL을 의미하고 /bin/sh를 의미합니다. Windows에서는 PATH에 있으면 pwsh.exe이고, 그렇지 않으면 powershell.exe입니다.
terminal.shell_mode enum 기본값"auto"

새로운 대화형 패널 셸의 시작 모드입니다. autologinnon_login
terminal.new_cwd enum 기본값"follow"

새로운 대화형 패널, 탭 및 작업 공간에 대한 CWD 정책. followhomecurrentpath
terminal.kitty_graphics boolean 기본값true

Kitty 그래픽 호환 외부 터미널에서 패널 이미지를 렌더링합니다. 응용 프로그램은 패널 터미널 출력을 통해 표준 Kitty 그래픽 프로토콜을 사용합니다. 외부 소켓 패널 오버레이 API는 더 이상 사용할 수 없습니다. 그래픽 렌더링을 비활성화하려면 false를 설정하십시오. 서버를 다시 시작하거나 클라이언트를 변경한 후 다시 연결하세요. 원격 세션에서 서버 구성은 Kitty 그래픽 구문 분석을 제어하고 로컬 클라이언트 구성은 외부 터미널 출력을 제어합니다.

업데이트

update.channel enum 기본값"stable" ("preview" for Windows preview builds)

백그라운드 버전 확인 및 herdr 업데이트에 사용되는 업데이트 채널입니다. 안정적인 Windows 빌드는 기본적으로 안정적으로 빌드됩니다. 기존 Windows 미리 보기 설치는 명시적으로 전환될 때까지 미리 보기 상태로 유지됩니다. Homebrew, mise 및 Nix 설치는 미리보기 채널을 무시합니다. stablepreview
update.version_check boolean 기본값true

백그라운드에서 새로운 Herdr 버전을 보려면 herdr.dev를 확인하세요.
update.manifest_check boolean 기본값true

백그라운드에서 원격 에이전트 감지 매니페스트 업데이트를 보려면 herdr.dev를 확인하세요. 번들 매니페스트와 로컬 재정의가 계속 적용됩니다.

키바인딩

keys.prefix keybinding 기본값"ctrl+b"

프리픽스 모드를 시작하기 위한 프리픽스 키(예: "ctrl+b", "f12", "esc" 또는 여러 개를 허용하는 배열)
keys.help keybinding 기본값"prefix+?"

키 설정 도움말을 엽니다.
keys.settings keybinding 기본값"prefix+s"

설정을 엽니다.
keys.new_workspace keybinding 기본값"prefix+shift+n"

새 작업 공간을 만듭니다.
keys.new_worktree keybinding 기본값"prefix+shift+g"

선택한 작업 공간에서 Git 작업 트리를 만듭니다.
keys.open_worktree keybinding 기본값unset

선택한 작업 공간에서 기존 Git 작업 트리를 엽니다. 기본적으로 설정되지 않습니다.
keys.remove_worktree keybinding 기본값unset

확인 후 선택한 관리형 작업 트리 체크아웃을 삭제합니다. 기본적으로 설정되지 않습니다.
keys.rename_workspace keybinding 기본값"prefix+shift+w"

선택한 작업 공간의 이름을 바꿉니다.
keys.close_workspace keybinding 기본값"prefix+shift+d"

선택한 작업 공간을 닫습니다.
keys.workspace_picker keybinding 기본값"prefix+w"

작업 공간 탐색 화면을 엽니다.
keys.goto keybinding 기본값"prefix+g"

세션 탐색기를 엽니다.
keys.navigate_workspace_up keybinding 기본값"up"

탐색 모드에서 작업 공간 선택을 위로 이동합니다.
keys.navigate_workspace_down keybinding 기본값"down"

탐색 모드에서 작업 공간 선택을 아래로 이동합니다.
keys.navigate_pane_left keybinding 기본값"h"

탐색 모드에서 패널의 왼쪽에 초점을 맞춥니다. 왼쪽 화살표는 항상 별칭입니다.
keys.navigate_pane_down keybinding 기본값"j"

탐색 모드에서 아래 패널에 초점을 맞춥니다.
keys.navigate_pane_up keybinding 기본값"k"

탐색 모드에서 위 패널에 초점을 맞춥니다.
keys.navigate_pane_right keybinding 기본값"l"

탐색 모드에서 패널의 초점을 오른쪽으로 맞춥니다. 오른쪽 화살표는 항상 별칭입니다.
keys.detach keybinding 기본값"prefix+q"

Herdr 서버에서 현재 클라이언트를 분리합니다.
keys.reload_config keybinding 기본값"prefix+shift+r"

실행 중인 앱/서버에서 config.toml을 다시 로드합니다.
keys.open_notification_target keybinding 기본값"prefix+o"

현재 표시되는 알림 대상에 초점을 맞춥니다.
keys.previous_workspace keybinding 기본값unset

이전 작업 공간을 선택합니다. 기본적으로 설정되지 않습니다.
keys.next_workspace keybinding 기본값unset

다음 작업 공간을 선택하세요. 기본적으로 설정되지 않습니다.
keys.previous_agent keybinding 기본값unset

에이전트 패널에 표시된 이전 에이전트에 초점을 맞춥니다. 기본적으로 설정되지 않습니다.
keys.next_agent keybinding 기본값unset

에이전트 패널에 표시된 다음 에이전트에 초점을 맞춥니다. 기본적으로 설정되지 않습니다.
keys.focus_agent keybinding 기본값unset

인덱스 1-9로 에이전트의 초점을 맞춥니다. 기본적으로 설정되지 않습니다.
keys.remote_image_paste string 기본값"ctrl+v"

클립보드 이미지를 원격 Herdr 세션으로 보내는 로컬 클라이언트 바로 가기입니다.
keys.new_tab keybinding 기본값"prefix+c"

활성 작업 공간에 새 탭을 만듭니다.
keys.rename_tab keybinding 기본값"prefix+shift+t"

활성 탭의 이름을 바꿉니다.
keys.previous_tab keybinding 기본값"prefix+p"

이전 탭을 선택합니다.
keys.next_tab keybinding 기본값"prefix+n"

다음 탭을 선택합니다.
keys.move_tab_previous keybinding 기본값unset

활성 탭을 앞쪽으로 한 위치 이동합니다. 기본적으로 설정되지 않습니다.
keys.move_tab_next keybinding 기본값unset

활성 탭을 뒤쪽으로 한 위치 이동합니다. 기본적으로 설정되지 않습니다.
keys.switch_tab keybinding 기본값"prefix+1..9"

탭 1-9로 전환합니다.
keys.switch_workspace keybinding 기본값unset

프리픽스 모드에서 작업 공간 1-9로 전환합니다. 기본적으로 설정되지 않습니다.
keys.close_tab keybinding 기본값"prefix+shift+x"

활성 탭을 닫습니다.
keys.rename_pane keybinding 기본값"prefix+shift+p"

초점이 맞춰진 패널의 이름을 바꿉니다.
keys.edit_scrollback keybinding 기본값"prefix+e"

$EDITOR에서 초점이 맞춰진 패널 스크롤백을 엽니다.
keys.clear_pane keybinding 기본값unset

초점이 맞춰진 패널 화면을 지우고 뒤로 스크롤하여 현재 커서 줄과 표시되는 소프트 래핑 행을 유지합니다. 실행 중인 프로그램에 입력을 보내지 않으며 대체 화면(예: Vim)에서는 아무 작업도 수행하지 않습니다. 기본적으로는 설정되지 않습니다. 예를 들어, Clear_pane = "프리픽스+ctrl+k"입니다.
keys.copy_mode keybinding 기본값"prefix+["

초점이 맞춰진 패널에 키보드 복사 모드를 입력합니다.
keys.focus_pane_left keybinding 기본값"prefix+h"

패널의 초점을 왼쪽으로 옮깁니다.
keys.focus_pane_down keybinding 기본값"prefix+j"

아래 패널에 초점을 맞춥니다.
keys.focus_pane_up keybinding 기본값"prefix+k"

위 패널에 초점을 맞춥니다.
keys.focus_pane_right keybinding 기본값"prefix+l"

패널의 초점을 오른쪽으로 맞춥니다.
keys.swap_pane_left keybinding 기본값"prefix+shift+h"

초점이 맞춰진 패널을 왼쪽 패널로 바꿉니다.
keys.swap_pane_down keybinding 기본값"prefix+shift+j"

초점이 맞춰진 패널을 아래 패널로 바꿉니다.
keys.swap_pane_up keybinding 기본값"prefix+shift+k"

초점이 맞춰진 패널을 위의 패널로 바꿉니다.
keys.swap_pane_right keybinding 기본값"prefix+shift+l"

초점이 맞춰진 패널을 오른쪽 패널로 바꿉니다.
keys.cycle_pane_next keybinding 기본값"prefix+tab"

다음 패널로 순환합니다.
keys.cycle_pane_previous keybinding 기본값"prefix+shift+tab"

이전 패널로 순환합니다.
keys.last_pane keybinding 기본값unset

작업 공간과 탭 전체에서 마지막으로 초점을 맞춘 패널에 초점을 맞춥니다. 기본적으로 설정되지 않습니다.
keys.split_vertical keybinding 기본값"prefix+v"

패널을 세로로(나란히) 분할합니다.
keys.split_horizontal keybinding 기본값"prefix+minus"

패널을 수평으로 분할합니다(스택).
keys.close_pane keybinding 기본값"prefix+x"

포커스가 있는 패널을 닫습니다.
keys.zoom keybinding 기본값"prefix+z"

초점이 맞춰진 패널의 확대/축소를 전환합니다. 기존 키 이름 'fullscreen'이 별칭으로 허용됩니다.
keys.resize_mode keybinding 기본값"prefix+r"

크기 조정 모드로 들어갑니다.
keys.resize_pane_left keybinding 기본값unset

초점이 맞춰진 패널의 크기를 왼쪽으로 조정합니다. 기본적으로 설정되지 않습니다.
keys.resize_pane_down keybinding 기본값unset

초점이 맞춰진 패널의 크기를 아래쪽으로 조정합니다. 기본적으로 설정되지 않습니다.
keys.resize_pane_up keybinding 기본값unset

초점이 맞춰진 패널의 크기를 위쪽으로 조정합니다. 기본적으로 설정되지 않습니다.
keys.resize_pane_right keybinding 기본값unset

초점이 맞춰진 패널의 크기를 오른쪽으로 조정합니다. 기본적으로 설정되지 않습니다.
keys.toggle_sidebar keybinding 기본값"prefix+b"

사이드바 축소를 전환합니다.
keys.indexed.tabs string 기본값unset

탭 단축키 1-9에 대한 수정자 콤보. 기본적으로 설정되지 않습니다.
keys.indexed.workspaces string 기본값unset

작업 공간 바로 가기 1-9에 대한 수정자 콤보. 기본적으로 설정되지 않습니다.
keys.indexed.agents string 기본값unset

에이전트 바로가기 1-9에 대한 수정자 콤보. 기본적으로 설정되지 않습니다.

UI 및 사이드바

ui.sidebar_width integer 기본값26

열의 기본 확장 사이드바 너비입니다. 작업 공간 이름을 기준으로 자동 크기 조정됩니다.
ui.sidebar_min_width integer 기본값18

확장 시 최소 사이드바 너비(열)입니다.
ui.sidebar_max_width integer 기본값36

확장 시 최대 사이드바 너비(열)입니다.
ui.sidebar_start_collapsed boolean 기본값false

사이드바를 접은 상태에서 Herdr를 시작하세요. 변경 사항은 다음 실행 시 적용됩니다.
ui.sidebar_collapsed_mode enum 기본값compact

축소된 사이드바 프레젠테이션. compacthidden
ui.mobile_width_threshold integer 기본값64

Herdr가 모바일 단일 열 레이아웃을 사용하는 터미널 너비 또는 그 이하.
ui.mouse_capture boolean 기본값true

Herdr의 마우스 UI에 대한 마우스 입력을 캡처합니다.
ui.copy_on_select boolean 기본값true

마우스 드래그나 더블클릭으로 선택한 텍스트를 자동으로 복사합니다. 비활성화되면 Ctrl+C 또는 호스트 전달 Cmd+C가 유지된 선택 항목을 복사하고 지웁니다.
ui.host_cursor enum 기본값auto

호스트 커서 정책. autonativedrawn
ui.right_click_passthrough_modifier string 기본값""

마우스 오른쪽 버튼 클릭 동작이 패널 앱으로 전달되도록 하는 수정자입니다. 비어 있으면 비활성화됩니다. Ctrl, Alt, cmd, super, Meta, Hyper 또는 +로 구분된 조합을 허용합니다. 많은 터미널에서 Shift+마우스를 예약하기 때문에 Shift가 거부됩니다.
ui.redraw_on_focus_gained boolean 기본값true

외부 터미널이 포커스를 다시 받으면 전체 호스트 터미널 다시 그리기를 강제로 수행합니다.
ui.mouse_scroll_lines integer 기본값3

마우스 휠 노치당 스크롤할 라인입니다.
ui.confirm_close boolean 기본값true

작업 공간을 닫기 전에 확인을 요청하세요.
ui.prompt_new_tab_name boolean 기본값true

새 탭을 만들기 전에 탭 이름을 물어보세요.
ui.prompt_new_workspace_name boolean 기본값false

대화형 TUI를 생성하기 전에 작업 공간 이름을 요청하세요.
ui.pane_borders enum 기본값"auto"

분할 패널 주위에 테두리를 그립니다. auto는 분할 패널에 대해서만 그리며 항상 단독 패널의 프레임을 지정합니다(고독한 패널의 모든 가장자리가 외부 가장자리이므로 panel_outer_borders가 활성화된 동안에만), off는 비활성화합니다. 레거시 부울은 여전히 구문 분석됩니다. true는 자동으로 매핑되고 false는 꺼짐으로 매핑됩니다. autoalwaysoff
ui.pane_outer_borders boolean 기본값true

창 영역의 외부 가장자리를 따라 테두리를 그립니다. 외부 프레임이 없는 tmux 스타일 내부 분할기에 대해 패널 간격을 비활성화하면 비활성화됩니다.
ui.pane_scrollbars boolean 기본값true

터미널 패널 옆에 대화형 스크롤 막대를 그립니다. 스크롤 막대 열을 회수하고 터미널 기본 선택에서 제외하려면 비활성화합니다.
ui.pane_gaps boolean 기본값true

구분선 테두리를 공유하는 대신 분할 패널을 시각적으로 분리된 상태로 유지하세요.
ui.show_agent_labels_on_pane_borders boolean 기본값false

수동 패널 레이블이 설정되지 않은 경우 분할 패널 테두리에 에이전트 레이블을 표시합니다.
ui.hide_tab_bar_when_single_tab boolean 기본값false

작업 공간에 탭이 하나 있으면 탭 행을 숨깁니다.
ui.tab_bar_position enum 기본값"top"

터미널 패널 위나 아래에 바탕 화면 탭 행을 배치합니다. topbottom
ui.tab_bar_right array 기본값[]

순서대로 오른쪽 정렬된 탭 표시줄 항목을 구성합니다. 지원되는 유형은 확대/축소, 호스트 이름, 날짜/시간, 텍스트 및 명령입니다. zoomhostnamedatetimetextcommand
ui.tab_bar_right_separator string 기본값" "

표시되는 오른쪽 정렬 탭 표시줄 항목 사이에 텍스트가 삽입되었습니다.
ui.window_title string 기본값"{hostname}: {workspace}"

제목 Herdr는 실행되는 터미널에 씁니다. 토큰: {hostname}, {workspace}, {tab}, {pane}, {terminal_title}. 비어 있으면 외부 제목만 남깁니다.
ui.agent_panel_sort enum 기본값"spaces"

에이전트 사이드바 주문. 저장된 값은 "공백" 또는 "우선순위"입니다. "작업 공간"은 "공간"의 별칭으로 허용됩니다. spacespriority
ui.status_indicators enum 기본값"dots"

에이전트 상태에 대해 컴팩트한 색상 점이나 고유한 정적 기호를 선택하세요. dotssymbols
ui.sidebar.agents.row_gap integer 기본값0

확장된 에이전트 사이드바 항목 사이에 빈 터미널 행이 있습니다. 이전 간격을 복원하려면 1로 설정합니다.
ui.sidebar.agents.rows list of token rows 기본값[["state_icon", "machine", "workspace", "tab"], ["agent"]]

기본 확장 에이전트 사이드바 레이아웃. 항목은 토큰 문자열이거나 인라인 {token, fg,bold,dim,rules} 스타일 테이블일 수 있습니다. 텍스트 값 내장 및 $name 메타데이터 토큰은 equals, contain, start_with, gt 또는 lt를 사용하여 최대 16개의 순서 규칙을 허용합니다. 첫 번째 일치 항목이 지정된 스타일을 재정의합니다. 텍스트 조건은 선택적으로 ASCII 일치를 위해ignore_case를 허용합니다. 수치 조건에는 완전 유한수가 필요합니다. state_icon은 고정 스타일만 허용합니다. 최대 16개 행 및 행당 16개 토큰.
ui.sidebar.agents.rows_by_agent table of token rows 기본값{}

엄격한 정식 에이전트 ID로 입력된 에이전트 행 재정의를 완료합니다. 재정의가 없는 에이전트는 ui.sidebar.agents.rows를 사용합니다.
ui.sidebar.spaces.row_gap integer 기본값0

작업 트리 그룹과 관련되지 않은 최상위 공간 사이의 빈 터미널 행입니다. Worktree 부모와 들여쓰기된 자식은 꽉 찬 상태로 유지됩니다.
ui.sidebar.spaces.rows list of token rows 기본값[["state_icon", "workspace"], ["branch", "git_status"]]

확장된 Space 사이드바 레이아웃. 항목은 토큰 문자열이거나 인라인 {token, fg,bold,dim,rules} 스타일 테이블일 수 있습니다. 텍스트 값 내장 및 $name 메타데이터 토큰은 equals, contain, start_with, gt 또는 lt를 사용하여 최대 16개의 순서 규칙을 허용합니다. 첫 번째 일치 항목이 지정된 스타일을 재정의합니다. 텍스트 조건은 선택적으로 ASCII 일치를 위해ignore_case를 허용합니다. 수치 조건에는 완전 유한수가 필요합니다. state_icon 및 git_status는 고정 스타일만 허용합니다. 최대 16개 행 및 행당 16개 토큰.
ui.accent color 기본값"cyan"

하이라이트, 테두리, 탐색 UI의 강조 색상입니다. 16진수(#89b4fa), 명명된 색상(청록색, 파란색) 또는 RGB(rgb(137,180,250))를 허용합니다.

알림

ui.toast.delivery enum 기본값"off"

팝업 알림 전달. off는 팝업을 비활성화하고, herdr은 인앱 토스트를 표시하고, 터미널은 외부 터미널에 데스크톱 알림을 요청하고, 시스템은 OS 알림 서비스에 직접 요청합니다. offherdrterminalsystem
ui.toast.delay_seconds integer 기본값1

완료되었거나 입력이 필요한 에이전트 알림을 보내기 전에 기다리는 시간(초)입니다. Herdr는 지연이 만료될 때 패널이 여전히 동일한 상태에 있는 경우에만 알립니다. 0은 즉시입니다. 유효한 값은 0부터 3600까지입니다.
ui.toast.herdr.position enum 기본값"bottom-right"

전체 Herdr 프레임을 기준으로 한 인앱 토스트 위치입니다. top-lefttop-rightbottom-leftbottom-right
ui.toast.clipboard.enabled boolean 기본값true

마우스 복사 후 클립보드에 복사 팝업을 표시합니다.
ui.toast.clipboard.position enum 기본값"bottom-center"

클립보드에 복사된 팝업 위치입니다. top-lefttop-centertop-rightbottom-leftbottom-centerbottom-right

소리

ui.sound.enabled boolean 기본값true

에이전트가 백그라운드 작업 공간에서 상태를 변경할 때 소리를 재생합니다.
ui.sound.path path 기본값unset

모든 알림 소리에 사용되는 선택적 mp3 파일 경로입니다. 상대 경로는 설정 파일의 디렉터리에서 확인됩니다.
ui.sound.done_path path 기본값unset

"완료" 알림을 위한 선택적 mp3 파일 경로입니다. 상대 경로는 설정 파일의 디렉터리에서 확인됩니다.
ui.sound.request_path path 기본값unset

"요청" 알림을 위한 선택적 mp3 파일 경로입니다. 상대 경로는 설정 파일의 디렉터리에서 확인됩니다.
ui.sound.agents.pi enum 기본값"default"

감지된 Pi 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.claude enum 기본값"default"

감지된 Claude Code 에이전트의 사운드 재정의. defaultonoff
ui.sound.agents.codex enum 기본값"default"

감지된 Codex 에이전트에 대한 사운드 무시. defaultonoff
ui.sound.agents.gemini enum 기본값"default"

감지된 Gemini CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.cursor enum 기본값"default"

감지된 커서 에이전트 CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.devin enum 기본값"default"

감지된 Devin 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.agy enum 기본값"default"

감지된 Agy 에이전트에 대한 소리 무시. defaultonoff
ui.sound.agents.cline enum 기본값"default"

감지된 Cline 에이전트에 대한 소리 무시. defaultonoff
ui.sound.agents.open_code enum 기본값"default"

감지된 OpenCode 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.github_copilot enum 기본값"default"

감지된 GitHub Copilot CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.kimi enum 기본값"default"

감지된 Kimi Code CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.kiro enum 기본값"default"

감지된 Kiro 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.droid enum 기본값"off"

감지된 Droid 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.amp enum 기본값"default"

감지된 Amp 에이전트의 사운드 재정의. defaultonoff
ui.sound.agents.grok enum 기본값"default"

감지된 Grok CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.hermes enum 기본값"default"

감지된 Hermes Agent 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.kilo enum 기본값"default"

감지된 Kilo Code CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.qodercli enum 기본값"default"

감지된 Qoder CLI 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.qwen enum 기본값"default"

감지된 Qwen Code 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.letta enum 기본값"default"

감지된 Letta Code 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.maki enum 기본값"default"

감지된 Maki 에이전트에 대한 사운드 재정의. defaultonoff
ui.sound.agents.muse enum 기본값"default"

감지된 Muse 에이전트에 대한 사운드 재정의. defaultonoff

세션

session.resume_agents_on_restore boolean 기본값true

Herdr 세션을 복원할 때 지원되는 AI 에이전트 패널을 기본 대화 세션으로 재개합니다.
session.startup_per_agent_delay_ms integer 기본값100

서버가 다시 시작된 후 자동 에이전트가 복원되는 간격(밀리초)입니다. 첫 번째 에이전트는 이러한 지연 없이 시작됩니다. 0은 간격을 비활성화합니다. 수동 실행이나 명시적 터미널 연결을 지연시키지 않습니다. 적용하려면 서버를 다시 시작하세요.

작업 트리

worktrees.directory string 기본값"~/.herdr/worktrees"

Herdr가 <repo>/<branch-slug> 체크아웃을 생성하는 루트 디렉터리입니다.

원격

remote.manage_ssh_config boolean 기본값true

`herdr --remote`에 대한 연결 유지 대체 및 개인 연결 재사용을 추가합니다. 일반 SSH를 변경 없이 실행하려면 false를 설정하세요.

고급

advanced.scrollback_limit_bytes integer 기본값10000000

창 터미널당 유지되는 최대 스크롤백 버퍼 크기(바이트)입니다. 기존 키 이름 `scrollback_lines`가 별칭으로 허용됩니다.

실험적

experimental.allow_nested boolean 기본값false

기존 herdr 패널 내에서 herdr 시작을 허용합니다.
experimental.kitty_graphics boolean 기본값unset

Terminal.kitty_graphics에 대한 호환성 키가 더 이상 사용되지 않습니다. 기존 true 및 false 값은 계속 지원됩니다. 둘 다 설정된 경우 Terminal.kitty_graphics가 우선적으로 적용됩니다.
experimental.pane_history boolean 기본값false

session-history.json에 패널 화면 기록을 유지합니다.
experimental.reveal_hidden_cursor_for_cjk_ime boolean 기본값false

패널이 '?25l'을 요청한 경우에도 초점이 맞춰진 패널의 커서 앵커를 외부 터미널에 노출하므로 TUI가 자체 커서(Claude Code, pi, codex 등)를 그릴 때 macOS 기본 입력 방법이 후보 패널을 계속 추적합니다. 기본값: 거짓. 패널에서 커서 위치가 보고되지 않으면 안정적인 IME 앵커를 항상 사용할 수 있도록 패널의 왼쪽 상단으로 돌아갑니다. 활성화 시 장단점: 대체 항목을 그리지 않고 커서를 숨기는 앱(vim 일반 모드 등)의 경우 추가 하드웨어 커서가 외부 터미널에 표시됩니다. #149를 참조하세요.
experimental.cjk_ime_agents list of strings 기본값[]

탐지된 에이전트가 이러한 이름 중 하나와 일치하는 포커스 패널로 `reveal_hidden_cursor_for_cjk_ime`을 제한합니다(대소문자를 구분하지 않음). 빈 목록은 초점이 맞춰진 패널에 적용됨을 의미합니다. 알 수 없는 에이전트 이름은 무시됩니다. 목록에 유효한 이름이 없으면 공개가 적용되지 않습니다. 허용되는 이름: pi, claude, codex, gemini, 커서, devin, cline, opencode, copilot, kimi, kiro, droid, amp, grok, hermes, kilo, qodercli, qoder, qwen, qwen-code, letta, letta-code, maki.
experimental.cjk_ime_cursor_shape enum 기본값"steady_block"

`reveal_hidden_cursor_for_cjk_ime`이 활성화된 경우 IME 앵커에 대해 렌더링된 커서 모양. blocksteady_blockunderlinesteady_underlinebarsteady_bar
experimental.switch_ascii_input_source_in_prefix boolean 기본값false

프리픽스 모드가 활성화된 동안 호스트 입력 소스를 일시적으로 ASCII 지원 모드로 전환하여 IME가 활성화된 경우에도 프리픽스 명령을 ASCII로 읽은 다음 프리픽스 모드가 종료되면 이전 입력 소스를 복원합니다. macOS에서는 ASCII 지원 키보드 레이아웃을 선택합니다. Windows에서는 IME를 영어(ASCII) 입력으로 전환합니다. Windows 지원은 현재 한국어 IME로 제한됩니다. 다른 언어에 대한 IME를 사용하는 경우 입력 소스는 변경되지 않습니다. macOS 및 Windows에만 해당; 다른 곳에서는 작동하지 않으며 스위치가 실패할 경우 최선의 노력을 기울여 작동하지 않습니다.