Herdr Cheat Sheet & Quick Reference

필수

$herdr

Herdr를 실행하거나 기본 세션에 접속합니다.

$curl -fsSL https://herdr.dev/install.sh | sh

공식 설치 스크립트로 Linux 또는 macOS에 Herdr를 설치합니다.

$powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

PowerShell에서 Windows에 Herdr를 설치합니다. ARM64 시스템에서는 x86_64 빌드를 에뮬레이션으로 실행합니다.

$brew install herdr

Homebrew로 Herdr를 설치합니다.

$mise use -g herdr

mise로 Herdr를 설치합니다.

$herdr --remote workbox

SSH를 통해 원격 머신에 접속하며 로컬 키 바인딩을 사용합니다.

$herdr --session work

기본 세션 대신 이름이 지정된 세션을 엽니다.

Ctrl + b q

TUI에서 분리하고 모든 팬을 계속 실행 상태로 둡니다.

Ctrl + b ?

도움말 패널에서 모든 활성 키 바인딩을 표시합니다.

Ctrl + b ? then /

키 바인딩 도움말 패널에서 작업과 단축키를 필터링합니다.

$herdr --default-config

전체 기본 설정을 stdout에 출력합니다.

$herdr update

설치 관리자가 관리하는 Herdr 빌드를 설정된 채널에서 업데이트합니다.

$brew upgrade herdr

Homebrew로 설치한 Herdr를 업데이트합니다.

$mise upgrade herdr

mise로 설치한 Herdr를 업데이트합니다.

팬

Ctrl + b v

포커스된 팬을 오른쪽으로 분할합니다.

Ctrl + b -

포커스된 팬을 아래로 분할하여 아래에 새 팬을 엽니다.

Ctrl + b h / j / k / l

포커스를 왼쪽, 아래, 위 또는 오른쪽 팬으로 이동합니다.

Ctrl + b z

포커스된 팬을 확대하여 탭 전체를 채웁니다.

Ctrl + b x

포커스된 팬을 닫습니다.

Ctrl + b shift + h / j / k / l

포커스된 팬을 지정된 방향의 팬과 바꿉니다.

Ctrl + b r

포커스된 팬의 크기 조정 모드로 진입합니다.

Drag

복사 모드로 진입하지 않고 마우스로 텍스트를 드래그 선택하여 복사합니다.

탭 및 워크스페이스

Ctrl + b c

활성 워크스페이스에 새 탭을 생성합니다.

Ctrl + b n / p

다음 또는 이전 탭으로 이동합니다.

Ctrl + b 1..9

탭 1부터 9로 바로 이동합니다.

Ctrl + b shift + t

활성 탭의 이름을 바꿉니다.

Ctrl + b shift + x

활성 탭을 닫습니다.

Ctrl + b shift + n

새 워크스페이스를 생성합니다.

Ctrl + b shift + w

활성 워크스페이스의 이름을 바꿉니다.

Ctrl + b shift + d

활성 워크스페이스를 닫습니다.

Ctrl + b w

워크스페이스 탐색으로 진입하며, Esc 또는 Ctrl+[로 나갑니다.

Ctrl + b g

에이전트 또는 터미널로 이동할 수 있는 Goto 선택기를 엽니다.

Ctrl + b b

사이드바 대시보드를 전환합니다.

복사 모드 및 텍스트 필드

Ctrl + b [

포커스된 팬의 복사 모드로 진입합니다.

h / j / k / l

복사 모드에서 문자 또는 줄 단위로 이동합니다.

w / b / e

복사 모드에서 단어 단위로 이동합니다.

W / B / E

복사 모드에서 큰 단어 단위로 이동합니다.

{ / }

복사 모드에서 이전 또는 다음 단락으로 이동합니다.

PageUp / PageDown

복사 모드에서 한 페이지 위 또는 아래로 이동합니다.

Ctrl + U / Ctrl + D

복사 모드에서 반 페이지 위 또는 아래로 스크롤합니다.

/ or ? then n / N

팬의 스크롤백을 검색하고 일치 항목을 반복합니다.

v or Space

복사 모드에서 선택을 시작합니다.

y or Enter

복사 모드에서 활성 선택을 복사합니다.

q or Esc

복사하지 않고 복사 모드를 나갑니다.

Ctrl + A / Ctrl + E

Herdr 텍스트 필드의 시작 또는 끝으로 이동합니다.

Ctrl + U / Ctrl + K

커서에서 Herdr 텍스트 필드의 시작 또는 끝까지 잘라냅니다.

Ctrl + W / Alt + Backspace / Ctrl + Backspace

Herdr 텍스트 필드에서 이전 단어를 잘라냅니다.

Alt + D

Herdr 텍스트 필드에서 다음 단어를 잘라냅니다.

Ctrl + Y

마지막으로 잘라낸 텍스트를 Herdr 텍스트 필드에 삽입합니다.

실행, 상태 및 머신

$herdr status

전체 Herdr 상태를 출력합니다.

$herdr status server

서버 상태를 출력합니다.

$herdr --version

설치된 Herdr 버전을 출력합니다.

$herdr channel show

현재 업데이트 채널을 표시합니다.

$herdr channel set preview

프리뷰 빌드를 선택합니다.

$herdr completion zsh

셸 완성 스크립트를 생성합니다.

$herdr machine add workbox --label "Build machine"

레이블과 함께 SSH 머신 프로필을 저장합니다.

$herdr machine status "Build machine"

저장된 머신의 연결 가능성을 확인합니다.

$herdr --machine "Build machine" agent list

CLI 명령을 저장된 SSH 머신으로 라우팅합니다.

세션, 워크스페이스 및 팬

$herdr session list

Herdr 세션을 나열합니다.

$herdr session attach work

이름이 지정된 세션에 접속합니다.

$herdr workspace list

워크스페이스를 나열합니다.

$herdr workspace create --cwd ~/project --label api --no-focus

포커스를 빼앗지 않고 워크스페이스를 생성합니다.

$herdr tab create --workspace <workspace_id> --label logs

레이블과 함께 워크스페이스에 탭을 생성합니다.

$herdr tab close <tab_id>

ID로 탭을 닫습니다.

$herdr pane list

팬을 나열합니다.

$herdr pane split <pane_id> --direction right --ratio 0.3

비율을 지정하여 팬을 오른쪽으로 분할합니다.

$herdr pane focus --direction left

지정된 방향의 팬에 포커스합니다.

$herdr pane read <pane_id> --source recent-unwrapped --lines 120

줄바꿈되지 않은 최근 팬 출력을 읽습니다.

$herdr pane run <pane_id> "npm test"

팬에서 명령을 실행하고 Enter로 제출합니다.

$herdr pane close <pane_id>

ID로 팬을 닫습니다.

에이전트, 플러그인 및 통합

$herdr agent list

감지 및 시작된 에이전트를 나열합니다.

$herdr agent start reviewer --kind claude --pane <pane_id>

사용 가능한 셸 팬에서 이름이 지정된 에이전트를 시작합니다.

$herdr agent prompt reviewer "review this diff" --wait

에이전트에 프롬프트를 보내고 안정된 상태가 될 때까지 기다립니다.

$herdr agent wait reviewer --until idle

에이전트가 특정 상태에 도달할 때까지 기다립니다.

$herdr agent read reviewer --lines 80

에이전트의 터미널 출력을 읽습니다.

$herdr agent send-keys reviewer esc

에이전트에 논리 키를 보냅니다.

$herdr agent focus reviewer

UI에서 에이전트에 포커스합니다.

$herdr integration install claude

Claude 에이전트 통합을 설치합니다.

$herdr integration status --outdated-only

버전이 오래된 통합만 표시합니다.

$herdr plugin install ogulcancelik/herdr-plugin-examples/worktree-bootstrap --yes

GitHub 축약 표기로 플러그인을 설치합니다.

$herdr plugin list

설치된 플러그인을 나열합니다.

$herdr plugin action invoke <action_id>

설치된 플러그인 작업을 호출합니다.

$herdr worktree create --cwd ~/project --branch review

Git worktree 체크아웃을 워크스페이스로 생성합니다.

설정

[keys] prefix = "ctrl+a"

keys 테이블에서 prefix 키를 변경합니다.

[keys] prefix = ["ctrl+space", "ctrl+s"]

둘 이상의 키에서 prefix 모드로 진입합니다.

[keys] focus_pane_left = ["prefix+h", "ctrl+alt+h"]

prefix 바인딩과 함께 직접 코드를 추가합니다.

[keys] switch_tab = "prefix+1..9"

탭 1부터 9까지 인덱스 이동을 바인딩합니다.

[theme] name = "catppuccin"

theme 테이블에서 기본 제공 테마를 선택합니다.

[theme] auto_switch = true

테마가 터미널의 라이트 또는 다크 모양을 따르도록 합니다.

[theme.custom] accent = "#a6e3a1"

단일 테마 색상을 재정의합니다.

[terminal] default_shell = "nu"

새 대화형 팬에 사용할 실행 파일을 설정합니다.

[terminal] new_cwd = "follow"

새 팬, 탭, 워크스페이스의 작업 디렉터리 정책을 설정합니다.

$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml

$notepad %APPDATA%\herdr\config.toml

$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml

편집을 위해 Herdr 설정 파일을 엽니다.

$herdr server reload-config

팬을 재시작하지 않고 다시 로드 가능한 설정을 적용합니다.

$herdr config reset-keys

config.toml을 백업하고 사용자 지정 키 바인딩을 제거합니다. 재시작 또는 다시 로드 후 적용됩니다.