oc1s/agent-notify

O que agent-notify faz?

Adds a desktop notification when the host coding agent finishes a turn. Idempotent — safe to re-run.

What gets installed

Scripts copied to ~/.agent-notify/:

• notify.sh — unified notifier (detects argv[1] vs stdin automatically)
• notify-turn-start.sh — used by hook-based agents to record turn start time
• notify-wrap.sh — generic CLI wrapper for agents without hooks
• opencode-plugin.ts — OpenCode TS plugin

Configs patched (only those whose home dir exists):

• ~/.codex/config.toml → notify = [".../notify.sh"]
• ~/.codex/hooks.json → PermissionRequest + UserPromptSubmit
• ~/.claude/settings.json → Stop + UserPromptSubmit + Notification hooks
• ~/.cursor/hooks.json → stop + beforeSubmitPrompt hooks
• ~/.qoder/settings.json → Stop + UserPromptSubmit + Notification hooks
• ~/.kimi/config.toml → [[hooks]] entries
• ~/.config/opencode/plugins/ → drops agent-notify.ts

See reference/agent-hooks.md for upstream docs and capability conclusions.

How to run

bash <skill-dir>/assets/install.sh

Flags: --target codex|claude|cursor|qoder|kimi|opencode, --uninstall

Optional: AGENT_NOTIFY_HOME=/path/to/home to force which profile receives configs (useful under WSL).

Agent execution steps

When invoked:

1. Resolve the absolute path to this skill's assets/install.sh (do not rely on cwd).

2. Run it with bash, forwarding user flags (--uninstall, --target, …):

   • macOS / Linux: bash <abs>/assets/install.sh
   • Windows (preferred): Git Bash
     "C:\Program Files\Git\bin\bash.exe" "<abs>\assets\install.sh"
   • Windows + WSL (fallback): single-quote the -c argument, point HOME at the Windows profile, run by path:

     wsl -e bash -lc 'export HOME=/mnt/c/Users/<you>; bash /mnt/c/Users/<you>/.agents/skills/agent-notify/assets/install.sh'
     

3. Hard rules (Windows agents):

   • Do not pipe the script into bash (sed … | bash, cat … | bash) — $0 breaks and assets are lost.
   • Do not put $(…) inside PowerShell double-quoted wsl … -c "…" strings — PowerShell expands them and can create junk files in the project cwd.
   • Prefer Git Bash over inventing a WSL+PowerShell quoting workaround.

4. Show installer stdout.

5. Remind the user to restart their agent session.