01 / 수정과 검증
지금 어디까지 왔는지
오류 재현, 코드 수정, 테스트. 에이전트가 실제로 확인한 단계에 맞춰 진행 상황을 전합니다.
macOS · Codex Desktop & CLI
작업은 Codex에게.
시간은 당신에게.
Mac에서 시작한 작업, iPhone에서 이어보세요.
진행 상황부터 응답 종료 알림까지,
터미널을 다시 열어보는 시간을 줄입니다.
필요한 순간에, 필요한 소식만.인터랙션 예시 · 실제 알림 전송 없음
Mac의 작업iPhone으로 전달
LIVE ACTIVITY진행 중
로그인 오류 수정
오류를 재현했습니다.
수정 사항을 적용하고 있습니다.
재현수정검증
진행 알림 예시 · 실제 작업에 맞춰 상태가 갱신됩니다.
LESS CHECKING. MORE LIVING.
화면 앞을 떠나도,
작업의 흐름은 놓치지 않도록.
계속 지켜보는 대신, 의미 있는 변화가 생겼을 때 다시 확인하세요.
02 / 긴 조사
기다리는 동안에도
진행률을 알 수 없는 조사에는 경과 시간을 표시합니다. 측정하지 않은 숫자로 진척을 꾸미지 않습니다.
03 / 결과 확인
끝났다는 소식, 그 너머
응답 종료 알림에서 수행 내용과 검증 결과, 남은 문제를 확인하고 다음 행동을 결정하세요.
THREE ROLES. ONE WORKFLOW.
각자의 역할로,
하나의 작업을 이어줍니다.
진행 상황, 오래 걸리는 실행, 응답 종료.
서로 다른 신호를 구분해 연결합니다.
Desktop에서는 watchdog이 자동으로 시작되지 않습니다.
MCP
의미 있는 진행 알림
에이전트가 설치된 지침에 따라 실제 작업 단계에 맞춰 Live Activity를 시작하고 업데이트합니다.
Watchdog
오래 걸리는 CLI 실행 보완
래퍼로 실행한 단발성 CLI 작업에서 기본 60초가 지나도록 에이전트의 진행 알림이 없으면 외부 감시기가 보완합니다. CLI 지원에 따라 Live Activity 또는 Push를 사용합니다.
Notify hook
응답이 끝나는 순간의 알림
Codex 응답 종료 이벤트를 받아 알립니다. 기존 사용자 알림 연결도 함께 유지합니다.
사용 환경 준비
ActivitySmith 계정과 iOS 앱을 연결하고 알림을 허용하세요. Mac에는 zsh·Python 3.11 이상과 로그인한 Codex가 필요합니다. CLI 설치에는 Node.js/npm을 사용합니다.
압축을 풀고 설치
진행 중인 작업을 마친 뒤, 다운로드한 릴리스의 압축을 푼 폴더에서 실행하세요. 설정 마법사가 환경 확인과 API 키 등록을 안내합니다.
./setup.sh명령만 복사합니다. 웹페이지에서 실행하지 않습니다.
연결 확인과 휴대폰 테스트
ActivitySmith MCP를 연결하고 Codex와 터미널을 다시 여세요. watchsmith doctor로 설치를 점검하세요. 마지막으로 실제 휴대폰에 테스트 알림이 보이는지 확인합니다.
기존 설정을 존중하고,
보낼 내용을 선택합니다.
기존 알림 연결과 설정은 보존하고, API 키는 macOS Keychain에 저장합니다.
완료 미리보기는 요청·응답에서 선택한 텍스트를 ActivitySmith로 전송합니다. 내용 없는 일반 알림으로 설정할 수 있으며, 상세 메타데이터 공유에는 별도 동의가 필요합니다.
자주 묻는 질문
응답 종료 알림은 작업 성공을 의미하나요?
아닙니다. 응답 종료는 에이전트의 이번 응답이 끝났다는 뜻입니다. 작업 성공 여부는 실제 검증 결과와 남은 문제를 함께 확인해야 합니다. 서버가 알림 전송을 수락했다는 사실도 휴대폰 화면에 표시됐다는 증거는 아닙니다. 응답 종료와 작업 성공 알아보기 →
진행 알림과 완료 알림을 모두 연결해야 하나요?
진행 상황은 ActivitySmith MCP로, 완료 Push와 CLI 감시는 API 키로 연결합니다. 두 인증은 별개입니다. MCP 없이도 완료 Push와 CLI 감시는 사용할 수 있습니다. 연결 방식과 설정 순서 →
알림에 작업 내용을 표시하지 않을 수도 있나요?
가능합니다. 완료 알림을 보내는 실행 환경에 WATCHSMITH_COMPLETION_PREVIEW=0을 설정하면 내용 없는 일반 알림을 보냅니다. 공유 범위와 설정 방법 →
기존 설치를 업데이트하려면 어떻게 하나요?
watchsmith update --check로 먼저 확인하세요. 진행 중인 작업을 마치고 영향을 받는 클라이언트를 닫은 뒤 업데이트합니다. 업데이트·복구 안내 →
YOUR WORK. YOUR PACE.
다음 작업은 맡기고,
당신의 시간을 이어가세요.
실험적 어댑터 안내 · Claude Code와 Kiro 어댑터는 개발 단계로 v0.3.0에 포함되지 않습니다. 실제 클라이언트와 휴대폰 검증은 아직 남아 있습니다.