Windows 베타

기본 Windows 지원이 일반적으로 제공됩니다.

Windows의 Herdr는 원래 Herdr가 구축한 Unix PTY 모델 대신 ConPTY 및 Windows 프로세스/런타임 동작을 사용합니다. 대부분의 핵심 작업 흐름이 지원되지만 일부 기능은 Linux 및 macOS와 다르거나 플랫폼에 따라 다릅니다. Windows는 남은 격차가 줄어들면서 더 많은 플랫폼별 수정 사항을 받을 수 있습니다.

PowerShell을 사용하여 Windows에 기본적으로 Herdr를 설치합니다.

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

엔드포인트 보안이 파일 없는 PowerShell 명령을 차단하는 경우 명령 프롬프트를 열고 다음을 실행합니다.

curl.exe -fsSLo install.cmd https://herdr.dev/install.cmd && install.cmd && del install.cmd

Windows 빌드는 안정적인 업데이트 채널과 미리 보기 업데이트 채널을 통해 사용할 수 있습니다. 신규 설치에서는 기본적으로 stable을 사용하며 일반적인 사용에는 stable을 권장합니다. 기존 미리보기 설치는 herdr channel set stable을 실행할 때까지 미리보기 상태로 유지됩니다. 이전 미리 보기 빌드가 해당 명령을 거부하는 경우 미리 보기에서 herdr update을 한 번 실행하고 다시 시도하세요. Preview는 master의 최신이고 덜 테스트된 수정 사항을 제공하며 회귀될 수 있습니다. 그 절충안을 원할 때만 herdr channel set preview을 선택하세요.

설치 프로그램은 %USERPROFILE%\.herdr\packages\standalone\releases 아래에 릴리스를 저장하고, 활성 버전 릴리스 디렉터리를 PATH에 배치하고, %LOCALAPPDATA%\Programs\Herdr\bin을 안정적인 호환성 별칭으로 유지하고, 실행 중인 프로세스가 업데이트를 차단하지 않도록 소수의 이전 릴리스를 유지합니다.

내부 테스트를 위해 HERDR_MANIFEST_URL은 Herdr의 안정 또는 미리 보기 매니페스트 대신 사용자 정의 매니페스트에서 설치 프로그램을 가리킬 수 있습니다. 사용자 정의 미리보기 매니페스트를 사용하여 HERDR_CHANNEL=preview을 설정합니다.

클라이언트가 분리되거나 해당 터미널 패널이 닫힌 후에도 로컬 영구 세션은 계속 실행됩니다. Windows OpenSSH를 통해 시작된 서버 및 패널 프로세스는 로그아웃 후에도 유지됩니다. 다시 연결하려면 herdr을 다시 실행하세요.

Windows 에이전트 프로세스 감지는 패널 셸의 하위 항목을 검색하고 직접 에이전트와 npm/Node 및 Git Bash 프로세스 체인을 포함한 일반적인 명령 래퍼를 인식합니다. 에뮬레이트된 exec 경계에서 Git Bash 실행 에이전트를 따르지만 Unix 포그라운드 프로세스 그룹 감지와는 다릅니다.

Windows 통합 설치는 현재 Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, Devin CLI, OpenCode, Kilo Code CLI, Droid, Kimi Code CLI, Qoder CLI 및 Antigravity CLI를 지원합니다. 가용성은 Unix보다 좁습니다. Herdr는 Windows에서 지원되지 않는 설치 형식의 통합을 숨기거나 거부합니다.

플러그인은 미리보기에서 매니페스트 플랫폼으로 windows을 지원합니다. GitHub 설치, 로컬 링크, 빌드 명령, 작업, 이벤트 및 플러그인 패널은 Windows에서 최선의 노력을 다합니다. 명령은 argv 명령이며 Windows와 호환되어야 합니다. npm, bun 및 node과 같은 노드 패키지 심은 PATH에 있을 때 작동할 것으로 예상되는 반면, sh 또는 Bash를 사용하는 Unix 전용 예제에는 Windows 관련 대안이 필요합니다. 플랫폼 필터는 지원되지 않는 빌드 명령을 건너뛰고 지원되지 않는 작업이나 패널에 대해 platform_unsupported을 반환합니다.

Herdr는 올바른 디렉터리에서 패널을 시작하고 Herdr를 시작한 디렉터리에서 초기 작업 공간을 만들 수 있습니다. 시작 후 Herdr가 검사할 수 있는 프로세스 필드는 PowerShell의 이후 논리적 cd 변경 사항을 안정적으로 추적하지 않습니다. 실시간 cwd 보고를 위해 Herdr 통합 또는 프롬프트 셸 통합을 사용하세요.

herdr --remote 중에 구성된 원격 이미지 붙여넣기 키는 Windows 클립보드 이미지를 읽고 이를 원격 호스트로 전송합니다. 하나의 로컬 이미지 파일을 Windows 터미널에 놓으면 해당 파일도 전송되고 원격 경로가 붙여넣어집니다.

프리픽스 입력-소스 전환은 한국어 IME에 대한 옵트인 실험으로 사용할 수 있습니다. 프리픽스 명령이 활성화되어 있는 동안 한글 입력을 영어로 전환하고 나중에 이전 모드를 복원합니다.

[experimental]
switch_ascii_input_source_in_prefix = true

다른 Windows IME는 아직 이 옵션에서 지원되지 않습니다. 구성을 참조하세요.

일부 Windows 에이전트는 ctrl+v을 수신하고 클립보드 이미지를 직접 읽을 수 있습니다. Herdr의 자체 클립보드 이미지 판독기는 로컬 기본 Windows 패널에 연결되어 있지 않으므로 에이전트 기본 이미지 붙여넣기는 터미널과 에이전트에 종속적으로 유지됩니다. alt+v과 같은 에이전트 이미지 붙여넣기 바로 가기는 Herdr 관리 로컬 클립보드 브리지를 추가하지 않습니다. 원격 클립보드 이미지 브리징은 herdr --remote를 통해 Linux, macOS 및 Windows 호스트에 대해 별도로 지원됩니다.

키티 그래픽은 기본적으로 활성화되어 있으며 외부 터미널에 따라 다릅니다. Herdr는 다른 플랫폼에서와 마찬가지로 Windows에서도 Kitty 그래픽 프로토콜 출력을 내보냅니다. 이 경로는 WSL을 통해 Herdr를 호스팅하는 Windows WezTerm에서 실행되었지만 기본 Windows 터미널과 ConPTY 조합이 모두 확인되지는 않았습니다. Windows 터미널은 Herdr가 사용하는 Kitty 그래픽 경로를 노출하지 않습니다. 외부 터미널이 그래픽 출력을 잘못 처리하는 경우 [terminal].kitty_graphics = false을 설정하십시오.

Herdr는 기본 Windows 패널에 ConPTY를 사용합니다. 멀티플렉서가 화면을 다시 그리는 동안 Windows 터미널 커서 경로는 중간 위치를 노출할 수 있습니다. 기본 커서는 깜박이거나 점프하거나 활성 출력 중에 이전 위치에 잠시 남아 있을 수 있습니다. 이 동작은 다른 기본 Windows 터미널 멀티플렉서 및 직접 VT 커서 위치 스트레스 테스트에서도 재현되므로 Herdr는 기본 커서 동작을 유지하면서 이를 제거할 수 없습니다.

시각적 안정성을 우선시하기 위해 기본 host_cursor = "auto"은 Herdr의 커서를 기본 Windows 및 WSL의 터미널 셀 콘텐츠로 그립니다. 다른 Linux 및 macOS 클라이언트는 기본 터미널 커서를 계속 사용합니다. 그려진 Windows 커서는 안정적이고 깜박이지 않지만 외부 터미널의 기본 깜박임, 모양 또는 커서 색상을 제공하지 않습니다.

Windows에서는 그려진 커서를 사용하여 IME 구성 및 후보 UI를 배치하지 않습니다. 따라서 한국어, 일본어 또는 중국어 IME UI가 잘못된 위치에 나타날 수 있습니다. 이것이 영향을 미치는 경우 외부 터미널 커서를 다시 선택하십시오.

[ui]
host_cursor = "native"

기본 모드는 IME 앵커를 복원하지만 활성 출력 중에 가끔 커서 깜박임, 점프 또는 오래된 커서 위치가 다시 나타날 수 있습니다.

Windows 터미널은 수정된 키를 모두 동일한 모양으로 보고하지 않습니다. Herdr는 Windows Terminal 및 Windows의 Alacritty에서 마우스 보고 및 ctrl+j을 유지합니다. 기본 Windows 입력 경로는 기본 ConPTY 패널을 통해 물리적 키 누르기, 반복, 놓기, 독립 실행형 Escape 및 shift+enter도 유지합니다. 수정된 키는 여전히 고유 키 이벤트를 보고하는 외부 터미널에 의존합니다. shift+enter를 일반 Enter로 보고하는 경우 Herdr는 일반 Enter만 전달할 수 있습니다.

Windows 패키지에는 Microsoft의 현재 앱 로컬 ConPTY 런타임이 포함되어 있습니다. 이전 Windows 10 빌드의 시스템 ConPTY가 Kimi 및 Pi와 같은 에이전트에서 사용하는 Kitty 키보드 프로토콜 시퀀스를 삭제하기 때문입니다. 번들 런타임과의 호환성 문제를 진단하는 경우에만 Herdr를 시작하기 전에 HERDR_WINDOWS_CONPTY=system을 설정하십시오.

Herdr의 패널 텍스트 복사는 Windows에서 작동합니다. Herdr를 통해 복사하려면 패널 내부에서 텍스트를 드래그하여 선택하세요.

텍스트를 붙여넣으려면 Windows 터미널에서 ctrl+shift+v을 사용하세요. 여러 줄의 텍스트 붙여넣기는 괄호로 묶여 있으므로 셸과 에이전트 프롬프트는 각 줄을 별도로 제출하는 대신 하나의 붙여넣기로 수신합니다. Herdr를 통해 클릭을 보내는 대신 외부 터미널 붙여넣기 작업을 사용하려면 shift을 누른 상태에서 마우스 오른쪽 버튼을 클릭하세요.

Windows 터미널에서는 Linux 및 macOS와 동일한 원격 명령을 사용합니다.

herdr --remote workbox

대상 호스트는 Linux, macOS 또는 Windows를 실행할 수 있습니다. Windows 호스트에서 원격 연결은 PATH 또는 활성 관리 릴리스의 호환 패키지를 재사용합니다. 필요한 경우 전체 패키지를 설치하거나 업데이트하기 전에 대화형 직접 연결 및 저장된 시스템 설정 프롬프트를 표시합니다. 백그라운드 저장 재연결은 설치된 패키지만 검색하며 설치 또는 업데이트를 묻는 메시지를 표시할 수 없습니다. Herdr는 설치된 Windows OpenSSH 클라이언트와 SSH 구성을 사용합니다. Windows OpenSSH는 Herdr의 Unix 제어 소켓 재사용을 사용하지 않으므로 원격 설정 중에 반복되는 프롬프트를 피하기 위해 Windows ssh-agent을 통한 키 인증을 권장합니다.

Windows 업데이트는 Windows 설치 프로그램을 통해 실행되며 활성 버전의 릴리스 경로를 업데이트합니다. 새 터미널과 다시 연결된 SSH 세션은 해당 경로를 수신합니다. 업데이트된 클라이언트를 사용하려면 거기서 Herdr를 시작하세요. 호환 가능하게 실행되는 서버는 해당 패널을 활성 상태로 유지합니다. 릴리스에서 서버 측 변경이 필요한 경우에만 나중에 서버를 다시 시작하십시오. 라이브 핸드오프는 Unix에서만 가능합니다.

포함:

• Herdr 버전.
• 윈도우 버전.
• 터미널 앱.
• PowerShell 또는 cmd와 같은 셸.
• HERDR_SESSION이라는 이름을 사용했는지 여부.
• 관련 Herdr 로그.
• 재현을 위한 정확한 단계.