Joonseo Jung
Clawd for Orca 커버 이미지

Clawd for Orca

Orca에서 실행 중인 코딩 에이전트의 승인·답장·터미널 조작을 데스크톱에서 바로 처리하는 macOS·Windows 데스크톱 펫

개요

Orca에서 여러 코딩 에이전트를 동시에 돌리다 보면, 에이전트가 승인이나 답변을 기다리는 순간을 놓치기 쉽습니다. Clawd는 화면 구석에 머무는 데스크톱 펫으로, 에이전트가 사람을 기다리면 카드를 들어 알려 주고, Orca를 열지 않고도 그 자리에서 승인, 답장, 터미널 조작까지 할 수 있게 만든 앱입니다.

주요 작업

  • 에이전트가 승인·답변을 기다리면 카드로 알리고, 확인할 때까지 다시 알리는 알림 흐름 구성
  • 에이전트를 상태별로 묶고 Claude Code의 작업 과정을 단계별로 보여 주는 채팅 화면
  • 권한 요청을 버튼과 단축키(⌘1~⌘3)로 바로 응답하고, 입력한 메시지를 에이전트 터미널로 전송
  • Orca와 페어링해 색상·입력까지 그대로 쓰는 실시간 터미널 제공
  • macOS는 Swift, Windows는 WinUI 3로 각각 만든 네이티브 앱과 Sparkle·MSI 기반 자동 업데이트

구현 메모

Clawd는 2초마다 Orca의 로컬 소켓(Windows는 named pipe)으로 각 에이전트의 상태와 사용 중인 도구, 마지막 메시지를 가져오고, 메시지·키 입력·권한 응답은 Orca의 terminal.* 명령으로 보냅니다. Orca가 pane마다 붙이는 ORCA_PANE_KEY로 Claude Code 세션 로그(.jsonl)를 매칭해, 같은 폴더의 여러 세션도 구분해서 진행 상황을 보여 줍니다.

실시간 터미널은 Orca의 종단 간 암호화 WebSocket을 다시 구현하지 않고, Orca에 포함된 Node로 작은 브리지 스크립트를 실행해 Orca의 연결 코드를 그대로 재사용했습니다. Mac 앱은 다운로드 크기 3.7 MB, 대기 중 CPU 사용률 약 1% 수준으로 가볍게 유지했습니다.

갤러리