Codex
Get notified when Codex needs input.
The open-source Smoke Signal plugin sends a push notification when Codex reaches an approval prompt, waits for an answer, or finishes a long task. Notifications use context from the active task to explain why Codex is waiting.
Approvals, blocked tasks, and completed runs
Receive updates for approval prompts, questions Codex is holding on, and completed long-running work.
Quiet at the keyboard
A grace period cancels a pending alert if you respond first. Presence detection suppresses notifications while you are active on the computer.
Notifications with task context
The bundled notify tool lets Codex name the task it is waiting on instead of sending a generic session status.
Setup
Install the plugin and pair a Channel.
Install the open-source plugin from its public marketplace, then pair it with a Channel.
- 01
Install the plugin
Run these commands in your terminal.
- 02
Trust the hooks
Restart the Codex app or start a new CLI task, open /hooks, and trust the Smoke Signal hooks. Codex skips untrusted hooks until you do.
- 03
Create a Channel
Create a Channel for Codex in Publisher settings. Open it, choose Connect, then Get a pairing code.
- 04
Connect it to your account
Ask Codex to pair Smoke Signal with the NXXXX-XXXXX code. The code works once, expires in minutes, and exchanges for a key stored on this computer.
- 05
Step away
Notifications stay suppressed while you are active at the keyboard. Tell Codex you are going afk to send them immediately until you say you are back.
Wording
Notifications explain what Codex is waiting for.
The notification names the blocked task rather than repeating the whole question. Its wording comes from Codex through the bundled notify tool, from the question itself, or from a fixed fallback.
Channel Decisions do not return answers to Codex yet, so plugin notifications tell you when to return to the session. Remote is separate and can start or steer paired Codex tasks from the app.
Good to know
Requirements and limits.
- The plugin source is MIT-licensed: github.com/smoke-signal-app/agent-plugin.
- Needs Node.js 18 or newer. Plugins run in the Codex app and CLI, not the IDE extension.
- Set the origin to your own server if it implements the documented endpoint shapes.
- Free for individuals. No card required.
- Rate limits apply.
Start receiving