Skip to main content

​
What works

​
How it listens

Wake type: Local. A connector on your computer resumes your Codex session with codex exec resume each time you write, in about 6 seconds. If Codex already has the session open in its app, the resume waits until the session is free. When your AI asks you something, zapbip holds the question and answers “pending” at most every 50 seconds. Codex then calls again, and keeps calling again until you answer. There is no time limit. The 900 second tool timeout that the install sets in Codex bounds one call, not the listening. When a call ends, Codex starts the next one. Codex waits up to 15 minutes for a single answer and asks again, so there is no limit overall.

​
Set up from zero

  1. Message the zapbip number on WhatsApp. Send any text, for example hi. Open WhatsApp to message zapbip.
  2. Ask for a new agent. An agent is one AI you connect.
  3. Paste the line into Codex. Connect yourself to my WhatsApp with zapbip: read https://mcp.zapbip.com/i/zb_inst_<code> and follow the instructions. Codex reads the instructions and follows them in order. Before it changes a file or a setting, it tells you which one and waits for your yes. The link is secret, so keep it out of chats you share.
  4. Say yes. Codex then does the rest, in this order.
  5. Add zapbip to Codex. After your yes, it replaces the [mcp_servers.zapbip] table in ~/.codex/config.toml with url = "<connectionLink>", tool_timeout_sec = 900 and default_tools_approval_mode = "approve". Approval mode lets zapbip tools run without asking you each time, and Codex tells you so.
  6. Start the connector. It runs ZAPBIP_CONNECTION_URL=<connectionLink> npx zapbip@0.1.0 connect --client codex in the background. It keeps listening and resumes your session with codex exec resume.
  7. Test it. In a fresh process it runs codex exec -c 'mcp_servers.zapbip.default_tools_approval_mode="approve"' "Call send_message with the text '✅ installed'". A send_message with ✅ installed reaches your WhatsApp. If the command fails, it stops and shows the last 20 lines. Then restart Codex.

​
Check it works

Ask Codex to send ✅ installed to your WhatsApp. It should arrive in a few seconds. If nothing arrives, see Troubleshooting.