OS notifications for AI coding agents. Get notified when OpenCode or Claude Code needs your input or completes a task.

• OpenCode
• Claude Code

• Linux
• Windows 11

curl -fsSL https://raw.githubusercontent.com/c4mbr0nn3/notificAItion/main/scripts/install.sh | bash

Security: The install scripts are auditable in this repo (scripts/install.sh, scripts/install.ps1). Review them before piping to your shell, or download and inspect first:

curl -fsSL https://raw.githubusercontent.com/c4mbr0nn3/notificAItion/main/scripts/install.sh -o install.sh
less install.sh
./install.sh

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/c4mbr0nn3/notificAItion/main/scripts/install.ps1" | Invoke-Expression

cargo install --git https://github.com/c4mbr0nn3/notificAItion

Then manually copy the plugin files:

cp plugins/opencode/notificaiton.js ~/.config/opencode/plugins/notificaiton/
# Merge plugins/claude-code/settings.json into ~/.claude/settings.json

Once installed, notifications fire automatically:

• Input needed — when the agent pauses waiting for your input
• Task completed — when the agent finishes its work

No configuration needed. The install script wires everything up.

1. Agent hook system detects lifecycle events
2. Hook calls notificaiton notify --agent <name> --event <type>
3. Binary sends OS notification via native APIs
4. Binary exits immediately

Releases are triggered from the GitHub Actions UI. No local tooling required.

1. Go to the Actions tab → Release workflow → Run workflow.
2. Select a bump level: patch, minor, or major.
3. Click Run workflow.

The workflow bumps Cargo.toml, commits and tags it on main as github-actions[bot], builds Linux and Windows x86_64 binaries in parallel, creates a GitHub Release with auto-generated notes, attaches both binaries, and publishes it immediately.

# Or trigger from the CLI
gh workflow run release.yml -f bump=patch

MIT