npm - @xwss/agentbell - Versions diffs - 0.1.1 → 0.1.2 - Mend

@xwss/agentbell 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,8 +1,16 @@
 # Changelog
+## 0.1.1
+Patch release:
+- Switched release checks and package metadata tests to accept semver patch versions.
+- Fixed Claude verify bash resolver test isolation.
+- Fixed global install verify path handling so project directories are not expected to contain `dist/cli.js`.
 ## 0.1.0
-Initial MVP:
+Initial MVP:
 - npm package name: `@xwss/agentbell`; installed CLI command: `agentbell`

package/README.md CHANGED Viewed

@@ -1,971 +1,334 @@
 # AgentBell
-AgentBell: get notified when your AI coding agent finishes.
+AgentBell notifies your phone when AI coding agents finish a task.
-AgentBell 闁哄嫷鍨粩瀛樼▔椤忓洦纭舵鐐插暱瑜?CLI 鐎规悶鍎遍崣鍧楁晬瀹€鈧弫銈嗙鎼粹剝韬?Claude Code闁靛棔绔紀dex闁靛棔绠揝 Code Copilot Agent 缂?AI coding agent 閻庣懓鏈崹姘鐠囨彃顫ら柕鍡曠娴犵姴顫㈤姀锝囩閻炴稑琚埀顑胯兌閻℃垵顕ラ崨鎵炕闁稿繈鍎查崹銊╂閳ь剛鎲版担瑙勭秬闂傚嫭鍔栧鍌炴晬瀹€鍐ㄦ闁告柣鍔岄幃婊堝箥鐎ｎ偅绨氶柛娆愬灴閳ь兛鐒﹁ぐ渚€鏌嬮幒瀣у亾?
-缂佹鍏涚粩鎾偋閸粎鍠橀柛蹇撶墛閺侇噣骞?ntfy闁靛棗鍊歌ぐ鍌炴焻娴ｄ警浼傞柛娆樹邯濞撳墎鎲版担钘夊幋閻犱礁娼″Λ鑸靛緞閺嶎偆绉规鐐舵硾瑜板倿宕?HTTP 閻犲洭鏀遍惇浼存晬瀹€鍕ㄥ亾閸屾碍鍊ら柡鍫墮濠€鎾偨娴ｅ啫澹嬮柕鍡曟祰缁绘瑧绮?SSH闁靛棔绠楽L闁靛棔绗峞v Container闁靛棔娴囩换娆撳箳瑜忛弫鎼佹嚇閹寸姷鎼奸柛锔惧劋濞呮瑩濡?
-## Why Not Bluetooth
+It is a small CLI for developers who run long AI coding tasks and want a reliable phone notification when the agent stops, asks for attention, or finishes a workflow. It currently uses ntfy for Android push notifications and installs hook wrappers for Codex, Claude Code, and VS Code Copilot Agent.
-AgentBell 濞戞挸绉存禒娑㈡嫅濠靛牆顫╅柣鈺冾棎缁绘盯骞嶇€ｎ剙绠氶柕鍡楀€介幗鎴︽偋濞嗘垶绾弶鈺冨仱濞撳墎鎲版担鍓叉П闁荤偛妫濋崢銈団偓闈涚畭閳ь兛鑳堕柈瀵哥磼閻斿憡缍€闂傚嫭鍔戦埀顑跨瀹稿爼宕崱妤€绀傞悹渚囧枔閳ь兛绀侀幃妤呭矗妫颁胶绠芥繛鑼额嚙閹锋壆鎹勯妸銉╂尙闁告瑦婢樺Ο濠傤嚕閸岋妇绀夐柛娆樺灦濞碱剟骞€瑜嶇欢銏ゆ⒕閸欍儳绠介悹鍥﹂檷閳?
-闁规亽鍔忓畷姗€鏌ч幑鎰唴闁哄嫷鍨界槐?
-1. AI coding hook 闁革负鍔岄悿鍕⒔閸涙壆绠ラ悶?agent 闁汇劌瀚┃鈧柛锝冨妺缁楀倿骞嶈椤㈡垿濡?2. AgentBell 闂侇偅淇虹换?HTTP 闁硅泛锕埀顒佹皑閻擄繝宕ｉ幋婵嗙厒 ntfy闁?3. 閻庣懓顦畷婊堝箥鐎ｎ偅绨氶柡鈧捄鍝勭厒 ntfy 闂侇偅姘ㄩ悡锟犲Υ?4. 缂侇垵宕电划娲椽鐏炴儳顤侀柣?App 閻犳劗鍠曢惌妤呭箮婵犲洠鍋撳杈╁弨閺夌儐鍓欒ぐ鍌炲礆閻楀牆顤侀柣婊庡灛閳?
-閺夆晜鐟﹂悧杈ㄦ交濠婂應鏌ら柡鍫濇惈濞呮帡宕ｉ鍥舵矗闁告瑯鍨禍鎺旀媼閸ф锛?ntfy server闁挎稑鑻銊╂嚄閼恒儱绲归梺杈ㄥ笂缂嶆﹢鎯冮崟顒€顤侀柡鍫熶航閳?
-## Android Setup
+Core features:
-1. 閻庣懓顦抽ˉ?ntfy Android闁?2. 閻犱降鍨藉Σ鍕▔閳ь剚绋夐鍫燁吂闁哄牊浜介埀顑挎缁楀宕ｉ婊冾嚥闁?topic闁?3. 闁稿繋娴囬?ntfy 闁汇劌瀚伴埀顒佹皑閻擄繝寮堕崘顔筋€欓柕?4. 闁稿繑濞婂Λ?ntfy 闁汇劌瀚弫绋啃ч悩杈╁枠闁告牗鐗犲娲礆闊祴鍋?5. 闁革负鍔嶆晶婊堟偝?App 濞戞搩鍘奸崢鎴犳媼濮濆本绁柛?ntfy 闁汇劌瀚伴埀顒佹皑閻擄繝濡?
-濠碘€冲€归悘澶嬫媴鐠恒劍鏆?`https://ntfy.sh` 闁稿浚鍓欓崣锟犲嫉瀹ュ懎顫ら柨娑樼焷椤曨剟骞?topic 鐟滅増鎸风紞?bearer secret闁靛棗鍊婚悡锟犳焼?topic 闁汇劌瀚Ч澶愭焻濮橆剛鍩楅悘蹇氱簿閸忔﹢宕ラ幋锝庡殙 topic 闁告瑦鍨剁粔鐑藉箒椤栨稑鐏楅悹浣靛灲濡插嫬鈽夐崼鐔剁礀闁挎稑鏈晶宥嗙閵夈倗鐟濋悷鏇氭婵炲洭鎮介妸銉剑闁告艾绉查埀顑跨窔閵嗗秹鎯勯鍏煎€抽柕鍡曠窔閸嬫牜绮绘笟搴撳亾娴ｇ褰嗛柛娆戭焾閹洘娼诲▎鎴ｎ潶闁告瑯鍨崇€?topic闁?
-## Installation
+- Phone notifications for AI coding workflows
+- ntfy Android support
+- `agentbell setup` first-run wizard
+- `agentbell verify` installation and hook diagnostics
+- Codex VS Code extension Stop hook
+- Claude Code Stop and Notification hooks
+- VS Code Copilot Agent Stop hook
+- Rich notification context: machine name, project name, task name, path, branch, and time
-Install AgentBell from npm:
+## Installation
 ```bash
 npm install -g @xwss/agentbell
-agentbell setup
 ```
-Although the npm package is scoped as `@xwss/agentbell`, the installed CLI command is still `agentbell`.
-For beta builds:
-```bash
-npm install -g @xwss/agentbell@beta
-```
-AgentBell requires Node.js 20 or newer.
-## Development Install
-For local development:
+Although the npm package is scoped as `@xwss/agentbell`, the installed CLI command is still:
 ```bash
-git clone <your-agentbell-repo-url>
-cd AgentBell
-npm install
-npm run build
-node dist/cli.js setup
+agentbell
 ```
-## Local Package Test
+AgentBell requires Node.js 20 or newer.
-Before publishing, test the npm package locally:
+For beta builds:
 ```bash
-npm run build
-npm pack
-npm install -g ./xwss-agentbell-0.1.0.tgz
-agentbell --help
-agentbell setup --dry-run --yes --targets none --no-test
+npm install -g @xwss/agentbell@beta
 ```
-## Uninstall
-```bash
-npm uninstall -g @xwss/agentbell
-```
 ## Quick Start
-```bash
-npm install -g @xwss/agentbell
-agentbell setup
-```
-闁哄牜鍓欏﹢鏉戭嚕閳ь剟宕ｉ幋锝囩閻炴稑鐭夌槐?
-```bash
-npm install
-npm run build
-npm test
-npm run dev -- test
-```
-## Setup Wizard
-`agentbell setup` is the recommended first command on a new machine. It is a guided setup flow that:
-- generates a random ntfy topic
-- writes `~/.agentbell/config.json`
-- asks for a machine display name
-- guides Android ntfy subscription
-- sends a setup test notification
-- installs selected AI coding hooks
-Examples:
+Run the setup wizard:
 ```bash
 agentbell setup
-agentbell setup --yes --targets none --no-test
-agentbell setup --targets codex,claude-code
-agentbell setup --dry-run
-```
-Useful options:
-- `--config <path>` writes a specific config file.
-- `--topic <topic>` uses a specific ntfy topic.
-- `--machine-name <name>` sets the display name used in notifications.
-- `--server <url>` sets the ntfy server.
-- `--targets <targets>` accepts `all`, `none`, or comma-separated `codex,claude-code,vscode-agent`.
-- `--yes` uses defaults for prompts.
-- `--no-test` skips the phone test notification.
-- `--dry-run` previews setup without writing files, sending notifications, or installing hooks.
-## Topic and Machine Name
-The ntfy topic is a secret transport address, not a display name. Anyone who knows the topic can usually publish to it, so use a long random topic and do not commit it to a public repository.
-The machine display name is safe human context for notifications, for example `瀹搞儰缍旂粩?閸欑﹫, `MacBook Pro`, or `GPU-Server-01`.
-A good default model is one user-owned random topic shared across your machines, with each machine using a different display name. Example notification:
-```text
-瀹搞儰缍旂粩?閸?璺?Codex task finished
-```
-## Manual Setup
-Advanced users can still use the lower-level commands directly:
-```bash
-agentbell init
-agentbell test
-agentbell init-hooks --target codex
-agentbell init-hooks --target claude-code
-agentbell init-hooks --target vscode-agent
-```
-Use manual setup when you want to provide your own topic, skip the guided Android flow, or install hooks one tool at a time.
-## Commands
-### `agentbell send`
-闁活潿鍔嬬花顒傛偖?hook 閻犲鍟伴弫銈夋晬鐏炶棄绲洪梺顐℃缁旀潙鈻庨敓鐘亾濮樿京鍙€闁?
-```bash
-agentbell send --tool codex --event stop --title "Codex 閻庣懓鏈崹姘? --message "閺夆晜绮庨埢濂稿嫉閸濆嫭鐝ゅ☉鎾筹功濞?Codex 鐎规瓕灏欑划銊╁级閻斿憡鎷遍弶鐑嗗枙閹广垽宕?
 ```
-閻㈩垰鎽滈弫銈夊矗閸屾稒娈堕柨?
-- `--tool`: `claude-code`闁靛棔姊梒odex`闁靛棔姊梫scode-agent`闁靛棔姊梒ustom`
-- `--event`: `stop`闁靛棔姊梟otification`闁靛棔姊梕rror`闁靛棔姊梡ermission`闁靛棔姊梒ustom`
-- `--title`: 闂侇偅姘ㄩ悡锟犲冀閸ヮ剦鏆柨娑樿嫰瑜版煡鏌?- `--message`: 闂侇偅姘ㄩ悡锟犲礃閸涱収鍟囬柨娑樿嫰瑜版煡鏌?- `--priority`: ntfy priority闁挎稑鑻ぐ鏌ユ焻?- `--tags`: ntfy tags闁挎稑鐭傞埀顒侇殔瑜板潡宕氶崱娑欘吘闁挎稑鑻ぐ鏌ユ焻?- `--config`: 闁圭娲ら悾楣冩煀瀹ュ洨鏋傞柡鍌氭矗濞嗐垻鎹勯姘辩獮闁挎稑鑻ぐ鏌ユ焻?
-濠碘€冲€归悘澶嬬▔瀹ュ嫮鐐?`title` 闁?`message`闁挎稑鐡慻entBell 濞村吋淇洪崵婊堝礉閵娧勬櫢闁瑰瓨鍔欑划顖滄媼閵堝懎鏁堕悗鍦缁辨繈鐛懜鐢靛闁硅鍣ｉ崢銈囩磾椤旂厧鐦堕柛?`tool`闁靛棔姊梕vent`闁靛棔姊梙ostname`闁靛棔姊梒wd`闁靛棔姊梩imestamp`闁?
-### `agentbell test`
+The wizard will:
-闁告瑦鍨块埀顑跨劍缁佸鎷犻弴鈶╁亾濮樿京鍙€闁?
-```bash
-agentbell test
-```
+- Generate a random ntfy topic
+- Write `~/.agentbell/config.json`
+- Guide Android ntfy subscription
+- Send a test notification
+- Install AI coding hooks
-闁哄秴娲。浠嬫晬濮濇gentBell 婵炴潙顑堥惁鐥?
-闁告劕鎳庨鎰版晬濮濇碍淇婇崒娑氫函濞达絿濮峰﹢鍛村礆妫颁胶鍟婇弶鈺傜懄濞碱垶鏌呭杈╁弨闁挎稑鐭侀鈺呭及?AgentBell 鐎规瓕灏欑划锟犳煀瀹ュ洨鏋傞柟瀛樺姇婵盯濡存穱?
-### `agentbell verify`
+## Android ntfy Setup
-Checks whether AgentBell is still installed correctly: config, provider settings, hook files, wrapper files, recent wrapper logs, stale paths, and optional manual notification / wrapper execution.
+During `agentbell setup`, AgentBell generates a long random ntfy topic. Subscribe to that topic on your Android phone:
-Common uses:
+1. Install ntfy Android.
+2. Open ntfy and subscribe to the generated topic.
+3. Allow notification permission.
+4. Allow background running if your phone prompts for it.
+5. Disable battery optimization for ntfy if notifications are delayed.
-- A task finished but no phone notification arrived.
-- You moved the project directory.
-- You renamed or moved the project and suspect stale old-project paths.
-- You deleted or regenerated wrapper files.
-- You reinstalled Node.js.
-- You updated Codex, Claude Code, or VS Code.
-- Hooks were trusted but still do not send notifications.
+The topic is a secret transport address. Do not publish it, commit it, or share it in logs.
-Examples:
+## Tool Compatibility Matrix
-```bash
-agentbell verify
-agentbell verify --target codex
-agentbell verify --target vscode-agent --run-wrapper
-agentbell verify --send-test
-agentbell verify --json > agentbell-verify.json
-```
-Options:
-- `--target <target>` checks `codex`, `claude-code`, `vscode-agent`, or `all`.
-- `--send-test` sends an `AgentBell verify test` phone notification.
-- `--run-wrapper` manually runs the selected wrapper command to verify it can call AgentBell.
-- `--dry-run` only inspects files and config; it does not send notifications or run wrappers.
-- `--json` prints a structured report with masked topic values.
-Log parsing note:
-`verify` evaluates the latest hook run block, not every historical line in the log. Old failures are ignored once a newer successful wrapper run is recorded.
-Global install path note:
+| Tool | Surface | Hook type | Config location | Wrapper location | Status | Notes |
+|---|---|---|---|---|---|---|
+| Codex | VS Code extension | Stop | `~/.codex/hooks.json` | `~/.agentbell/hooks/codex-stop.cmd` | Verified on Windows | User-level hook, usually works across projects |
+| Claude Code | CLI / VS Code terminal mode | Stop / Notification | `~/.claude/settings.json` | `<project>/.agentbell-hooks/*.sh` | Stop verified, Notification prepared | Windows requires Git Bash for `.sh` wrapper |
+| VS Code Copilot Agent | VS Code Agent mode | Stop | `<project>/.github/hooks/agentbell.json` | `<project>/.agentbell-hooks/copilot-stop.cmd` | Verified on Windows | Project-level hook; VS Code Agent hooks are Preview |
-After `npm install -g @xwss/agentbell`, AgentBell can be run from any project directory. The current working directory is used as the project context for `.agentbell.json`, `.agentbell-hooks`, logs, `--cwd`, project name, and git branch detection. The AgentBell CLI path is the globally installed package path, for example `C:\Program Files\nodejs\node_modules\@xwss\agentbell\dist\cli.js`. `verify` should not require the project directory itself to contain `dist/cli.js`.
+## Important Differences Between Tools
-涓枃璇存槑锛歚verify` 鍙牴鎹渶杩戜竴娆?hook/wrapper 杩愯鍒ゆ柇褰撳墠鐘舵€併€傚巻鍙叉棩蹇楅噷鐨勬棫椤圭洰璺緞 / `MODULE_NOT_FOUND` 涓嶄細鍦ㄦ渶鏂拌繍琛屾垚鍔熷悗缁х画瀵艰嚧 `error`銆?If verify reports stale old-project paths, a missing `dist/cli.js`, or a wrapper that incorrectly points to `<project>/dist/cli.js` after global install, update AgentBell and refresh hooks with:
+Codex:
-```bash
-agentbell init-hooks --target all
-```
-### `agentbell doctor`
+- Uses a user-level hook.
+- After setup, it usually works across projects.
+- You do not usually need to run `init-hooks` in every project.
+- To refresh the wrapper, run:
-閺夊牊鎸搁崵顓㈡偝椤栨凹鏆旈悹鍥э攻閺屽洦绌遍埄鍐х礀闁挎稑鐭傞埀顒€鍊搁幃搴㈠緞瀹ュ懎鐓戠紓浣圭懃閸╁棙绂嶉悜妯虹瑩闁哄被鍎荤槐?
 ```bash
-agentbell doctor
+agentbell init-hooks --target codex
 ```
-闁告牕鎳庨幆鍫ユ煀瀹ュ洨鏋傞柛娆樺灥椤曚即骞€瑜嬮埀顑垮灑rovider闁靛棔鑻焧fy server闁靛棔杈渙pic 闁哄嫷鍨伴幆浣衡偓娑櫭﹢顏堝Υ娴ｆ悂鎸柛娆掑焽閳ь兛寮搊stname闁靛棔鑿噑ername闁靛棔鎭瓀d闁靛棔鑵恛de 闁绘鐗婂﹢浼村Υ娑撳搩I 閻犲鍟伴弫銈囨崉椤栨氨绐為柛婊冩湰鐢綊鎳?hook 闁告稒鍨濋幎銈夊Υ?
-### `agentbell init`
-濞存嚎鍊撶花鏉款嚕韫囨洘鏅搁柟瀛樺姍閸樸倗绱旈鍡欑獥
+Claude Code:
-```bash
-agentbell init
-```
+- Uses `~/.claude/settings.json`.
+- On Windows, AgentBell uses Git Bash to run project-local `.sh` wrappers.
+- If `agentbell verify --run-wrapper` cannot find bash, set:
-濮掓稒顭堥濠氬礃濞嗗繐寮抽柨?
-```text
-~/.agentbell/config.json
+```cmd
+set AGENTBELL_BASH_PATH=C:\Path\To\bash.exe
 ```
-闂佹澘绉堕悿鍡欑矆鏉炴壆浼愰柨?
-```json
-{
-  "provider": "ntfy",
-  "ntfy": {
-    "server": "https://ntfy.sh",
-    "topic": "your-long-random-topic",
-    "priority": "high",
-    "tags": ["computer"]
-  },
-  "localNotification": {
-    "enabled": true
-  },
-  "includeContext": {
-    "hostname": true,
-    "cwd": true,
-    "timestamp": true
-  }
-}
-```
+VS Code Copilot Agent:
-闁?macOS/Linux 濞戞挸顭槐婵嬫煀瀹ュ洨鏋傞柡鍌氭矗濞嗐垺瀵煎顒佹櫦闂佹彃绻楅鏇犵磾椤旀槒绀?`600` 闁哄鍟村娲Υ娣囧”ndows 濞戞挸锕ｇ槐鎵崉鐎圭姷绠?POSIX 闁哄鍟村铏规媼閸撗呮瀭闁?
-### `agentbell init-hooks`
+- Uses a project-level hook file.
+- Each project needs `<project>/.github/hooks/agentbell.json`.
+- Run this inside each project where you want Copilot Agent notifications:
-闁汇垻鍠愰崹?hook 闂佹澘绉堕悿鍡椢熼埄鍐╃凡闁?
 ```bash
-agentbell init-hooks --target claude-code
-agentbell init-hooks --target codex
 agentbell init-hooks --target vscode-agent
-agentbell init-hooks --target all
 ```
-AgentBell 濞戞挸绉崇槐鎵垝濡や焦鐦归悷鏇炴濞插﹤顔忛崣澶嬬畳闂佹澘绉堕悿鍡涘Υ閸屾艾鍤掗柡?JSON 闁哄倸娲ｅ▎銏″濮橆剙甯ュ璺烘矗閸炪倖绋?`.bak-闁哄啫鐖煎Λ鍧楀箣閻垽鏁嶅畝鈧崝褔宕ユ惔鈩冩櫦闂佹彃绻愭禒?JSON merge闁靛棗鍊搁々褔寮稿鍐ㄥ殥闁哄牆顦伴弸鍐╃閺堢數鐟濋柡鍕靛灠閹骸鈻?JSON闁挎稑濂旂槐浼存偨閻旂鐏?snippet 闁哄倸娲ｅ▎銏ょ嵁閼搁潧绲圭紒鈧潪鐗堢溄鐎规悶鍎遍幃搴ㄧ嵁闊祴鍋?
-Preview hook changes without writing files:
-```bash
-agentbell init-hooks --target codex --dry-run
-agentbell init-hooks --target all --dry-run
-```
-Dry-run prints the target config paths, whether existing config was detected, what a real run would merge, and the hook snippet that would be generated. It does not write files and does not create backups.
-## Claude Code Example
-闁烩晩鍠楅悥锝夊棘閸ワ附顐介柨?
-```text
-~/.claude/settings.json
-```
-闁烩晩鍠楅悥锝夊极閸喓浜柨?
-```json
-{
-  "hooks": {
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "agentbell send --tool claude-code --event stop"
-          }
-        ]
-      }
-    ],
-    "Notification": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "agentbell send --tool claude-code --event notification"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
+## Rich Notification Context
-## Codex Example
+AgentBell can generate notifications such as:
-闁烩晩鍠楅悥锝夊棘閸ワ附顐介柨?
 ```text
-~/.codex/hooks.json
-```
-闁烩晩鍠楅悥锝夊极閸喓浜柨?
-```json
-{
-  "hooks": {
-    "stop": [
-      {
-        "command": "agentbell send --tool codex --event stop"
-      }
-    ]
-  }
-}
-```
+Workstation-01 · Codex audit task finished
-AgentBell 閺夆晜眉缁变即鎮介悢绋跨亣闁?
-```text
-~/.agentbell/snippets/codex-hooks.json
+Project: AgentBell
+Path: G:\learning\AgentBell
+Branch: main
+Event: stop
+Time: 2026-05-23 22:45
 ```
-Codex hook 闂佹澘绉堕悿鍡涘冀閻撳海纭€闁告瑯鍨甸崗姗€姊捐箛鏇烆暭闁哄牜鍓欒ぐ澶愬礌閺嶃儮鍋撻崒婵嗩仧濞达絿濮峰▓?Codex 闁绘鐗婂﹢鐗堟媴鐠恒劍鏆忓☉鎾崇Т閹?schema闁挎稑鐭侀顒勫箮?snippet 濞戞搩鍘惧▓鎴﹀川閹存帗濮㈤弶鈺€鑳朵簺闁告帗濯介姘舵偋閸喐鎷遍悷鏇氱劍閻即鎯冮崟顏嗙Т缂傚喚鍠撻埀?
-### Codex Windows Wrapper
-On Windows, AgentBell writes a `.cmd` wrapper and points Codex to that wrapper instead of embedding a long `node.exe ... cli.js ...` command directly in `hooks.json`.
+Project name priority:
-Target files:
+1. CLI `--project`
+2. `.agentbell.json` `projectName`
+3. `package.json` `name`
+4. Current folder name
-```text
-~/.codex/hooks.json
-~/.agentbell/hooks/codex-stop.cmd
-~/.agentbell/snippets/codex-hooks.json
-```
+If you are happy with the folder name, you do not need `.agentbell.json`.
-Verified Windows hook shape:
+To customize project context:
-```json
-{
-  "hooks": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "commandWindows": "cmd /d /s /c \"C:\\Users\\<user>\\.agentbell\\hooks\\codex-stop.cmd\"",
-            "command": "cmd /d /s /c \"C:\\Users\\<user>\\.agentbell\\hooks\\codex-stop.cmd\"",
-            "timeout": 30,
-            "statusMessage": "Sending AgentBell notification"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-The wrapper logs to:
-```text
-~/.agentbell/codex-hook-fired.log
+```bash
+agentbell project init --name MyProject --task "AI coding task"
 ```
-If the log contains `Notification sent.` but your phone does not receive anything, troubleshoot ntfy, Android notification permissions, and battery optimization. If the log file does not exist, Codex did not execute the hook or the hook was not trusted.
-## VS Code Agent Example
-闁烩晩鍠楅悥锝夊棘閸ワ附顐介柡鍕靛灠娴兼劖鎷呭鍐ㄩ殬缂佺嫏鍥у赋缂傚喚鍣槐?
-```text
-.github/hooks/agentbell.json
-```
+Example `.agentbell.json`:
-闁烩晩鍠楅悥锝夊极閸喓浜柨?
 ```json
 {
-  "name": "agentbell",
-  "description": "Notify Android via AgentBell when VS Code Agent / Copilot Agent stops.",
-  "hooks": {
-    "stop": [
-      {
-        "command": "agentbell send --tool vscode-agent --event stop"
-      }
-    ]
-  }
+  "projectName": "MyProject",
+  "defaultTaskName": "AI coding task"
 }
 ```
-闁告鍘栨繛鍥亹閹惧啿顤呴柣鈺婂枛缂嶅秵绋夊鍡樞?git 濡炪倕婀卞ú浼存晬鐎涘’entBell 濞戞梻鍠庨崢鎴犳媼閸濄儲鏅搁柟瀛樺姌缁绘牗绋?workspace hook 闁哄倸娲ｅ▎銏ゆ晬鐏炲€熷珯濞村吋纰嶈ぐ浣虹矆鏉炴壆绋戠痪顓у枦椤撹崵鈧湱鍋ゅ顖氼啅閵夈儱寰旈柡鍕靛灠閹胶鎷犵拠鎻掔悼閻庣懓鍟ㄩ埀?
-## Real Hook Verification
-Hook schemas can change across AI coding tools. AgentBell keeps the templates small and visible so you can verify them with the tool version you actually run.
-### Codex
-Preview the Codex hook first:
-```bash
-agentbell init-hooks --target codex --dry-run
-```
-Then write the hook:
-```bash
-agentbell init-hooks --target codex
-```
-Run a minimal Codex task, for example asking it to inspect a tiny file or answer a short codebase question. When the task stops, you should receive an ntfy notification from `agentbell send --tool codex --event stop`.
-If no notification arrives, run:
-```bash
-agentbell doctor
-agentbell doctor --json
-agentbell test
-```
-Check that the config path exists, the ntfy server is reachable, and the command shown in the dry-run output is valid in the same shell/environment where Codex runs.
-### Claude Code
-Preview or write Claude Code hooks:
-```bash
-agentbell init-hooks --target claude-code --dry-run
-agentbell init-hooks --target claude-code
-```
-To verify the Stop hook, run a small Claude Code task and let it finish normally. You should receive a notification for `--tool claude-code --event stop`.
-To verify the Notification hook, trigger a Claude Code state that asks for user attention, such as waiting for input or a permission-related notification. You should receive a notification for `--tool claude-code --event notification`.
-Use the event name to distinguish states:
-- `stop`: the agent finished the current task or turn.
-- `notification`: the agent is asking for attention, often because it is waiting for input or needs user action.
-If the Stop hook works but Notification does not, inspect the installed Claude Code version and its hook documentation. The event name or schema may have changed.
-## Claude Code Verification
-AgentBell prepares Claude Code hooks with this shape:
-```text
-hooks.Stop[].hooks[]
-hooks.Notification[].hooks[]
-```
-Each handler uses `type: "command"` and calls `agentbell send`. On Windows, Claude Code runs hook commands through Git Bash / shell, so AgentBell writes project-local `.sh` wrappers instead of `.cmd` wrappers:
-```text
-<projectRoot>\.agentbell-hooks\claude-stop.sh
-<projectRoot>\.agentbell-hooks\claude-notification.sh
-```
-Both wrappers log to:
-```text
-<projectRoot>\.agentbell-hooks\claude-hook-fired.log
-```
-The generated Claude Code commands look like:
-```bash
-bash G:/learning/AgentBell/.agentbell-hooks/claude-stop.sh
-bash G:/learning/AgentBell/.agentbell-hooks/claude-notification.sh
-```
-Wrapper timestamps use an ASCII-safe UTC format, `date -u +"%Y-%m-%dT%H:%M:%SZ"`, to avoid mojibake on Windows systems with non-English locale output.
-Preview the files:
-```bash
-agentbell init-hooks --target claude-code --dry-run
-```
-Write the hooks:
-```bash
-agentbell init-hooks --target claude-code
-```
-After changing Claude Code hooks, trust or allow the hook if Claude Code prompts you. To verify `Stop`, run a tiny Claude Code task and let it finish. To verify `Notification`, trigger a state where Claude Code waits for user attention, such as input or permission. If no phone notification arrives, check `<projectRoot>\.agentbell-hooks\claude-hook-fired.log` first. If the log file does not exist, Claude Code did not execute or trust the hook. If the log contains `Notification sent.`, troubleshoot ntfy and Android notification delivery.
-### VS Code Agent / Copilot Agent
-VS Code Agent / Copilot Agent support is treated as a workspace hook. AgentBell writes:
-```text
-.github/hooks/agentbell.json
-```
-Preview or write it from the workspace root:
-```bash
-agentbell init-hooks --target vscode-agent --dry-run
-agentbell init-hooks --target vscode-agent
-```
-This capability may vary by VS Code and Copilot Agent version. After writing the file, reload VS Code, run a small workspace agent task, and confirm whether the hook command is executed. If it is not triggered, manually compare `.github/hooks/agentbell.json` with the hook format expected by your VS Code version, then move the command into the supported location.
-Use `agentbell doctor` inside the same workspace terminal to confirm the CLI path, Node version, current working directory, and config file location.
-## Verified: Codex VS Code Extension on Windows
-The VS Code Codex extension has been manually verified on Windows with AgentBell:
-- `UserPromptSubmit` and `Stop` hooks can be triggered by the extension.
-- `Stop` hook successfully calls AgentBell through the generated `.cmd` wrapper.
-- The full path works: Codex Stop hook -> `.cmd` wrapper -> AgentBell -> ntfy -> Android phone notification.
-- The successful wrapper log is written to `~/.agentbell/codex-hook-fired.log`.
-After changing hooks, Codex may require you to trust the updated hook again. If you use WSL, configure AgentBell separately inside WSL because Windows, WSL, Remote SSH, and Dev Containers have different home directories, Node paths, and hook execution environments.
-## Local Desktop Notifications
-闂傚嫨鍊撶花?ntfy 闁归潧顑嗗┃鈧柟鎭掑姂閳ь兛绶ょ槐婊眊entBell 闁告瑯鍨禍鎺旀偘閵夈儱甯犻柡鍫墮濠€鏉戭浖瀹€鍕〃闂侇偅姘ㄩ悡锟犳晬?
-- macOS: `osascript display notification`
-- Linux: 濞村吋锚閸?`notify-send`闁挎稑濂旂粭澶屸偓娑櫭﹢顏堝礆濞嗘帞鍎查弶?- Windows: MVP 闂傚啳鍩栭宀€鎹勭€圭姷绠栭柛娆樺灦濞碱剟骞€瑜岀粭澶屾惥瀹曞洦鐣遍柡鍫墮濠€?toast闁挎稑鑻懟鐔虹磼濞嗗繐姣夐柟缁樺姉閵?
-闁哄牜鍓欏﹢鎾焻濮樿京鍙€濠㈡儼绮剧憴锔界▔瀹ュ嫮绐楃憸鏉垮船閹?ntfy 闁归潧顑嗗┃鈧柟鎭掑姂閳ь兛闄嶉埀?
-## Remote SSH / WSL / Dev Container
-Hook 閹煎瓨妫侀姘跺捶閵娿儳鏉介梻鍕嚀缁诲秶鎮?AI coding agent 闁汇劌瀚┃鈧柛锝冨妺缁楀倿骞嶈椤㈡垿濡撮崒娑氭Х濠碘€冲亰缁?
-- Remote SSH: hook 闁革负鍔忕换娆戠矙?Linux 濞戞挾绮┃鈧柟绗涘棭鏀介柕?- WSL: hook 闁?WSL 闁绘粠鍨伴。銊╁箥瑜戦、鎴﹀Υ?- Dev Container: hook 闁?container 闁告劕鎳忔晶鐣屾偘鐏炵儵鍋?- 閺夆晜绮嶇敮鍫曟偨娴ｅ啫澹? hook 闁革负鍔忛～锔芥交濠婂嫬浠橀柣顫祷閸撴娊骞嶈椤㈡垿濡?
-闁搞儳濮甸婵囨媴閻樼粯浠橀悷鏇氱濠€顏堟焽閿濆嫰鍤嬮柣婊庡灠椤ｃ劑鏌岀仦鐣屾殧閻?Node.js 20+闁靛棔绀侀悾銊ф啑?AgentBell闁靛棔娴囩换宥囨偘?`agentbell init`闁挎稑鑻懟鐔烘兜椤旇崵绠介悹鍥ュ劤楠炲棙鏅堕崘顓炲幋閻犱礁娼″Λ?ntfy server闁?
-## Troubleshooting
-### 闁归潧顑嗗┃鈧柡鈧張鐢电憹闁告帊鍗抽埀顒佹皑閻?
-闁稿繐鐗愮换宥囨偘瀹€瀣獥
+## Commands
 ```bash
-agentbell doctor
+agentbell setup
 agentbell test
-```
-婵☆偀鍋撻柡灞诲劜婢ф粓寮甸悜妯恍﹂柛姘剧畳椤撳綊姊奸崨顒傚晩闁告艾濂旂粩瀛樼▔?topic闁靛棔鑻焧fy 闁哄嫷鍨伴幆渚€寮垫径鎰ㄥ亾濮樿京鍙€闁哄鍟村娲Υ娴ｈ笑闁告熬绠戦崣褔姊婚婵堝晩闁汇垹鐏氶惈婊勫濡搫顕ч柕鍡曡緶opic 闁哄嫷鍨伴幆浣烘惥閸愬樊妾梻鍛箲濠р偓濞戞挻姊归惀鍛村嫉婢跺海缈婚梺鎸庣懀閳?
-### 閺夆晜绮庨埢濂稿嫉閸濆嫭鐝ら柡鍐У绾墎鎷嬮崸妤侊紪 ntfy.sh
-閺夆晜鍔橀、?`agentbell doctor` 闁哄被鍎冲﹢?`ntfy server access`闁靛棗鍊搁々褔寮稿鍐ㄥ絾闁告瑥鎽滅紞澶岀磼濠婂嫬鐏楅柡鍫濈Т婵喖宕抽妸褏绉圭紓浣圭矒濡炬椽宕氶幆閭﹀晱闂?`ntfy.sh`闁挎稑鑻ぐ鍙夌閵夈劌娈扮€?ntfy server闁挎稑鐬奸崝褔宕ユ惔鈩冭含 `~/.agentbell/config.json` 濞戞搩鍘洪幈銊╁绩?`ntfy.server`闁?
-### hook 婵炲眲銇版洟宕?
-缁绢収鍠涢?hook 闂佹澘绉堕悿鍡涘棘閸ワ附顐介柛锔哄妼椤曨喗鎯旈弬澶哥矗闁稿繐鍢查悿鍕⒔閸涢偊鍤㈤柛娆愮墱濞堟垶鎷呭鍥╂瀭闁靛棗鍊烽幈銊╁绩?hook 闁告艾鍑界槐婵嬫煂瀹ュ懏鍎欓柟?reload 閻庣數鎳撶花?AI coding 鐎规悶鍎遍崣鍧楀Υ閸屾艾甯ラ柣顫妺缁斿瓨绋夐鍕彂閻忓繐绻掑▓?agent 濞寸姾顕ф慨鐔割殽瀹€鍐 stop hook闁?
-濠碘€冲€归悘?Windows 濞?Codex hook 婵炲备鍓濆﹢浣烘喆閿曗偓瑜板倿鏌呭杈╁弨闁挎稑鐭侀顒€螞閳ь剟寮?`~/.agentbell/codex-hook-fired.log`闁?
-### Windows 閻犱警鍨扮欢鐐烘⒒椤曗偓椤?
-濠碘€冲€归悘澶愬礂閵娿儳婀?`agentbell` 闁告稒鍨濋幎銈夊捶?hook 闁绘粠鍨伴。銊╂煂鐏炶偐鐟濋柛娆樺灥椤棝鏁嶇仦钘夎濞寸姰鍎版繛鍥偨?`agentbell doctor` 閺夊牊鎸搁崵顓㈡儍?`cli invocation for hooks`闁靛棗鍊稿﹢顏堝嫉椤掆偓濠€鏉戭嚕閳ь剟宕ｉ幋鐐搭槯闁挎稑鑻悾鐘诲矗椤栨繂鍘撮柡?`node path/to/dist/cli.js`闁?
-### WSL / Remote SSH 濞?hook 閻庡湱鍋ゅ顖涙交閹邦垼鏀藉ù锝呯Ф閻ゅ棝姊婚鈧。?
-閻犲洤鍢插﹢?agent 閻庡湱鍋ゅ顖涙交閹邦垼鏀介柣婊庡灠椤ｃ劑鏌岀仦鎯р挃閻?`agentbell doctor`闁靛棔绻卛ndows 濞戞挾绮┃鈧柕鍡曠畼SL闁靛棔娴囩换娆戠矙鐎ｂ晛鐦滈柡鍫熶航閳ь兛绗峞v Container 闁哄嫷鍨粭澶愬触瀹€鈧獮鍡樻櫠閸愯法绀夐柛姘閸ゆ粓寮垫径澶岀憹闁告艾鐬煎▓?home闁靛棔璧婣TH闁靛棔鑵恛de 闁告粌鐭傞崢銈囩磾椤旇姤鐎ù鐘虹堪閳?
-### Cannot find module old project dist cli.js
-If a wrapper log contains an error like:
-```text
-Cannot find module '...\old-project\dist\cli.js'
-MODULE_NOT_FOUND
-```
-then the hook and wrapper did execute, but the active wrapper still points to an old project path. This can happen after renaming or moving the project directory.
-Fix:
-```bash
+agentbell send --tool codex --event stop --task "audit task"
+agentbell project init --name MyProject --task "AI coding task"
 agentbell init-hooks --target all
-agentbell verify --dry-run
+agentbell verify
+agentbell doctor
 ```
-### setup test failed
-If `agentbell setup` sends a test notification but the phone does not receive it:
-- Check that the topic in ntfy Android exactly matches the AgentBell topic.
-- Check the ntfy server URL.
-- Open the ntfy app once to refresh the subscription.
-- Allow notification permission.
-- Allow background running / disable battery optimization.
-- Run `agentbell doctor` and inspect warnings.
-If you skipped hook installation during setup, rerun `agentbell setup` or use `agentbell init-hooks --target all` after phone delivery works.
-It is safe to rerun setup. Existing hook files are backed up by the hook installer before merge/write where supported.
-### Cannot convert argument to a ByteString
-This can happen when a Node.js `fetch` header contains Chinese text, emoji, or other non-ASCII characters. ntfy supports UTF-8 header values through RFC 2047 encoded-word syntax, so AgentBell automatically encodes ntfy headers such as `Title` and `Tags`.
-The notification body is not header data and remains a normal UTF-8 message.
-If you still see this error, upgrade AgentBell and rebuild it. As a temporary workaround, use an English-only `--title` and ASCII-only `--tags`.
-## Development
+Useful examples:
 ```bash
-npm install
-npm run build
-npm test
-npm run dev -- test
+agentbell setup --yes --targets none --no-test
+agentbell setup --dry-run
+agentbell init-hooks --target all --dry-run
+agentbell send --tool claude-code --event stop --project MyProject --task "README update"
 ```
-婵炴潙顑堥惁顖涘?mock `fetch`闁挎稑濂旂粭澶嬪濮樿鲸鍩傞柣銊ュ閹?`ntfy.sh` 闁告瑦鍨奸顒€效閸屾ǚ鍋撻崒姘锭闁哄牆顦遍弫銈夊箣闁垮鈻旂€殿喖绻楃换宥囨偘?`agentbell test` 闁?`agentbell send` 闁哄啳鍩栨晶鐘冲濮橆剙绲洪梺顐¤兌濠€锛勨偓鍦仱閳ь剚姘ㄩ悡锟犲Υ?
-## Compatibility / Verified Matrix
-| Tool | Surface | OS | Hook event | Wrapper strategy | Status | Log path |
-|---|---|---|---|---|---|---|
-| Codex | VS Code extension | Windows | Stop | user `.cmd` wrapper | Verified | `~/.agentbell/codex-hook-fired.log` |
-| Claude Code | CLI / VS Code terminal mode | Windows | Stop | project `.sh` wrapper | Verified | `<projectRoot>/.agentbell-hooks/claude-hook-fired.log` |
-| Claude Code | CLI / VS Code terminal mode | Windows | Notification | project `.sh` wrapper | Prepared / Partially verified | `<projectRoot>/.agentbell-hooks/claude-hook-fired.log` |
-| VS Code Copilot Agent | VS Code Agent mode | Windows | Stop | project `.cmd` wrapper | Verified | `<projectRoot>/.agentbell-hooks/copilot-hook-fired.log` |
-| Remote SSH / WSL / Dev Container | Various | Various | TBD | TBD | Not verified | TBD |
-Verified means the full chain reached Android notification on the author's Windows machine. Claude Code Notification is prepared but should not be treated as fully verified until a real Notification event is tested. VS Code Agent hooks are still a Preview capability, so re-verify after VS Code or Copilot updates.
-## Verified: Codex VS Code Extension on Windows
-Verified path:
-```text
-Codex Stop hook -> ~/.agentbell/hooks/codex-stop.cmd -> AgentBell -> ntfy -> Android
-```
+## Verification
-Install or refresh the hook:
+Use `verify` when a hook is not firing, a notification does not arrive, Node was reinstalled, or a project was moved.
 ```bash
-node dist\cli.js init-hooks --target codex
-```
-Then restart or reload VS Code / Codex, trust the hook if prompted, run a small Codex task, and inspect:
-```text
-~/.agentbell/codex-hook-fired.log
+agentbell verify --dry-run
+agentbell verify --run-wrapper --send-test
+agentbell verify --target codex
+agentbell verify --target claude-code --run-wrapper
+agentbell verify --target vscode-agent --run-wrapper
+agentbell verify --json > agentbell-verify.json
 ```
-Log interpretation:
+Notes:
-- `Notification sent.` plus exit code `0`: AgentBell successfully sent the ntfy request.
-- No log file: Codex did not execute the hook or the hook was not trusted.
-- Log exists but phone did not receive notification: troubleshoot ntfy, Android background permissions, and notification permissions.
+- `--dry-run` inspects files and logs but does not run wrappers or send notifications.
+- Warnings are normal in dry-run mode because wrapper execution is intentionally skipped.
+- `--send-test` sends a phone notification through the configured provider.
+- `--run-wrapper` manually runs the generated wrapper and then re-reads the latest hook log.
+- Topics are masked in verify output.
-Why `.cmd` wrapper on Windows:
+Log parsing behavior:
-- Directly embedding a complex `"node.exe" "cli.js" send ...` command in `~/.codex/hooks.json` is fragile on Windows because quoting, spaces, and path escaping can vary by host.
-- The generated `.cmd` wrapper gives Codex a short stable command and gives AgentBell a log file for troubleshooting.
-- Codex uses the `hooks.Stop[].hooks[]` schema and the Windows-specific `commandWindows` field.
-- After changing hooks, Codex may ask you to trust the updated hook again.
-## Verified: Claude Code on Windows
+`verify` evaluates the latest hook run block, not every historical line in the log. Old failures are ignored once a newer successful wrapper run is recorded.
-Claude Code CLI must be available:
+Global install path behavior:
-```bash
-claude --version
-```
+After `npm install -g @xwss/agentbell`, AgentBell can be run from any project directory. The current working directory is the project context for `.agentbell.json`, `.agentbell-hooks`, logs, `--cwd`, project name, and git branch detection. The AgentBell CLI path is the globally installed package path. `verify` should not require the project directory to contain `dist/cli.js`.
-Hooks should be visible with:
+If verify reports that a wrapper incorrectly points to `<project>/dist/cli.js` after global install, update AgentBell and refresh hooks:
 ```bash
-claude /hooks
+agentbell init-hooks --target all
 ```
-If `/hooks` cannot find `claude`, the Claude Code CLI is not installed or `PATH` is not configured in the terminal environment.
-Claude Code on Windows executes hook commands through Git Bash / shell. AgentBell therefore generates project-local `.sh` wrappers, not user-home `.cmd` wrappers.
-Verified path:
+## Troubleshooting
-```text
-Claude Code Stop hook -> <projectRoot>/.agentbell-hooks/claude-stop.sh -> AgentBell -> ntfy -> Android
-```
+### `agentbell` command not found
-How to verify:
+- Make sure the package is installed:
 ```bash
-node dist\cli.js init-hooks --target claude-code
-claude /hooks
+npm install -g @xwss/agentbell@beta
 ```
-Confirm `Stop` and `Notification` are present, trust or allow hooks if prompted, then run a tiny Claude Code prompt:
+- Make sure the npm global bin directory is in `PATH`.
+- On Windows, a common npm global bin path is `%APPDATA%\npm`.
+- PowerShell may block the `.ps1` shim. Try CMD or:
-```text
-鐠囧嘲娲栨径宥勭閸?hello閿涘奔绗夌憰浣锋叏閺€瑙勬瀮娴犺翰鈧?```
-Inspect:
-```text
-<projectRoot>/.agentbell-hooks/claude-hook-fired.log
+```cmd
+cmd /d /s /c agentbell --help
 ```
-Old logs may contain mojibake from locale-specific Windows date output. The current wrapper uses ISO-style UTC timestamps such as `2026-05-23T13:28:27Z`; after clearing old logs, new entries should be ASCII-safe.
-The Claude Code Notification hook is prepared / partially verified. Do not treat it as fully verified until you have triggered and confirmed a real Notification event on your machine.
+### Windows local desktop notification skipped
-### Claude verify run-wrapper on Windows
+This is expected in the MVP. Phone push still works.
-`agentbell verify --target claude-code --run-wrapper` runs the Claude `.sh` wrapper with a resolved Git Bash executable. On Windows it uses this order:
+### Claude Code verify requires bash
-1. `AGENTBELL_BASH_PATH`, if set and the file exists.
-2. `bash` found on `PATH`.
-3. Common Git for Windows paths such as `C:\Program Files\Git\bin\bash.exe`.
+On Windows, set the Git Bash path if auto-detection fails:
-Example:
-```bat
-set AGENTBELL_BASH_PATH=D:\software\git\bin\bash.exe
+```cmd
+set AGENTBELL_BASH_PATH=C:\Program Files\Git\bin\bash.exe
 agentbell verify --target claude-code --run-wrapper
 ```
-The verify report prints the resolved bash path:
-```text
-[Claude Code]
-  bash: D:\software\git\bin\bash.exe
-```
-If manual bash execution succeeds but verify fails, run:
-```bash
-agentbell verify --target claude-code --run-wrapper --json
-```
-Compare `bashPath`, `runWrapper`, and the latest log block status. A successful latest Claude block should include `Notification sent.` and `AgentBell exit code 0`.
-## Verified: VS Code Copilot Agent on Windows
+### Hook not firing
-VS Code Agent hooks are still Preview, but the Windows Stop path below has been verified with Copilot Agent mode.
+Try:
-Verified path:
+1. Restart VS Code or the target AI tool.
+2. Trust hooks if prompted.
+3. Run `agentbell verify`.
+4. Check logs:
 ```text
-VS Code Copilot Agent Stop hook -> <projectRoot>/.agentbell-hooks/copilot-stop.cmd -> AgentBell -> ntfy -> Android
+Codex: ~/.agentbell/codex-hook-fired.log
+Claude Code: <project>/.agentbell-hooks/claude-hook-fired.log
+Copilot Agent: <project>/.agentbell-hooks/copilot-hook-fired.log
 ```
-Generated files:
+### ntfy notification delay
-- Hook file: `.github/hooks/agentbell.json`
-- Wrapper: `<projectRoot>/.agentbell-hooks/copilot-stop.cmd`
-- Log: `<projectRoot>/.agentbell-hooks/copilot-hook-fired.log`
+On Android:
-How to verify:
-```bash
-node dist\cli.js init-hooks --target vscode-agent
-```
-Reload VS Code, use Copilot Chat in Agent mode to run a small task, then inspect the log file above and confirm the phone notification. The generated Windows hook command uses:
-```text
-cmd /d /s /c "<projectRoot>\.agentbell-hooks\copilot-stop.cmd"
-```
-Do not use single quotes around the wrapper path. If Windows says the wrapper path is not recognized as an internal/external command, executable program, or batch file, the hook probably used single quotes or did not pass the wrapper path through `cmd /d /s /c` with double quotes.
-For hook-level debugging, open `View -> Output -> GitHub Copilot Chat Hooks`.
-## Android ntfy Reliability Notes
-If notifications arrive only after opening the ntfy app, the usual cause is Android background restriction rather than AgentBell.
-Recommended Android settings:
-- Allow notifications.
-- Allow lock-screen notifications.
+- Allow notification permission.
 - Allow background running.
 - Disable battery optimization for ntfy.
-- Allow auto-start.
-- Allow background network access.
-- In the watch/band companion app, allow forwarding ntfy notifications.
-The F-Droid build of ntfy may rely more heavily on a background connection. If the phone has Google services, the Play Store build may be more reliable for push delivery.
-Treat the ntfy topic as a secret. Do not use an easy-to-guess topic and never commit it to a public repository. Use a long random topic such as `your-long-random-topic`; when showing diagnostics publicly, mask it like `agen...q4z1`.
-## Known Windows Notes
-- Windows local desktop notification is intentionally skipped in this MVP. ntfy phone push is unaffected.
-- Codex has been verified with a user-home `.cmd` wrapper.
-- Claude Code has been verified with a project-local `.sh` wrapper.
-- VS Code Copilot Agent has been verified with a project-local `.cmd` wrapper.
-- Windows non-ASCII usernames, Git Bash path conversion, `cmd` quoting, and hook host behavior can all affect execution, so do not casually change wrapper strategy between tools.
-- Git dubious ownership does not affect AgentBell notifications, but it can block `git status`, `git diff`, or commits. Users should decide whether to configure `safe.directory`.
-- WSL, Remote SSH, Dev Containers, and Windows host shells have different home directories, Node paths, environment variables, and network behavior. Configure and verify AgentBell in the environment where the agent hook actually runs.
-## Next: Verify and Rich Context
-Now that `agentbell setup` exists, the next product step is a dedicated `agentbell verify` command for repeatable end-to-end checks after setup.
-Planned improvements:
-1. Verify config readability.
-2. Verify ntfy delivery.
-3. Verify installed hook files and wrapper paths.
-4. Print tool-specific next steps for Codex, Claude Code, and VS Code Copilot Agent.
-5. Expand notification templates with project and task context.
-Example topic values in docs should stay generic, such as `your-long-random-topic` or `agen...q4z1`.
-## Future: Rich Notification Context
-Future AgentBell notifications can include richer context so the phone notification tells you which machine and task finished.
-Possible fields:
-- machine display name
-- hostname
-- tool
-- event
-- project name
-- cwd
-- git branch
-- task name
-- timestamp
-Example:
+- Confirm the phone subscribed to the same topic generated by setup.
-```text
-瀹搞儰缍旂粩?閸?璺?Codex 鐎孤ゎ吀娴犺濮熺紒鎾存将
-妞ゅ湱娲伴敍娆癵entBell
-鐠侯垰绶為敍娆?\learning\AgentBell
-閸掑棙鏁敍姝產in
-```
-## Rich Notification Context
-AgentBell now builds richer default notification content when `--title` or `--message` is not provided. The default context can include:
+## Manual Configuration
-- machine display name
-- hostname
-- tool display name
-- raw tool id
-- event and event label
-- task name
-- project name
-- cwd
-- git branch
-- local timestamp
-- ISO timestamp
-Example notification:
-```text
-瀹搞儰缍旂粩?閸?璺?Codex 鐎孤ゎ吀娴犺濮熺紒鎾存将
-妞ゅ湱娲伴敍娆癵entBell
-鐠侯垰绶為敍娆?\learning\AgentBell
-閸掑棙鏁敍姝產in
-娴滃娆㈤敍姝磘op
-閺冨爼妫块敍?026-05-23 22:45
-```
-Useful `send` options:
+`agentbell setup` is recommended. Advanced users can use lower-level commands:
 ```bash
-agentbell send --tool codex --event stop --task "鐎孤ゎ吀娴犺濮?
-agentbell send --tool claude-code --event stop --project AgentBell --task "README 閺囧瓨鏌?
-agentbell send --tool vscode-agent --event stop --cwd G:\learning\AgentBell --branch main
+agentbell init
+agentbell test
+agentbell init-hooks --target codex
+agentbell init-hooks --target claude-code
+agentbell init-hooks --target vscode-agent
 ```
-Explicit `--title` and `--message` still win. Use them when a hook wrapper needs an exact fixed message.
-## Machine Display Name
-The ntfy topic is a secret transport address, not a human-readable machine name. Do not use your topic as a display name and do not commit it to a public repository.
-Use `profile.name` in `~/.agentbell/config.json` for friendly notification context:
+Example config:
 ```json
 {
+  "provider": "ntfy",
+  "ntfy": {
+    "server": "https://ntfy.sh",
+    "topic": "your-long-random-topic",
+    "priority": "high",
+    "tags": ["computer"]
+  },
   "profile": {
-    "name": "瀹搞儰缍旂粩?閸?
+    "name": "Workstation-01"
+  },
+  "localNotification": {
+    "enabled": false
+  },
+  "includeContext": {
+    "hostname": true,
+    "cwd": true,
+    "timestamp": true
   }
 }
 ```
-A practical setup is one long random topic per user, shared across your own machines, with a different `profile.name` on each machine.
-### Hooks use rich context by default
-Generated Stop wrappers now let `agentbell send` build the notification from rich context. They do not hard-code simple `--title` / `--message` values by default.
-To customize hook notifications, create `.agentbell.json` in the project:
+## Development
-```json
-{
-  "projectName": "AgentBell",
-  "defaultTaskName": "鐎孤ゎ吀娴犺濮?
-}
+```bash
+npm install
+npm run build
+npm test
+npm run lint
+node dist/cli.js --help
 ```
-Then regenerate hooks:
+Useful local checks:
 ```bash
-agentbell init-hooks --target all
+npm run check:package
+npm pack --dry-run
 ```
-Project-local wrappers such as Claude Code and VS Code Copilot Agent pass `--cwd <projectRoot>` so AgentBell can read `.agentbell.json`, `package.json`, and git branch context. Codex uses a user-level wrapper and normally relies on the hook runtime cwd.
-Example hook notification:
-```text
-瀹搞儰缍旂粩?閸?璺?Codex 鐎孤ゎ吀娴犺濮熺紒鎾存将
-妞ゅ湱娲伴敍娆癵entBell
-鐠侯垰绶為敍娆?\learning\AgentBell
-閸掑棙鏁敍姝產in
-娴滃娆㈤敍姝磘op
-閺冨爼妫块敍?026-05-23 22:45
-```
-## Project Config
+## Release
-AgentBell can also read optional project-level config from `.agentbell.json` in the current working directory.
-```json
-{
-  "projectName": "AgentBell",
-  "defaultTaskName": "鐎孤ゎ吀娴犺濮?
-}
-```
-Create it with:
+- Package name: `@xwss/agentbell`
+- CLI command: `agentbell`
+- Publish command:
 ```bash
-agentbell project init --name AgentBell --task "鐎孤ゎ吀娴犺濮?
+npm publish --access public --tag beta
 ```
-If `.agentbell.json` already exists, `agentbell project init` will not overwrite it unless you pass `--force`. With `--force`, AgentBell writes a `.bak-<timestamp>` backup first.
-Project name priority:
-1. `agentbell send --project <name>`
-2. `.agentbell.json` `projectName`
-3. `package.json` `name`
-4. current directory name
-Task name priority:
-1. `agentbell send --task <name>`
-2. `.agentbell.json` `defaultTaskName`
-3. `娴犺濮焋
-Project-level notification templates can override global templates:
+Do not publish unless these pass:
-```json
-{
-  "projectName": "AgentBell",
-  "defaultTaskName": "鐎孤ゎ吀娴犺濮?,
-  "notification": {
-    "titleTemplate": "{{machine}} 璺?{{tool}} {{task}}{{eventLabelSuffix}}",
-    "messageTemplate": "妞ゅ湱娲伴敍姝縶project}}\n鐠侯垰绶為敍姝縶cwd}}\n閸掑棙鏁敍姝縶branch}}\n娴滃娆㈤敍姝縶event}}\n閺冨爼妫块敍姝縶timestamp}}"
-  }
-}
+```bash
+npm run build
+npm test
+npm run lint
+npm run check:package
+npm pack --dry-run
 ```
-Supported template variables include `machine`, `hostname`, `tool`, `toolRaw`, `event`, `eventLabel`, `task`, `project`, `cwd`, `branch`, `timestamp`, `isoTimestamp`, and `duration`.
-## Setup Project Context
-`agentbell setup` remains safe by default and does not create `.agentbell.json` in `--yes` mode unless requested.
+Before publishing, confirm no real topic, token, log, backup, local hook wrapper, `.env`, or local config file is included.
-To create project context during setup:
-```bash
-agentbell setup --init-project --project-name AgentBell
-```
+## License
-In interactive setup, AgentBell can ask whether to create `.agentbell.json` for the current project. Choosing no leaves the project untouched.
+MIT

package/RELEASE.md CHANGED Viewed

@@ -13,7 +13,7 @@ The npm package is scoped as `@xwss/agentbell`, while the installed CLI command
 7. `npm pack`
 8. Install the tarball locally:
    ```bash
-   npm install -g ./xwss-agentbell-0.1.0.tgz
+   npm install -g ./xwss-agentbell-0.1.1.tgz
    ```
 9. Smoke test:
    ```bash

package/dist/cli.js CHANGED Viewed

@@ -9,11 +9,12 @@ import { runSetup } from './commands/setup.js';
 import { runTest } from './commands/test.js';
 import { runVerify } from './commands/verify.js';
 import { logger } from './utils/logger.js';
+import { getPackageVersion } from './utils/version.js';
 const program = new Command();
 program
     .name('agentbell')
     .description('AgentBell: get notified when your AI coding agent finishes.')
-    .version('0.1.0');
+    .version(getPackageVersion());
 program
     .command('send')
     .description('Send one notification. Intended for AI coding agent hooks.')

package/dist/cli.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAmB,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;~~AAE3C~~,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,OAAO,CAAC,~~OAAO~~,CAAC,CAAC;~~AAEpB~~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"}
1	+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/utils/version.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export declare function getPackageVersion(fromUrl?: string): string;

package/dist/utils/version.js ADDED Viewed

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const unknownVersion = '0.0.0-unknown';
+function readVersion(packageJsonPath) {
+    try {
+        const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        return typeof pkg.version === 'string' && pkg.version.trim() ? pkg.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getPackageVersion(fromUrl = import.meta.url) {
+    const currentFile = fileURLToPath(fromUrl);
+    let directory = path.dirname(currentFile);
+    for (let depth = 0; depth < 5; depth += 1) {
+        const version = readVersion(path.join(directory, 'package.json'));
+        if (version) {
+            return version;
+        }
+        const parent = path.dirname(directory);
+        if (parent === directory) {
+            break;
+        }
+        directory = parent;
+    }
+    return unknownVersion;
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,SAAS,WAAW,CAAC,eAAuB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAA0B,CAAC;QACvF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IACzD,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM;QACR,CAAC;QACD,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@xwss/agentbell",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Get notified on your phone when AI coding agents finish.",
   "type": "module",
   "bin": {
@@ -23,7 +23,9 @@
     "lint": "eslint .",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
+    "check:encoding": "node scripts/check-encoding.mjs",
     "check:package": "node scripts/check-package.mjs",
+    "check:repo": "node scripts/check-repo.mjs",
     "prepack": "npm run build && npm run check:package"
   },
   "dependencies": {