rdp-cli

AI Agent의 원격 데스크톱을 보고, 일시 중지하고 직접 제어하기

대상 버전 및 환경: 0.1.2 · Windows / macOS · RDP / VNC

기존 세션 열기

Mac에서는 메뉴 막대 아이콘, Windows에서는 알림 영역 메뉴에서 이름이나 주소로 실행 중인 세션을 선택합니다. 아래는 기본 창과 브라우저를 여는 각각의 명령입니다. 브라우저는 LAN 또는 VPN에서 접근 권한을 설정해 사용합니다. 공개 사이트 rdp-cli.com이 원격 뷰어인 것은 아닙니다.

Windows PowerShell에서는 실행 파일이 있는 폴더로 이동한 뒤 아래 명령의 rdp-cli를 .\rdp-cli.exe로 바꾸세요.

rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web

제어권을 가져오지 않고 보기

뷰어는 보기 전용으로 시작합니다. 클릭 표시, 드래그 경로, 스크롤과 입력 진행 상황으로 Agent 동작을 확인할 수 있습니다. 입력 힌트에 실제 텍스트는 반복하지 않지만 원격 앱 화면에는 보일 수 있습니다. 힌트는 자동 화면 가림 기능이 아닙니다. 기본 창의 FX 또는 F8, 브라우저의 Actions로 뷰어마다 끌 수 있습니다. 여러 뷰어가 동시에 볼 수 있습니다.

일시 정지하고 수정하기

PAUSE는 일반 입력을 멈춥니다. TAKE로 마우스와 키보드 제어권을 가져옵니다. 제어권을 가진 뷰어는 하나뿐이며 그동안 Agent 입력은 거부됩니다. 예를 들어 편집기의 한 줄을 직접 고쳐 확인할 수 있습니다. 로그인, 환영 또는 처리 중 화면에서도 입력을 시도할 수 있으며 반응 여부는 앱에 달려 있습니다. RDP 마이크는 제어권을 가진 상태에서 명시적으로 켜고 시스템 권한을 허용해야 합니다. VNC에는 마이크 기능이 없습니다.

제어권 돌려주기

RELEASE를 누르면 제어권을 반환하고 마이크도 멈춥니다. 사용할 수 있는 Agent 식별자가 없으면 세션은 일시 정지 상태를 유지합니다. Agent는 새 스크린샷과 관찰 값을 받아 수정 사항을 확인하고 계속해야 합니다. 사람이 끝낸 동작을 다시 실행하지 마세요.

창을 닫으면 어떻게 되나요

보기 전용 뷰어를 닫아도 원격 연결은 유지됩니다. 제어권을 가진 뷰어를 닫거나 연결이 끊기면 세션이 일시 정지됩니다. 재연결 후에도 새로운 관찰과 일시 정지 상태 처리가 필요합니다. 권한과 RDP/VNC 차이는 기능 안내에서 확인하세요.

관련 글

rdp-cli의 확장 명령

먼저 rdp-cli --version을 실행하세요. 아래 명령은 agent_execution.contract_version이 1인 빌드가 필요합니다. 이전 버전에서는 위의 단일 작업 방식을 계속 사용할 수 있습니다.

대문자 자리표시자는 실제 반환값으로 바꾸세요. Windows PowerShell에서는 프로그램 폴더에서 .\rdp-cli.exe를 사용하고, macOS·Linux에서는 설치한 명령 또는 실제 실행 파일 경로를 사용합니다.

여러 에이전트와 사람 사이의 제어 인계

등록된 에이전트가 제어권을 명시적으로 넘깁니다. 사람은 GUI나 웹으로 제어를 이어받고 지정한 에이전트에 돌려줄 수 있습니다. 에이전트는 새 화면을 확인한 뒤 조작합니다.

등록하면 에이전트 ID와 자격 증명 참조가 반환됩니다. 세션 소유자가 권한을 부여한 뒤 에이전트는 반환된 claim 참조로 임대를 명시적으로 갱신합니다. 사람이 제어권을 가져가면 이전 관찰은 무효가 되므로 제어권을 돌려받은 후 화면을 다시 확인하세요.

rdp-cli agents register --name Writer
rdp-cli agents grant --session SESSION --id AGENT_ID --permission read --permission control
rdp-cli control claim --session SESSION --agent-id AGENT_ID --agent-ref AGENT_REF
rdp-cli control renew --session SESSION --agent-id AGENT_ID --agent-ref AGENT_REF --claim-ref CLAIM_REF

내 원격 데스크톱에서 시작하기

rdp-cli 다운로드 · 사용하는 플랫폼의 빠른 시작 보기