gitwtfhub

wtf is cx-notifier-marketplace?

gotolu/cx-notifier-marketplace — explained in plain English

Analysis updated 2026-05-18

24PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A notifier plugin for Codex and Claude Code that alerts you by chat app or desktop when a task finishes or needs approval.

Mindmap

mindmap
  root((CX Notifier))
    What it does
      Pings on task finish
      Pings on approval needed
      Works with Codex and Claude Code
    Tech stack
      Python
      Webhooks
      Desktop notifications
    Use cases
      Step away during long tasks
      Get phone alerts via Feishu
      Route by project or channel
    Audience
      Developers
      Agent power users
    Privacy
      No code sent
      No diffs sent
      Redacted question summary only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Get a desktop or phone notification when Codex or Claude Code finishes replying or needs approval.

REASON 2

Route notifications to Feishu, WeCom, DingTalk, or a custom HTTPS webhook.

REASON 3

Set up desktop notifications in seconds with no bot account or secret key required.

REASON 4

Configure a Feishu bot with signature verification for a more secure setup.

What's in the stack?

PythonCodexClaude CodeWebhooks

How it stacks up

gotolu/cx-notifier-marketplace0311119/free_registertool18597990650-lab/multi-agent-game
Stars242424
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Phone alerts require creating a Feishu, WeCom, or DingTalk bot and its webhook URL.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

CX Notifier is a plugin for Codex and Claude Code that pings you when a coding agent finishes a task or needs your approval, so you can hand off a task and step away instead of watching the terminal. Its playful Chinese name translates roughly to beast of burden caller. Once installed, it watches for approval requests or the end of a reply and sends a notification through Feishu, WeCom, DingTalk, a macOS or Linux desktop alert, or a generic HTTPS webhook. The plugin is built with privacy limits in mind. It never sends your code, diffs, terminal output, tool arguments, or the assistant's actual reply. A task completion notification only includes a short, redacted summary of your own question from that turn, capped at 160 characters. Notification channels also cannot be used to remotely approve anything, you always have to go back to the original coding session to continue. Setup is meant to be quick. A single command line script configures desktop notifications on macOS or Linux with no bot account or secret key needed, and triggers a test notification to confirm it works. For phone alerts, a separate setup script walks you through connecting a Feishu bot, including optional signature verification for extra security, and stores the resulting webhook and secret in a local config file readable only by your own user account. Both Codex and Claude Code share the same underlying hook, notification channel, and routing configuration, installed through each tool's own plugin marketplace command. Claude Code supports automatic plugin updates once enabled, or a manual update command for troubleshooting. The repository includes a release check script that scans for accidentally committed secrets, local config files, or real credentials before anything is published. Written in Python and licensed under MIT, this project is aimed at developers who run Codex or Claude Code for longer unattended tasks and want a reliable way to be notified without exposing their code or conversation content.

Yoink these prompts

Prompt 1
Help me install the cx-plugin marketplace and plugin for Claude Code and enable auto-update.
Prompt 2
Walk me through running setup_desktop.py to get zero-key desktop notifications on macOS.
Prompt 3
Help me configure a Feishu bot webhook and signature secret using setup_feishu.py.
Prompt 4
Explain what data this plugin does and does not send in a task completion notification.

Frequently asked questions

wtf is cx-notifier-marketplace?

A notifier plugin for Codex and Claude Code that alerts you by chat app or desktop when a task finishes or needs approval.

What language is cx-notifier-marketplace written in?

Mainly Python. The stack also includes Python, Codex, Claude Code.

What license does cx-notifier-marketplace use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is cx-notifier-marketplace to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is cx-notifier-marketplace for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.