herdrHerdr가 아직 설치되지 않았다면 설치 가이드를 먼저 확인하세요. 설치를 마쳤다면 프로젝트 디렉터리에서 Herdr를 실행합니다.
herdrHerdr는 기본 백그라운드 세션을 시작하거나 연결합니다. 소켓을 관리하지 않습니다. 분리해도 에이전트는 계속 실행됩니다.
작업 공간 만들기
세션에 작업 공간이 없으면 Herdr는 작업 공간을 자동으로 엽니다. 작업 공간은 탭, 패널, 에이전트를 위한 프로젝트 수준 컨테이너입니다. 사이드바에서 에이전트 상태를 계속 읽을 수 있도록 각 활성 프로젝트에 고유한 작업 공간을 제공하십시오.
마우스 사용하기
Herdr는 마우스 기반이므로 패널, 탭, 작업 공간 및 에이전트를 클릭하여 초점을 맞추는 것부터 시작하세요. 크기를 조정하려면 분할 테두리를 드래그하세요. 패널 분할 및 탭 생성을 포함한 상황에 맞는 메뉴를 보려면 마우스 오른쪽 버튼을 클릭하세요. 텍스트를 드래그하여 선택하여 클립보드에 복사하세요. 토큰을 두 번 클릭하여 선택하거나, 두 번째 누른 상태에서 끌어 선택 항목을 전체 단어로 확장합니다. 마우스를 놓으면 두 동작 모두 복사됩니다. 복사에는 Ctrl+C가 필요하지 않습니다.
터미널이 수정된 클릭을 Herdr로 보낼 때 Ctrl 키를 누른 채 클릭하면 패널 링크가 열립니다. 이는 시작이나 끝이 표시 영역 외부에 있는 래핑된 링크를 포함하여 OSC 8 하이퍼링크와 http:// 또는 https:// URL에 대해 작동합니다. Ctrl 키를 누른 채 링크 위로 포인터를 이동하면 보이는 부분에 밑줄이 그어집니다. 다른 곳으로 이동하면 마우스 오버 강조 표시가 지워지고, 패널 내용이 변경되거나, Herdr가 Ctrl-release 이벤트를 수신합니다. 일부 터미널에서는 마우스 움직임에 따른 수정자 변경 사항만 보고합니다. macOS에서는 마우스 캡처가 활성화된 동안 Herdr가 처리하는 패널 링크를 보려면 Ctrl 키를 누른 채 클릭하세요. Cmd-클릭은 Shift-Cmd-클릭 또는 ui.mouse_capture = false와 같은 터미널 기본 우회 경로를 통해서만 사용할 수 있습니다.
ui.right_click_passthrough_modifier을 구성하는 경우 해당 수정자와 마우스 오른쪽 버튼 클릭은 마우스 보고 패널 앱에 마우스 오른쪽 버튼 클릭, 길게 누르기 및 드래그 동작을 보냅니다. 일반적인 마우스 오른쪽 버튼 클릭을 하나의 패널 앱으로 이동하려면 해당 패널의 메뉴에서 패널에 마우스 오른쪽 버튼 클릭 보내기를 선택하거나 그 안에서 herdr pane input --current --right-click pane을 실행하세요. Herdr의 메뉴를 다시 열려면 패널 프레임을 마우스 오른쪽 버튼으로 클릭하세요.
에이전트 실행하기
패널에서 코딩 에이전트를 시작합니다.
claude또는 codex, pi, opencode 또는 기타 지원 에이전트. Herdr는 이를 자동으로 감지합니다. 모든 작업 공간에서 사이드바에는 각 에이전트가 working, blocked, done 또는 idle인지 표시되므로 어떤 프로젝트에 자신이 필요한지 항상 알 수 있습니다.
키보드 사용하기
키보드 제어는 선택 사항입니다. 마우스는 모든 것을 다룹니다. ctrl+b을 눌러 프리픽스 모드로 들어간 다음 동작 키를 누릅니다.
일반적인 작업:
| 액션 | 키 |
|---|---|
| 오른쪽으로 분할 | prefix+v |
| 분할 | prefix+minus |
| 새 탭 | prefix+c |
| 다음/이전 탭 | prefix+n / prefix+p |
| 작업 공간 탐색 | prefix+w |
| 새로운 작업 공간 | prefix+shift+n |
| 클라이언트 분리 | prefix+q |
프리픽스 아이디어가 처음이라면 키보드와 마우스에서 그것이 무엇인지, 멀티플렉서가 프리픽스를 사용하는 이유와 프리픽스를 사용하지 않는 방법을 설명합니다. 모든 활성 바인딩을 보려면 Herdr 내부에서 prefix+?를 누르고 복사 모드에서 키보드에서 복사하려면 prefix+[을 누르십시오.
연결을 해제하고 다시 돌아오기
prefix+q을 누르거나 터미널 창을 닫으세요. Herdr 서버와 모든 에이전트는 계속 실행됩니다. 동일한 세션에 다시 연결하려면 herdr을 다시 실행하세요.
세션을 종료하고 해당 패널을 중지하려면:
herdr server stop