convez.ai
AgenteProdutividadeIntermediário
Peter-Zhao-751

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 GitHub
InicialPluginScore · de 0 a 100

Vibez 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/Vibez

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 eventVibez pluginiOS app
First session after installGenerates 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 promptSends a needs-input push with shield:on.Records the trigger, shows the message, and applies the Screen Time shield.
Agent stops after a responseSends a done push with a short assistant excerpt and shield:on.Keeps selected apps blocked for the configured window.
You submit the next promptSends 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

PathStatusPurpose
ClaudePlugin/WorkingClaude Code plugin for SessionStart, Notification, PreToolUse, PostToolUse, Stop, and UserPromptSubmit hooks.
CodexPlugin/WorkingCodex plugin for SessionStart, PermissionRequest, PreToolUse, PostToolUse, Stop, and UserPromptSubmit hooks.
CursorPlugin/WorkingCursor agent hooks (sessionStart, beforeSubmitPrompt, afterAgentResponse, stop, sessionEnd), installed via npx vibez-cursor.
Vibez/On the App StoreSwiftUI iOS app that receives FCM pushes, records recent triggers, and applies Family Controls / Managed Settings shields.
Backend/WorkingFirebase Cloud Functions (registerPushToken, notify, dispatchUnblock) that pair devices and fan out pushes via FCM.
VibezExtension/Local buildChrome (MV3) extension that mirrors the block on desktop browsers.
assets/Working assetsLogo, 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:

  1. Enter your 4-word Vibez ID.
  2. Grant notification permission.
  3. Grant Screen Time / Family Controls permission.
  4. Pick the apps, categories, or websites to shield.
  5. 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:

VariableDefaultPurpose
VIBEZ_IDfrom ~/.config/vibez/vibez-idForce a specific Vibez ID — e.g. to drive several machines from one ID without copying the file.
VIBEZ_BACKEND_URLhttps://us-central1-vibez-backend.cloudfunctions.netPoint 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.

Ver o original no GitHub

Bom para

Relacionados