Vibez – Bloqueador de Apps para Agentes de IA
Peter-Zhao-751/Vibez
Bloqueia distrações no iPhone quando seu agente de IA precisa de você
Ver no GitHubVibez conecta agentes de código (Claude Code, Codex, Cursor) a um escudo de Screen Time no iOS, bloqueando apps distraidores quando o agente precisa de sua atenção. Quando o agente fica ocioso, solicita permissão ou termina uma tarefa, aplicativos selecionados trancam até você retornar e responder.
Instalação
npx convez-ai Peter-Zhao-751/Vibez1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter foco durante sessões de coding com agentes de IA
- Receber notificações de agentes com bloqueio automático de redes sociais
- Sincronizar múltiplos agentes (Claude, Codex, Cursor) em um único pareamento
Veredito

Solução criativa para um problema real: agentes de IA que automatizam código mas deixam sua atenção como gargalo. Implementação técnica sólida (Screen Time API, Firebase, plugins multiplataforma), mas usuário base ainda limitado ao ecossistema Apple e fluxo de coding específico.
README
A tradução para o português deste README ainda está na fila.
Block distracting apps when your coding agent needs you back.
Vibez connects Claude Code, Codex, and Cursor lifecycle events to an iOS Screen Time shield. When your agent stops, asks for permission, or needs a reply, your selected apps lock until you return.
iOS Screen Time API · Claude Code plugin · Codex plugin · Cursor plugin · Firebase Cloud Messaging
What It Does
Coding agents create a weird failure mode: the work is automated, but your attention is still the bottleneck. Vibez turns agent idle states into a phone-side block signal.
| Agent event | Vibez plugin | iOS app |
|---|---|---|
| First session after install | Generates a private 4-word Vibez ID and prints it. | Enter the ID once in the Setup card to pair this Mac with your phone. |
| Permission request, question, or idle prompt | Sends a needs-input push with shield:on. | Records the trigger, shows the message, and applies the Screen Time shield. |
| Agent stops after a response | Sends a done push with a short assistant excerpt and shield:on. | Keeps selected apps blocked for the configured window. |
| You submit the next prompt | Sends a replied push with shield:off. | Clears that session's trigger and lifts the shield when no triggers remain. |
The Claude Code, Codex, and Cursor plugins share one Vibez ID at ~/.config/vibez/vibez-id, so a single pairing on your phone covers every agent.
Components
| Path | Status | Purpose |
|---|---|---|
ClaudePlugin/ | Working | Claude Code plugin for SessionStart, Notification, PreToolUse, PostToolUse, Stop, and UserPromptSubmit hooks. |
CodexPlugin/ | Working | Codex plugin for SessionStart, PermissionRequest, PreToolUse, PostToolUse, Stop, and UserPromptSubmit hooks. |
CursorPlugin/ | Working | Cursor agent hooks (sessionStart, beforeSubmitPrompt, afterAgentResponse, stop, sessionEnd), installed via npx vibez-cursor. |
Vibez/ | On the App Store | SwiftUI iOS app that receives FCM pushes, records recent triggers, and applies Family Controls / Managed Settings shields. |
Backend/ | Working | Firebase Cloud Functions (registerPushToken, notify, dispatchUnblock) that pair devices and fan out pushes via FCM. |
VibezExtension/ | Local build | Chrome (MV3) extension that mirrors the block on desktop browsers. |
assets/ | Working assets | Logo, glyph, icon, and README artwork. |
Install Agent Plugins
One command — it detects Claude Code, Codex, and Cursor and installs for each:
npx getvibez
Then open a new agent session: it prints your private 4-word Vibez ID — enter it once in the iOS app and you're paired (one ID covers every agent). To see the ID again, run /vibez:setup in Claude Code, $vibez-setup in Codex, or npx vibez-cursor --id; /vibez:setup test sends a test push. Re-run npx getvibez anytime to update. Requires Node ≥ 18; Codex asks you to trust the plugin's hooks on first launch — that's expected.
Full details: ClaudePlugin/README.md · CodexPlugin/README.md · CursorPlugin/README.md
Claude Code
/plugin marketplace add Peter-Zhao-751/Vibez
/plugin install vibez@plugin
Codex
codex plugin marketplace add Peter-Zhao-751/Vibez
codex plugin add vibez@vibez
Cursor
npx vibez-cursor
(Cursor has no plugin manager — the installer registers the hooks in ~/.cursor/hooks.json directly; npx vibez-cursor --uninstall removes them.)
iOS App
AI Coding Focus — Vibez is free on the App Store.
The app is built around Apple's FamilyControls and ManagedSettings frameworks:
- Enter your 4-word Vibez ID.
- Grant notification permission.
- Grant Screen Time / Family Controls permission.
- Pick the apps, categories, or websites to shield.
- Leave Vibez enabled while your agent works.
Building from source instead needs a paid Apple Developer Program team because Apple does not grant the family-controls entitlement to personal teams. The simulator is useful for compile checks, but Screen Time shields are no-ops there.
Configuration
All plugins read the same optional environment overrides:
| Variable | Default | Purpose |
|---|---|---|
VIBEZ_ID | from ~/.config/vibez/vibez-id | Force a specific Vibez ID — e.g. to drive several machines from one ID without copying the file. |
VIBEZ_BACKEND_URL | https://us-central1-vibez-backend.cloudfunctions.net | Point the plugins at a different Firebase deployment. |
The generated Vibez ID and a debug log live in ~/.config/vibez/.
Privacy
Your Vibez ID is a shared secret: anyone who learns it can push notifications — and raise shields — on your phone. The four-word ID carries ~44 bits of entropy, enough to make guessing impractical, but rotate it with /vibez:setup regenerate if it ever appears in a screenshot, stream, log, or shared terminal.
The push pipeline runs on the project owner's Firebase project. The APNs auth key (.p8) lives in Firebase Cloud Messaging and never ships to clients.
See the full Privacy Policy for what data the iOS app handles and what stays on your device.
Repo Layout
Vibez/
├── Vibez/ iOS app (SwiftUI, Screen Time API)
├── VibezShield/ Shield Configuration Extension (custom shield UI)
├── VibezPushService/ Notification Service Extension (engages the shield pre-banner)
├── ClaudePlugin/ Claude Code plugin
├── CodexPlugin/ Codex plugin
├── CursorPlugin/ Cursor hooks plugin (npm: vibez-cursor)
├── Backend/ Firebase Cloud Functions (push fan-out + scheduling)
├── VibezExtension/ Chrome (MV3) browser companion
├── assets/ Logos, icons, lockups, glyphs, app mockups
├── docs/ Design notes and implementation plans
├── Vibez.xcodeproj/
└── CLAUDE.md Project context for agent sessions
Current Status
- Claude Code plugin: working.
- Codex plugin: working.
- Cursor plugin: working.
- iOS app: free on the App Store.
License
TBD.
Built by @Peter-Zhao-751. Original idea by @yiguozhang822.