Ai Notify

[!IMPORTANT] This repository has been merged into [agent-toolkit](https://github.com/PaulRBerg/agent-toolkit) (subdirectory `notify/`) and is archived. All development continues there.

ai-notify

Desktop notification system for Claude Code and Codex CLI. It tracks Claude Code session activity and sends macOS notifications for key events.


Installation

[!NOTE]

This CLI works only on macOS at the moment.

Prerequisites

• Rust nightly (including rustfmt and Clippy)
• terminal-notifier app: Install with brew install terminal-notifier
• (optional) it2 CLI with iTerm2's Python API enabled (iTerm2 > Settings > General > Magic > Enable Python API): lets clicking a notification focus the exact iTerm2 session that produced it, instead of only activating the app

Installation

The CLI is installed from source:

git clone https://github.com/PaulRBerg/ai-notify.git
cd ai-notify
rustup toolchain install nightly --component rustfmt --component clippy
cargo install --path . --locked --force --root "$HOME/.local"

To update, `git pull` and re-run the `cargo install` command. Installation targets `~/.local/bin`; configure integrations separately with `ai-notify link claude` or `ai-notify link codex`.

Development

Use the locked dependency graph for local commands:

cargo build --locked
just check
cargo run --locked -- --help

`just check` runs Rust formatting, Clippy with warnings denied, tests, and pinned Prettier checks for Markdown and JSON.

Features

• Smart Notifications: Filters Claude Code completion alerts by a configurable duration threshold (default: 10s)
• Prompt Filtering: Exclude specific prompt patterns (e.g., slash commands like /commit) from notifications
• Session Tracking: SQLite database tracks Claude Code prompts, durations, and job numbers
• Auto-cleanup