@@ -21,8 +21,9 @@ paths in `desktop/src/features/notifications/`.
2121 service session or over a headless SSH connection.
2222- Native Windows Node.js, pnpm, and Rust (MSVC) on ` PATH ` . The files under
2323 ` bin/ ` are Hermit shell wrappers and do not run from PowerShell.
24- - A second Buzz account that can send you a DM, or a message you can set a
25- reminder on.
24+ - One Buzz account in a community where you can create a private channel. The
25+ echo workflow in step 4 plays the other party, so you need neither a second
26+ account nor a local relay.
2627
2728### 2. Build and install
2829
@@ -64,11 +65,40 @@ $env:WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS = "--remote-debugging-port=9222"
6465Look for ` windows_notification_permission_state ` (expect ` "granted" ` or
6566` "denied" ` ) and ` show_native_notification ` .
6667
67- ### 4. Trigger a toast
68-
69- Set ** Remind me later** on a message for two minutes out, or have the second
70- account send you a DM while Buzz is in the background. Confirm each toast on
71- screen and in the Windows notification history.
68+ ### 4. Set up the echo workflow
69+
70+ A workflow reply is signed by the relay and tags the workflow owner, so Buzz
71+ treats it as someone else mentioning you and raises a toast.
72+
73+ 1 . Turn on ** Settings > Experiments > Workflows** .
74+ 2 . Create a private channel named ` notification-echo ` .
75+ 3 . Open ** Manage channel** , go to ** Workflows** , choose ** New workflow** ,
76+ select the ** YAML** tab, and paste:
77+
78+ ``` yaml
79+ name : Notification echo
80+ trigger :
81+ on : message_posted
82+ filter : ' str_contains(trigger_text, "echo-test") && !trigger_is_reply'
83+ steps :
84+ - id : wait
85+ action : delay
86+ duration : 30s
87+ - id : channel_echo
88+ action : send_message
89+ text : ' Echo: {{trigger.text}}'
90+ - id : thread_echo
91+ action : send_message
92+ reply_in_thread : true
93+ text : ' Thread echo: {{trigger.text}}'
94+ ` ` `
95+
96+ To trigger toasts, post ` echo-test 1` (increment the number each time) in
97+ ` notification-echo` , then switch to another channel or app within 30 seconds.
98+ You should get two toasts : **Echo:** as a channel message and **Thread echo:**
99+ as a reply in that message's thread. **Remind me later** set two minutes out
100+ also works as a trigger. A DM toast needs a second account, because the
101+ workflow `send_dm` action is not implemented.
72102
73103# ## 5. Checks
74104
@@ -89,15 +119,60 @@ screen and in the Windows notification history.
89119 Buzz", and triggers show no toast. Turn Buzz back on in Windows, turn the
90120 Buzz toggle on again, and the next trigger shows a toast. Buzz does not turn
91121 its own toggle back on automatically.
92- 5 . ** Click while running:** click a toast for a channel message or DM. Buzz
93- comes to the front and focuses that message in the channel timeline without
94- opening an empty thread panel. Click a toast for a thread reply; Buzz opens
95- that thread.
122+ 5. **Click while running:** click the **Echo:** toast. Buzz comes to the front
123+ and focuses that message in the channel timeline without opening an empty
124+ thread panel. Click the **Thread echo:** toast; Buzz opens that thread.
96125
97126Record the Windows build (`winver`), the Buzz version, and the result of each
98127check in the PR.
99128
100129# ## 6. Clean up
101130
102- Uninstall Buzz from ** Settings > Apps > Installed apps** if the test machine
103- should not keep it. Remove the second Windows account if you created one.
131+ Delete the echo workflow and the `notification-echo` channel. Uninstall Buzz
132+ from **Settings > Apps > Installed apps** if the test machine should not keep
133+ it. Remove the extra Windows account if you created one.
134+
135+ # ## 7. Run it with an AI agent
136+
137+ The agent needs to run PowerShell and to see and operate the Windows desktop.
138+ Windows computer use works only in the foreground of an unlocked, interactive
139+ session, and the agent takes over the mouse and keyboard while it works, so
140+ prefer a VM or a separate Windows account.
141+
142+ Harnesses that can do both on Windows :
143+
144+ - **ChatGPT desktop app for Windows:** in Work or Codex, install **Plugins >
145+ Computer Use**; see [Computer Use](https://learn.chatgpt.com/docs/computer-use).
146+ It cannot operate terminal apps, so it runs the build through its own shell
147+ tool.
148+ - **An MCP-capable agent plus [Windows-MCP](https://github.com/CursorTouch/Windows-MCP):**
149+ install [uv](https://docs.astral.sh/uv/) and Python 3.13 or newer, then
150+ register the server with your agent, for example :
151+
152+ ` ` ` powershell
153+ codex mcp add windows-mcp -- uvx windows-mcp serve --exclude-tools Registry
154+ copilot mcp add windows-mcp -- uvx windows-mcp serve --exclude-tools Registry
155+ ` ` `
156+
157+ The first line is for Codex CLI and the second for GitHub Copilot CLI. The
158+ Windows-MCP README also covers Claude Desktop, Claude Code, and Gemini CLI.
159+ Windows-MCP has full system access and sends anonymous telemetry unless
160+ ` ANONYMIZED_TELEMETRY=false` is set in its environment.
161+
162+ Browser-only agents, such as ChatGPT's cloud browser, cannot see a local
163+ desktop app. The Claude API computer use tool can, but only with an agent loop
164+ and desktop driver you provide yourself.
165+
166+ The agent cannot approve UAC prompts, sign in for you, or create Windows
167+ accounts, so do those steps yourself : installing prerequisites, signing in to
168+ Buzz, and check 2. Then paste a prompt like this into the agent :
169+
170+ ` ` ` text
171+ Follow the "Windows native notifications" runbook in desktop/TESTING.md of
172+ this checkout. Build and install Buzz (step 2), set up the echo workflow
173+ (step 4), and run checks 1, 3, 4, and 5. Do not read, type, or export private
174+ keys or passwords; if Buzz asks to sign in, stop and ask me. Do not approve
175+ UAC prompts. For each check, report pass or fail, what you observed, and a
176+ screenshot of the toast or of the notification history. Include winver output
177+ and the Buzz version. Clean up as in step 6 when done.
178+ ` ` `
0 commit comments