터미널 직접 연결
휴대폰 / Pad ↔ 사용자 호스트
SSH, Mosh, SFTP는 사용자 호스트에 직접 연결됩니다. 이 경로에는 사용자가 설정한 프록시나 배스천만 포함됩니다.
자세히 보기
SSH, Mosh, SFTP는 사용자 호스트에 직접 연결됩니다. 이 경로에는 사용자가 설정한 프록시나 배스천만 포함됩니다.
AI AGENT 콘솔 · PHONE & PAD
에이전트 곁에, 언제나. 어디에 있든.
먼저 Agent 수신함에서 처리하고, 완전한 제어가 필요할 때 실제 SSH/Mosh 터미널로 바로 전환하세요.
DuckTerm
세션 스냅샷
프로젝트호스트시간
DuckTerm · release-preview ● Ran test suite — all checks passed. ✻ Baked for 4m 22s › opus 4.8 xhigh DuckTerm Context 79% used ▶▶ bypass permissions on (shift+tab to cycle)
저장된 연결 · 3
Studio Mac demo@192.0.2.10
ubuntu26 (프록시) root@10.0.0.42
http debian (점프 호스트) deploy@bastion.lan
via 
Codex
Studio Mac t codex-release ⌑ DuckTerm
2 Studio Mac t codex-release ⌑ DuckTerm 라이브 미리보기 218×57 · 7.6KB · 0B/s · 0fps · LAN ping
› Review the release diff and run the tests. ● Ran test suite — all checks passed. $ tmux attach -t release-review > 완료. auth 버그 수정됨. > 테스트 8개 통과. $ git status 커밋할 변경 사항 없음 ──────────────────────────────────── › Codex xhigh · Context 69% used · DuckTerm 1 background terminal running · /ps to view ✓ Codex [codex-release]
Done: review complete.
- 테스트 8개 통과.
- 커밋할 변경 사항 없음
- Reply delivered to the active tmux session.
에이전트에 답장하거나 터미널 명령 보내기…
PAD · 적응형 워크스페이스
수신함, 채팅, 터미널을 한 화면에.
Apple 및 Android 와이드 화면에서 DuckTerm은 전체 워크스페이스 내비게이션과 수신함 목록을 유지하고, 확장형 터미널 라이브 미리보기를 네이티브 채팅 위에 표시합니다.
전체 워크스페이스 내비게이션수신함 목록 + 네이티브 채팅확장형 터미널 라이브 미리보기
9:41●●● 100%
모든 호스트⌄2883 개 메시지
Live WSS+Bridge
Claude Code15tclaude-review
Alert> 릴리스 diff 검토 중…
Codex4tcodex-release
Mixed> 테스트 8개 통과. 차단 이슈 없음.
Pitpi-apns-v12
MixedAPNs smoke run completed.
OpenCodetglm-term-review
DoneReply delivered to tmux.
Antigravitytagy-term-review
DoneCross-review request.
Grok Buildtgrok-term-review
MixedCompletion received.
CodexStudio Mac t codex-release ⌑ DuckTerm2라이브 미리보기218×57 · 7.6KB · 0B/s · 0fps · LAN ping▣ ↗ ⌃
› Review the release diff and run the tests. ● Ran test suite — all checks passed. $ tmux attach -t release-review✓ Studio Mac에 연결됨> 릴리스 diff 검토 중… › Codex xhigh · Context 69% used · DuckTerm 1 background terminal running · /ps to view ✓ Codex [codex-release]
Done: review complete.
- > 테스트 8개 통과. 차단 이슈 없음.
- ✓ 다음 명령을 실행할 준비가 됐습니다.
- Reply delivered to the active tmux session.
에이전트에 답장하거나 터미널 명령 보내기…↗
⌕ ▱
$ duckterm-hookd setup --qr
[ok] Hookd installed with local Web UI
[ok] Background service is running
Open DuckTerm → Settings → Agent notifications
One-time pairing QR Waiting for your phone to confirm Expires in 5 minutes
waiting for confirmation
‹Pair Hookd
Scan the QR shown in your terminal
Camera access stays on this device iPhone Pad Android Phone Android Pad
hookd — 푸시 데몬
휴대폰에는 앱 하나, 에이전트가 도는 머신 옆에는 작은 데몬 하나.
에이전트 옆의 macOS, 네이티브 Windows 또는 Linux 머신에서 실행됩니다. 한 명령으로 로컬 Web UI가 포함된 hookd를 설치하고 QR을 표시한 뒤 hook 연결과 서비스 시작까지 진행됩니다. Windows는 체크섬을 검증하는 PowerShell 설치 프로그램을 사용하며 WSL은 별도의 Linux 대상으로 유지됩니다.
명령을 실행하고 QR 스캔 아래는 그대로 실행할 수 있는 완전한 명령입니다. 패키지에 로컬 Web UI가 포함되며 모바일 자격 증명을 셸 기록에 남기지 않고 QR을 표시합니다. 연동 가이드
macOS / Linux
brew install ducksee/tap/duckterm-hookd && \ "$(brew --prefix duckterm-hookd)/bin/duckterm-hookd" setup --qr curl -fsSL https://raw.githubusercontent.com/ducksee/duckterm-hookd-releases/main/install.sh \ | DUCKTERM_PAIR_QR=1 sh Windows
irm https://raw.githubusercontent.com/ducksee/duckterm-hookd-releases/main/install.ps1 | iex curl.exe -fsSL https://raw.githubusercontent.com/ducksee/duckterm-hookd-releases/main/install.cmd -o install.cmd && install.cmd curl -fsSL https://raw.githubusercontent.com/ducksee/duckterm-hookd-releases/main/install.sh \ | DUCKTERM_PAIR_QR=1 sh 검증된 에이전트 연동
실제 검증한 워크플로 14개, 하나의 Agent 수신함
14 전체 14개의 상태·세션 지원
13 연동 13개가 계약 v1에 정의됨
10 연결된 모바일 결정 경로
Claude Code Codex Grok Build Antigravity 
Cursor OpenCode Pi 
Devin 
Droid 
Qoder 
Amp 
Gemini 
DeepSeek Harness 
Kimi Code 추가로 검증된 호환 워크플로 1개
데이터 경로 · 모호함 없이
터미널 트래픽은 직접, 클라우드 경로는 명확하게.
DuckTerm은 터미널 데이터 경로를 선택 사항인 에이전트·동기화·음성 서비스와 분리합니다. 아래는 현재 앱이 실제로 사용하는 경로입니다.
에이전트 릴레이
상호작용: hookd ↔ 릴레이 ↔ 앱 · 알림: 릴레이 → APNs/FCM → 앱
이벤트, 승인, 답장, Live Preview 대체 경로가 DuckTerm 릴레이를 거칠 수 있고, 알림은 릴레이에서 APNs/FCM을 통해 전달됩니다. 미리보기와 이미지 데이터는 가능한 경우 LAN/P2P를 우선하며, P2P가 TURN을 사용할 수 있습니다.
자세히 보기
이벤트, 승인, 답장, Live Preview 대체 경로가 DuckTerm 릴레이를 거칠 수 있고, 알림은 릴레이에서 APNs/FCM을 통해 전달됩니다. 미리보기와 이미지 데이터는 가능한 경우 LAN/P2P를 우선하며, P2P가 TURN을 사용할 수 있습니다.
iOS 동기화
CloudKit · Keychain · KVS
앱 동기화를 켜면 CloudKit이 서버 메타데이터와 워크스페이스를 동기화하며, 이 경로는 앱 동기화 스위치로 제어됩니다. 자격 증명 동기화 여부는 시스템 iCloud Keychain 설정이 결정하며 앱 동기화 스위치와 무관합니다. 페어링 bearer는 Keychain + iCloud KVS를 사용하고 이 경로 역시 해당 스위치와 무관합니다.
자세히 보기
앱 동기화를 켜면 CloudKit이 서버 메타데이터와 워크스페이스를 동기화하며, 이 경로는 앱 동기화 스위치로 제어됩니다. 자격 증명 동기화 여부는 시스템 iCloud Keychain 설정이 결정하며 앱 동기화 스위치와 무관합니다. 페어링 bearer는 Keychain + iCloud KVS를 사용하고 이 경로 역시 해당 스위치와 무관합니다.
Android 동기화
Drive appDataFolder · Keystore
Drive 동기화를 켜면 전체 볼트가 비공개 appDataFolder에 저장됩니다. 자격 증명 필드 암호화는 선택 사항이고 기본으로 꺼져 있으며, 다른 볼트 데이터는 파일 안에 평문으로 남습니다. Google은 전송과 저장을 보호합니다.
자세히 보기
Drive 동기화를 켜면 전체 볼트가 비공개 appDataFolder에 저장됩니다. 자격 증명 필드 암호화는 선택 사항이고 기본으로 꺼져 있으며, 다른 볼트 데이터는 파일 안에 평문으로 남습니다. Google은 전송과 저장을 보호합니다.
데이터마다 다른 보관 기간
알림 이벤트 내용은 릴레이가 수신한 뒤 약 60–65분 시점에 삭제할 예정이며, 정리 작업은 5분마다 및 서비스 시작 시 실행됩니다. Live Activity 내용은 팔로우 해제 후 약 1분 안에 비우고, 상태는 마지막 이벤트로부터 약 24시간 뒤 삭제합니다. 라우팅과 전달 메타데이터에는 별도의 보관 기준이 적용됩니다.
음성 경로는 선택에 따라 다릅니다
시스템 음성 인식은 플랫폼 제공업체의 네트워크를 사용할 수 있습니다. 실험적 ChatGPT 음성은 임시 클립을 릴레이와 페어링된 데몬을 거쳐 OpenAI로 보냅니다.
데이터마다 다른 보관 기간
자세히 보기
알림 이벤트 내용은 릴레이가 수신한 뒤 약 60–65분 시점에 삭제할 예정이며, 정리 작업은 5분마다 및 서비스 시작 시 실행됩니다. Live Activity 내용은 팔로우 해제 후 약 1분 안에 비우고, 상태는 마지막 이벤트로부터 약 24시간 뒤 삭제합니다. 라우팅과 전달 메타데이터에는 별도의 보관 기준이 적용됩니다.
음성 경로는 선택에 따라 다릅니다
자세히 보기
시스템 음성 인식은 플랫폼 제공업체의 네트워크를 사용할 수 있습니다. 실험적 ChatGPT 음성은 임시 클립을 릴레이와 페어링된 데몬을 거쳐 OpenAI로 보냅니다.
iCloud와 Google Drive는 서로 동기화하지 않습니다. 저장, 암호화, 삭제, 서드파티 처리에 대한 더 자세한 내용은 개인정보 처리방침을 확인하세요.
작동 방식
세 단계면 첫 푸시가 도착합니다.
에이전트 머신에서 설치 명령을 실행하고 DuckTerm으로 일회용 QR을 스캔하세요. 별도 hookd 가입이나 클라우드 대시보드는 필요 없습니다.
1
Agent 알림 열기
DuckTerm의 설정 → Agent 알림을 열어 QR 스캐너를 준비하세요.
2
명령 실행 후 QR 스캔
명령은 로컬 Web UI가 포함된 hookd를 설치하고 일회용 QR을 표시합니다. 스캔하면 지원 에이전트 hook과 서비스가 설정됩니다.
3
확인하고 시작
duckterm-hookd status를 확인한 뒤 앱에서 로컬 푸시와 플랫폼 푸시를 테스트하세요. 이후 업그레이드나 서비스 재시작에도 페어링은 유지됩니다.
무엇을 얻나요
AI 멀티 에이전트 운영자를 위해 다듬었습니다.
매핑된 Agent 수명주기 이벤트, 직접 들어가는 tmux/psmux/Herdr 세션, 약한 네트워크에서도 안정적인 SSH/Mosh. 무료 버전만으로도 충분히 쓸모 있고, Pro는 장시간 터미널 작업 기능을 더합니다.
멀티 에이전트 수신함
테스트된 14개 Agent 워크플로의 상태·세션 이벤트와 지원 에이전트의 승인을 Markdown 본문과 함께 하나의 피드로.
무료: 30일 보관 무제한
지속 세션 런타임
장시간 도는 tmux, Windows psmux, Herdr 작업에 폰에서 직접 들어가 ANSI 컬러·마우스·스크롤백을 사용합니다.
무료: 탭 2개 무제한 + attach
Mosh 로밍
UDP 전송 + 예측 에코. Wi-Fi → 5G → 지하철 → 카페를 오가도 에이전트 세션이 유지됩니다.
무료: — Pro
멀티 호스트 SSH
비밀번호 + 개인 키(.pem) + ProxyJump 배스천 + HTTP/SOCKS5 프록시. 어떤 프로덕션 호스트든 바로 접속.
무료: 2대 무제한 + 배스천
완전한 SFTP
파일 탐색·미리보기·쓰기까지. 별도 전송 앱으로 우회할 필요 없음.
무료: — Pro
음성 + 테마 + 플랫폼 동기화
음성 입력, 커스텀 테마, iOS iCloud 동기화와 Android 비공개 Google Drive appDataFolder 동기화.
무료: — Pro
PROJECT WORKBENCH
파일과 Git을 Agent 대화 바로 옆에서.
Inbox 세션에 연결된 신뢰 프로젝트를 열어 별도의 코드나 Git 클라이언트 없이 작업합니다.
- 트리를 탐색하고 텍스트·이미지·문서를 미리 봅니다.
- 상태, diff, 이력, 개별 커밋을 검토합니다.
- stage, unstage, discard, fetch, pull, push를 명시적 동작으로 실행합니다.
hookd가 신뢰 프로젝트와 세션 컨텍스트를 제공할 때만 표시되며 채팅 내용에서 변경 작업을 추측하지 않습니다.
DuckTerm/src
DIRECT FIRST
가장 짧고 신뢰할 수 있는 경로를 먼저, Relay는 안전망으로.
DuckTerm은 한 번에 하나의 데이터 경로를 선택하며 공개 엔드포인트나 공유 Relay보다 LAN과 피어 연결을 우선합니다.
- 01 LAN Direct같은 LAN 또는 신뢰 VPN/프라이빗 오버레이에서 가장 빠릅니다.
- 02 인증 P2PLAN이 호스트에 닿지 않을 때 사용하는 인증 피어 경로입니다.
- 03 Public DirectCloudflare Tunnel, frp, rathole 또는 리버스 프록시를 통한 자체 HTTPS/WSS입니다.
- 04 Secure Relay직접 경로가 없을 때 사용하는 관리형 폴백입니다.
권장 구성같은 LAN이나 VPN/프라이빗 오버레이를 우선하세요. 인프라 운영이 가능하면 Cloudflare Tunnel, frp/rathole, Tailscale Funnel 또는 HTTPS 리버스 프록시를 사용할 수 있습니다.
Public Direct 경계hookd 루프백 11435만 프록시하세요. LAN 11434나 로컬 관리 20080을 인터넷에 노출하지 마세요.
전체 비교표
연결
무료 Pro
- SSH 서버 수 ≤ 2 무제한
- SSH 로그인 방식 비밀번호 비밀번호 + 개인 키 (.pem)
- 동시 탭 ≤ 2 무제한
- tmux / psmux / Herdr 세션 직접 진입 — 지원
- Mosh (UDP 로밍 + 예측 에코) — 지원
- HTTP CONNECT / SOCKS5 프록시 — 지원
- ProxyJump 배스천 호스트 — 지원
- LAN → P2P → Public → Relay 자동 선택 지원 지원
파일 & 터미널
무료 Pro
- SFTP 파일 탐색 + 미리보기 — 지원
- 프로젝트 파일 + Git 워크벤치 지원 지원
- Snippets ≤ 3 무제한
- 커스텀 단축키 ≤ 3 무제한
- Workspaces 1 무제한
- 수신함 보관 기간 30일 무제한
고급 & 자동화
무료 Pro
- 트리거 규칙 — 지원 (기본 꺼짐)
- Agent 페어링 + 수신함 지원 지원
- 플랫폼 푸시 전달 체험 + 일일 한도 무제한
- 음성 입력 (Mic / Wispr) — 지원
외관 & 동기화
무료 Pro
- 커스텀 테마 — 지원
- iCloud (iOS) / Google Drive (Android) 동기화 — 지원
가격
무료로 시작하고, 필요할 때 Pro로.
계정 가입도 광고도 없습니다. 소액 구독 하나 — 또는 한 번의 평생 구매 — 로 모든 기능이 열립니다.
무료
$0 영구 무료
일상적으로 충분히 쓸모 있는 기본기.
- SSH 서버 2대 (비밀번호 인증)
- 동시 탭 2개
- 멀티 에이전트 수신함 · 30일 보관
- tmux · psmux · Herdr 세션 스냅샷
가장 인기
Pro
$0.99 /월 · 또는 연 $9.99
모든 기능, 무제한.
- 무제한 서버 + 개인 키 (.pem)
- tmux · psmux · Herdr 진입 · Mosh · SFTP
- HTTP/SOCKS5 프록시 + ProxyJump 배스천
- 음성 · 테마 · iCloud / Google Drive 동기화
가격은 USD 기준이며 구매한 스토어가 결제합니다(iOS는 App Store, Android는 Google Play). 구독은 해당 스토어의 구독 설정에서 언제든 해지할 수 있으며, 평생 구매는 일회성 결제라 해지할 것이 없습니다. 구매는 같은 스토어 계정의 기기 간에 복원됩니다.
오래 운영하기 위해
실제로 쓸 수 있는 무료 도구에도 계속 드는 비용이 있습니다.
DuckTerm은 유용한 무료 등급을 유지합니다. Pro 구매와 인프라 후원은 공유 Relay, 모바일 배포, 릴리스 도구 비용에 사용됩니다.
계속 운영하는 항목
모금 목표가 아닌, 이해하기 쉬운 운영 비용 스냅샷입니다.
- 공용 Relay + 대역폭 지역별 인바운드/아웃바운드, TLS, 저장소, 악용 방지.
- 지속 · 사용량 기반
- Apple Developer Program iPhone 및 Pad 릴리스 배포와 유지에 필요합니다.
- $99 / 년 공식 가격
- Google Play Console Android 릴리스 게시에 필요합니다.
- $25 / 1회 공식 가격
- 개발 + AI 도구 구독 리뷰, 진단, 번역, 구현 도구입니다.
- 약 $200 / 월
- Expo / EAS 공개된 Starter 및 Production 요금제이며 실제 비용은 사용량에 따라 달라집니다.
- $19–$199 / 월 + 사용량 공식 가격
세전 USD. 공급자 가격은 2026년 8월 확인했으며 Relay와 내부 구독은 사용량에 따라 변하는 운영 추정치입니다.
클라우드 후원
남는 크레딧이나 용량을 유용한 곳에 쓰고 싶으신가요?
공유 경로 유지 비용을 낮출 수 있는 클라우드 크레딧, 지역 대역폭 또는 Relay 용량 후원을 환영합니다.
- 인프라를 유료 장벽으로 만들지 않고 더 많은 Relay 지역을 유지합니다.
- 빌드, 배포, 신뢰성 작업을 지원하며 사용자 데이터 접근 권한은 제공하지 않습니다.
- 원한다면 운영 비용 후원자로 표시하되 제품 결정권은 부여하지 않습니다.
클라우드 후원 제안
후원은 터미널 트래픽, SSH 자격 증명, 사용자 데이터 또는 비공개 운영에 대한 접근을 절대 포함하지 않습니다.