Vibe Push
English
When you’re vibe-coding, you’ve probably stepped away—phone in hand or lying down—only to keep checking the screen because you’re not sure when the agent actually finished.
Vibe Push sends a push when coding looks complete, so you can come back to work without babysitting the editor.
When it helps
- Long generations, builds, or refactors while you take a short break
- Doing something else but wanting a clear “done” signal to return immediately
- Stepping away from the desk without missing the completion moment
Usage
- Open the folder (workspace) you’re working on in the editor. On first use, a connection QR may appear—scan it with the mobile app to pair this PC with your device.
- In the Command Palette, run commands starting with
VibePush: to show the connection QR, reset the UUID (switch devices), and turn AI completion detection on or off.
- Change detection timing, status bar, and more in Settings by searching for
vibePush. Details are in Settings below.
Settings
Open Settings and search for vibePush, or add keys to settings.json. Changes apply to the detector immediately after save.
| Key |
Default |
Description |
vibePush.enabled |
true |
Turn AI completion detection on or off |
vibePush.debounceDelay |
2000 |
Ms of quiet edits before a burst is considered ended; then enters cooldown |
vibePush.cooldownDelay |
10000 |
Extra wait (ms) before confirming completion; new edits in this window extend the session |
vibePush.minChangesThreshold |
1 |
Minimum document change events to count as activity |
vibePush.showStatusBar |
true |
Show VibePush in the status bar |
vibePush.logToOutput |
false |
If true, writes debug/info logs to the Output panel; if false, only errors (less focus stealing from Terminal in Cursor, etc.) |
settings.json example:
"vibePush.debounceDelay": 3000,
"vibePush.cooldownDelay": 15000
Nice touches
Step away—but don’t miss the finish.
What you need
You need the VS Code / Cursor extension or Claude Code from this repo, plus the mobile app that receives pushes. You can install the app using the QR below.
Download the mobile app
VS Code / Cursor extension
- Install VibePush from the Marketplace (or Install from VSIX in the Extensions view).
- Open a folder. On first launch, a connection QR may appear—scan it with the app.
- Command Palette:
VibePush: Show connection QR code, VibePush: Reset UUID (link new device) (e.g. new phone).
Configuration keys are listed in Settings above. VS Code 1.85+ recommended.
CLI — UUID setup & Claude Code hook
Node 18+ required.
npm install -g vibe-push # or: npx vibe-push
vibe-push # issue UUID + show QR — scan with the mobile app
- Config & UUID:
~/.vibe-push/config.json
--reset to renew UUID, --no-qr to skip QR display, -h for help
Claude Code hook
Claude Code's Stop hook fires the moment the agent finishes, so the push arrives instantly.
Add to ~/.claude/settings.json:
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "vibe-push hook"
}
]
}
]
}
}
Every time Claude Code stops, vibe-push hook sends a push notification to your phone.
Note: vibe-push hook reads ~/.vibe-push/config.json for the UUID. If no UUID is found, it exits silently (exit 0) so Claude Code is not interrupted.
Extension + CLI together
The extension and CLI share the UUID in ~/.vibe-push/config.json (editor storage is synced on launch). Pair once; both paths send to the same device. Use Reset UUID / --reset if you want a new pairing.
Security
Treat QR and UUID like a pairing secret. The extension and CLI bundles include the API base URL.
한국어
바이브 코딩할 때 이런 적 있죠. 에이전트에게 맡겨 두고 잠깐 딴짓—핸드폰을 보거나 누워 있다가, 언제 끝났는지 몰라서 자꾸 화면만 확인하게 될 때.
Vibe Push는 코딩이 완료됐을 때 푸시로 알려 줘서, 다시 작업으로 자연스럽게 돌아올 수 있게 돕는 앱입니다.
이럴 때 쓰면 좋아요
- 긴 생성·빌드·리팩터링을 맡겨 두고 잠깐 쉴 때
- 다른 일을 하다가도 “끝났다”는 신호만 받고 바로 복귀하고 싶을 때
- PC 앞을 비워 두고 싶지만, 완료 타이밍은 놓치고 싶지 않을 때
사용법
- 편집기에서 작업할 폴더(워크스페이스)를 연 뒤 사용합니다. 처음이면 연결 QR이 뜰 수 있으며, 모바일 앱으로 스캔해 이 PC와 기기를 연결합니다.
- 명령 팔레트에서
VibePush: 로 시작하는 명령으로 연결 QR 표시, UUID 초기화(기기 교체), AI 완료 감지 켜기/끄기를 할 수 있습니다.
- 감지 대기 시간·상태 표시줄 등은 설정에서
vibePush로 검색해 바꿀 수 있습니다. 자세한 항목은 아래 설정 절을 참고하세요.
명령 팔레트로 할 수 있는 것
Cmd+Shift+P(macOS) / Ctrl+Shift+P(Windows·Linux)로 명령 팔레트를 연 뒤 VibePush: 로 검색합니다.
| 명령 |
하는 일 |
VibePush: Show connection QR code |
연결 QR을 다시 띄웁니다. 앱으로 스캔해 이 PC와 기기를 맞출 때 사용합니다. |
VibePush: Reset UUID (link new device) |
UUID를 초기화합니다. 폰을 바꾸거나 처음부터 다시 연결할 때 사용합니다. |
VibePush: Enable AI completion detection |
AI 완료 감지를 켭니다. 설정 vibePush.enabled와 같이 맞춰집니다. |
VibePush: Disable AI completion detection |
AI 완료 감지를 끕니다. |
설정
설정(Preferences) UI에서 vibePush로 검색하거나, settings.json에 넣어도 됩니다. 값을 바꾸면 저장 즉시 감지기에 반영됩니다.
| 설정 키 |
기본값 |
설명 |
vibePush.enabled |
true |
AI 완료 감지 전체 켜기/끄기 |
vibePush.debounceDelay |
2000 |
변경이 잠잠해진 뒤 “한 번에 몰아친 편집이 끝났다”고 볼 때까지 대기(ms). 이후 쿨다운 단계로 넘어갑니다. |
vibePush.cooldownDelay |
10000 |
위 단계 이후, 완료로 확정하기 전에 추가로 기다리는 시간(ms). 이 안에 다시 고치면 같은 세션으로 이어집니다. |
vibePush.minChangesThreshold |
1 |
AI 활동으로 볼 최소 문서 변경 횟수 |
vibePush.showStatusBar |
true |
상태 표시줄에 VibePush 표시 여부 |
vibePush.logToOutput |
false |
true면 디버그·정보 로그를 출력 패널에도 씁니다. false면 오류만 출력해 터미널 포커스를 덜 뺏습니다(Cursor 등). |
settings.json 예:
"vibePush.debounceDelay": 3000,
"vibePush.cooldownDelay": 15000
딴짓은 하되, 완료만은 놓치지 마세요.
Claude Code hook 설정
Claude Code를 쓴다면 hook을 설정하는 게 더 빠릅니다. Claude Code의 Stop hook은 에이전트가 작업을 마친 순간 바로 실행되므로, 파일 변경을 기다릴 필요 없이 즉시 푸시가 전송됩니다.
1. 설치 및 연결
npm install -g vibe-push # 또는: npx vibe-push (처음 한 번 실행해 UUID 발급 + QR 표시)
vibe-push # 터미널에 뜨는 QR을 모바일 앱으로 스캔
2. ~/.claude/settings.json에 hook 추가
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "vibe-push hook"
}
]
}
]
}
}
이걸로 끝입니다. Claude Code가 작업을 마칠 때마다 vibe-push hook이 자동으로 실행되어 푸시 알림을 전송합니다.
참고: vibe-push hook은 ~/.vibe-push/config.json에서 UUID를 읽습니다. UUID가 없으면 Claude Code의 흐름을 방해하지 않도록 조용히 종료(exit 0)됩니다.
준비물
이 저장소의 VS Code / Cursor 확장 또는 Claude Code, 그리고 푸시를 받을 모바일 앱이 필요합니다. 앱은 아래 QR로 설치할 수 있습니다.
모바일 앱 받기
