VibeShell Hook

에이전트가 끝나면
폰이 울립니다.

개발 머신에 스크립트 하나를 깔면 Claude Code 가 작업을 마칠 때 VibeShell 앱으로 푸시가 옵니다. 알림에는 마지막에 보낸 프롬프트가 들어 있어 무엇이 끝났는지 바로 압니다.

curl -fsSL https://www.wevesolutions.co.kr/downloads/hook/install.sh | bash -s -- --install

무료 · 토픽당 하루 5회 · Claude Code 자동, 4개 도구 수동

긴 작업을 맡겨 두고 자리를 뜹니다.

설치가 만드는 파일 그대로입니다.

스크립트는 파일 둘을 만들고 설정 하나를 고칩니다. ~/.vibeshell/hook.sh, ~/.vibeshell/push-config.json, 그리고 ~/.claude/settings.json 의 Stop hook. 아래는 그 원문입니다.

=== VibeShell Push Hook 관리 ===

메뉴:
  [1] 프로젝트 추가
  [2] 프로젝트 삭제
  [3] 프로젝트 활성화/비활성화
  [4] 토픽 ID 관리
  [5] 서버 URL 변경
  [6] 인증 토큰 갱신
  [7] 훅 스크립트 업데이트
  [0] 종료

선택:

{
  "server_url": "https://push.vibeshell.io",
  "enabled": true,
  "topic_ids": [
    "vbs_your_topic_id_here"
  ],
  "topic_tokens": {},
  "projects": {
    "my-project": {
      "paths": ["/Users/username/projects/my-project"],
      "enabled": true,
      "cli_tool": "claude-code"
    }
  }
}

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/Users/username/.vibeshell/hook.sh",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

설치는 다섯 가지를 묻습니다.

1. 1
   프로젝트명 — 알림에 표시될 이름
2. 2
   프로젝트 경로 — AI 코딩 도구를 실행하는 디렉터리. 기본은 현재 디렉터리
3. 3
   AI 코딩 도구 — Claude Code, Codex CLI, Gemini CLI, Aider, OpenCode 중 하나
4. 4
   토픽 ID — VibeShell 앱 설정 › 푸시 알림에서 복사. vbs_ 로 시작
5. 5
   Push 서버 URL — 기본값 https://push.vibeshell.io

알림은 네 가지를 통과해야 갑니다.

하지 않는 것을 적어 둡니다.

• 자동으로 걸리는 건 Claude Code 뿐입니다. Codex CLI, Gemini CLI, Aider, OpenCode 는 프롬프트를 읽을 줄은 알지만, 그 도구의 hook 에 hook.sh 를 거는 건 직접 해야 합니다.
• 토픽 하나에 하루 5번까지 갑니다. 넘으면 서버가 429 로 거절하고 hook 은 조용히 끝납니다.
• 서버를 지나는 건 프로젝트 이름과 프롬프트 100자입니다. 코드나 출력은 보내지 않습니다. 누가 보냈는지도 없습니다.
• 폰에서 답하지 않습니다. 알림을 누르면 앱이 열리고, 그다음은 SSH 로 들어가서 합니다.

가격

무료입니다. 푸시 서버는 우리가 운영하고, 토픽당 하루 5회까지 보냅니다.

같이 쓰는 것

VibeShell/Gateway/가이드

사양

자주 받는 질문 셋