Codex notificationDesktop and editor alerts for Codex in Antigravity / VS Code, scoped to the current workspace. Install and configure
Accurate event handlingOrdinary Codex turn endings do not produce completion notifications. Subagents, CLI sessions, and sessions outside the current workspace are ignored. Interrupted work, pending questions, new user input, and continued turns cancel candidate completion alerts. Structured synchronous question prompts are tracked until their matching answer. Async prompts must first be accepted; a subsequent user message clears them. A short settling window suppresses questions already answered or canceled before delivery. Explicit waiting-for-input signals also support ordinary prose questions. Task completion requires Codex to explicitly declare that the entire task is complete, relevant checks have passed, and no required work, approval, clarification, deployment or external verification remains pending. It is a declaration by the agent, not independent verification of success. Without workspace task signals, completion alerts stay silent. Enable them only in workspaces where you want this behavior. The workspace instructions use hidden Markdown comments on their own line:
These are recognized only in the final task-complete record and outside code fences. Question signals take precedence over completion signals. A plain task_complete record with no signal is ignored. Settings
Notifications appear even while the editor is focused by default ( Privacy and compatibilityThe extension reads local sessions/**/rollout-*.jsonl incrementally. It retains only local file offsets, bounded partial-record buffers, boolean eligibility, pending-question metadata, and hashed deduplication keys. Notifications use fixed generic text; no prompts, responses, account details, paths, or session IDs are exposed. It does not read auth files, send network requests, approve actions, or transmit telemetry. Claude hooks are installed only through the explicit workspace setup command. The rollout schema is not a stable public API; detection must be rechecked after Codex changes. Questions that provide neither a supported structured prompt nor the explicit waiting-for-input signal are not detected. Already issued OS alerts cannot be retracted if a question is answered later. Native helpers are distributed through node-notifier with network fallbacks disabled. The macOS helper is a universal build from unmodified terminal-notifier 3.1.0 source; provenance and licenses are in vendor/. Desktop delivery depends on OS permissions and Focus/Do Not Disturb. Windows/Linux delivery needs separate platform testing. DevelopmentRun MIT. Independent project; not affiliated with or endorsed by OpenAI. Claude Code alerts included in this extensionVersion 0.3.0 combines Codex and Claude notifications under the existing codex-attention extension ID. A separate Claude notification extension is not required. Run Codex notification: Enable Claude Hooks in This Workspace, then start a new Claude Code session. Node.js must be on its PATH. Test with Test Claude Response Notification and Test Claude Input Notification. Claude response alerts mean the main agent finished responding and its response is ready for review; they do not certify task completion. Permission, idle and elicitation notifications mean attention is needed. Timing follows Claude Code hooks. User interrupts, subagent stops and Stop events with active background work are ignored. Both providers share the existing desktop/editor delivery, sound, backgroundOnly and pause controls. The notification mode applies to both. Claude-specific settings are codexAttention.claude.enabled, codexAttention.claude.notifyOnReady and codexAttention.claude.notifyOnInput. Existing Codex settings and command IDs are retained. Setup merges marked Stop and Notification hooks into .claude/settings.local.json, preserves unrelated settings and your status line, and backs up existing settings. It replaces the earlier standalone Claude notification bridge handlers, preventing duplicate delivery from those handlers. Disable or uninstall the development claude-attention extension if previously installed. Organization policies may disable hooks; this extension does not override them. The hook processes stdin locally and stores only event kind, timestamp and a hashed workspace routing scope in local extension storage. It never retains raw hook input, messages, tool arguments, session IDs or credentials. The IDE must remain open on the same accessible machine. To disconnect, remove only handlers marked Claude notification bridge from your local Claude settings. Official hook reference: https://code.claude.com/docs/en/hooks |