시작하기

Hwip은 두 가지를 잇습니다. 코딩 에이전트가 도는 컴퓨터, 그리고 주머니 속 휴대폰입니다.

1. 앱 설치와 로그인

App Store에서 Hwip을 설치하고 로그인합니다. 앱이 알림 허용을 물으면 허용하세요. 화면이 잠겨 있을 때도 질문이 닿습니다.

푸시는 읽을 앱이 있어야 갑니다. 계정에 로그인된 iPhone이 없으면 hwip notify와 hwip ask는 아무것도 보내지 않고 그 사실을 알려줍니다.

2. 컴퓨터 설정

npm install -g @hwip/cli
hwip install

hwip install이 console.hwip.app의 브라우저 로그인을 엽니다. 앱에서 쓴 같은 계정으로 로그인하세요. 연결을 승인하면 웹 앱이 API 키와 hook을 CLI에 넘기고, CLI가 둘을 ~/.hwip/config.json에 저장합니다. 복사할 것도, 붙여넣을 것도 없습니다.

이어서 CLI가 컴퓨터에서 찾은 에이전트를 나열하고 어느 것을 연결할지 묻습니다. 고른 에이전트에 rules·hooks·MCP 설정을 설치합니다. 다시 실행해도 안전합니다. 저장된 로그인은 그대로 쓰고, 에이전트 연동만 새로 고칩니다.

hwip install --only claude,codex   # 선택 화면 건너뛰기
hwip install --relogin             # 계정 바꾸기

이 컴퓨터에 브라우저가 없다면? SSH 접속이나 컨테이너 안이라면, 브라우저가 있는 컴퓨터에서 hwip install을 한 번 돌린 뒤 그쪽 ~/.hwip/config.json의 두 값을 넘깁니다.

hwip install --key ak_... --hook hook_...

tmux 설치

폰으로 조종하는 세션은 tmux 안에서 돕니다. hwip install이 tmux가 있는지 확인하고, macOS와 Homebrew 환경이면 brew install tmux 실행을 제안합니다. 그 밖의 환경에서는 설치 명령을 출력합니다. tmux는 Windows 빌드가 없으므로 Windows에서는 WSL을 쓰세요.

3. Hwip으로 에이전트 시작

hwip cc        # Claude Code
hwip codex     # Codex CLI
hwip gemini    # Gemini CLI
hwip pi        # pi
hwip opencode  # OpenCode

래퍼는 에이전트를 hwip-<project>라는 일반 tmux 세션에서 실행하고, 처음 쓸 때 백그라운드 listener를 띄우며, 뒤에 붙인 인자를 그대로 넘깁니다(hwip cc --resume). hwip install을 돌릴 때 이미 열려 있던 에이전트는 새 설정을 아직 읽지 않았으니 껐다 켜세요.

에이전트가 다음에 무언가 물으면 질문이 diff와 함께 폰에 도착합니다. 버튼을 탭하거나 직접 입력해 답하면 그 답이 세션에 입력됩니다.

얼마나 시끄러운가

hook은 연결한 에이전트의 모든 세션에서 동작합니다. hwip cc로 띄운 세션만이 아닙니다. Claude Code의 기본값은 조용한 쪽입니다. 에이전트가 무언가 물을 때, 그리고 자리를 비운 사이 세션이 끝날 때 푸시가 오고, 매 턴마다 오지는 않습니다.

명령	효과
`/hwip-mode normal`	실제 작업을 한 모든 턴에 푸시
`/hwip-mode loud`	모든 턴에 푸시
`/hwip-mode mute`	현재 프로젝트 완전 무음
`/hwip-mode`	지금 적용된 설정 보기

전체 다이얼은 푸시 모드에 있습니다.

뭔가 이상하다면

hwip verify

감지된 에이전트마다 설치 상태를 점검하고 빠진 것을 알려줍니다. --ping을 붙이면 실제 API 호출까지 해봅니다.

다음으로

에이전트 — Claude Code, Codex CLI, Gemini CLI, pi, OpenCode에서 무엇이 폰에 닿는지.
CLI & SDK — 폰에서 하는 원격 제어, 어떤 스크립트에서든 푸시 보내기.
MCP 서버 — 에이전트가 스스로 호출하는 도구. hwip_ask 등.
Claude Code 플러그인 — 2단계에서 이미 설치된 hook과 skill.