{"id":50551743,"url":"https://github.com/yuriteixeira/agent-notifier","last_synced_at":"2026-06-04T04:01:48.042Z","repository":{"id":356278170,"uuid":"1225547194","full_name":"yuriteixeira/agent-notifier","owner":"yuriteixeira","description":"Small local notifier for Claude Code, Codex CLI, and Gemini CLI hooks.","archived":false,"fork":false,"pushed_at":"2026-05-07T10:15:16.000Z","size":1683,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-07T12:09:24.063Z","etag":null,"topics":["ai","ai-agents","development-experience","dx","notifications"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yuriteixeira.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-30T11:47:08.000Z","updated_at":"2026-05-07T10:15:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yuriteixeira/agent-notifier","commit_stats":null,"previous_names":["yuriteixeira/agent-notifier"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/yuriteixeira/agent-notifier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriteixeira%2Fagent-notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriteixeira%2Fagent-notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriteixeira%2Fagent-notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriteixeira%2Fagent-notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuriteixeira","download_url":"https://codeload.github.com/yuriteixeira/agent-notifier/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriteixeira%2Fagent-notifier/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33888302,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","development-experience","dx","notifications"],"created_at":"2026-06-04T04:01:47.140Z","updated_at":"2026-06-04T04:01:48.034Z","avatar_url":"https://github.com/yuriteixeira.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agent-notifier\n\nSmall local notifier for Claude Code, Codex CLI, and Gemini CLI hooks.\n\nIt reads hook JSON from stdin and sends best-effort notifications when an agent\nfinishes a turn or needs user interaction. It supports local desktop\nnotifications, tmux messages, and optional ntfy publishing.\n\n![agent-notifier notification screenshot](docs/assets/notification-screenshot.png)\n\n## Install\n\n```sh\ngit clone https://github.com/yuriteixeira/agent-notifier.git\ncd agent-notifier\n./install.sh\n```\n\nDefault install paths:\n\n```text\n~/.local/bin/agent-notifier\n~/.local/lib/agent-notifier/\n```\n\nThe installer prints ready-to-paste hook snippets for Claude Code, Codex CLI,\nGemini CLI, and optional ntfy setup. It does not edit your config files.\n\nUse a symlink install while developing from a clone:\n\n```sh\n./install.sh --symlink\n```\n\nInstall somewhere else:\n\n```sh\n./install.sh --prefix /opt/agent-notifier\n./install.sh --bin-dir \"$HOME/bin\"\n```\n\nWith `--bin-dir`, support modules are installed in a sibling\n`lib/agent-notifier/` directory next to the chosen bin directory.\n\n## Uninstall\n\n```sh\n./uninstall.sh\n```\n\nThen remove any pasted hook snippets from Claude, Codex, Gemini, and ntfy config\nfiles.\n\n## More\n\n- [Configuration](docs/configuration.md)\n- [Development and troubleshooting](docs/development.md)\n\n## License\n\nGPLv3. See [LICENSE](LICENSE).\n\n## No Guarantees\n\nThis tool is provided as-is and is meant to be a small convenience layer around\nagent hooks. It makes a best-effort attempt to notify you, but it cannot\nguarantee delivery, timing, privacy, compatibility with every terminal or agent\nversion, or correct behavior in every local environment.\n\nUse it at your own risk. You are responsible for reviewing the hook snippets you\ninstall, the payloads your agents emit, the notification backends you enable,\nand any data that leaves your machine through services such as ntfy.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuriteixeira%2Fagent-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuriteixeira%2Fagent-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuriteixeira%2Fagent-notifier/lists"}