NomaDamas

Warpalert — AI skill for Claude Code

AI community

Wmux — Warp alert: native toasts when your AI agent (Claude, Codex, OpenCode, Gemini) finishes a turn.

How to install Warpalert

This entry records only its repository, not the path inside it, so there is no exact command to give. Open NomaDamas/warpalert and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Warpalert does

Wmux — Warp alert: native toasts when your AI agent (Claude, Codex, OpenCode, Gemini) finishes a turn.

Alternatives in AI

WindsurfAPI — Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, A 3k ★
TokenTracker — Local-first AI token usage & cost tracker for 31 coding tools incl 1.4k ★
Syrtis — AI token usage & quota monitor for the macOS menu bar — native Swift, Liquid Glass, 3D contribution graph 368 ★

README

Wmux

Created by **[@HaD0Yun](https://github.com/HaD0Yun)** · Maintained under [NomaDamas](https://github.com/NomaDamas)

🔔 Warp alert — native toasts when your AI agent finishes a turn.

Works with **Claude Code**, **Codex CLI**, **OpenCode**, and **Gemini CLI**.

When the agent finishes a turn, asks for input, or goes idle, you get a real OS notification in Warp's top-right corner. No polling, no daemons — just the agent's own lifecycle hooks firing OSC sequences that Warp natively interprets.


✅	`project — claude done`
⚠️	`project — codex needs input`
💬	`project — gemini waiting`

TL;DR

# 1. Open Warp Terminal (notifications need a Warp-attached TTY)
# 2. Install
git clone https://github.com/NomaDamas/warpalert.git ~/.wmux && ~/.wmux/install.sh

# 3. Restart your agent sessions (existing sessions won't fire toasts)
# 4. Run an agent and finish a turn — toast appears in Warp's top-right

For unattended / AI-agent / CI use, pass `--yes`:

git clone https://github.com/NomaDamas/warpalert.git ~/.wmux && ~/.wmux/install.sh --yes

Prerequisites

Requirement	Why
Warp Terminal, running, and the install must happen inside a Warp tab	Wmux emits OSC 9 + OSC 777 sequences that only Warp interprets. The installer checks `WARP_CLI_AGENT_PROTOCOL_VERSION` and `WARP_CLIENT_VERSION`. If you install from a non-Warp terminal, the hooks still get wired but they will silently no-op.
`bash` ≥ 4	Used by installer and event hook.
`jq`	Required. Used by the installer for safe JSON config merging, and by the event hook to build the OSC 777 payload at runtime. `apt install jq` / `brew install jq` / `pacman -S jq`.
`tmux` ≥ 3.3 (only if you run agents inside tmux)	Installer auto-appends `set -g allow-passthrough on` to `~/.tmux.conf` and live-applies it to every running tmux server. Without passthrough, tmux silently drops the OSC sequences.
At least one s