AGENT WATCH — WINDOWS APP

INSTALL ONCE
1. Extract this entire ZIP. Close the old collector window or quit Agent Watch.
2. Run Install App.cmd. The installer looks for your previous pairing and
   installs a permanent copy in %LOCALAPPDATA%\Agent Watch.
3. Keep Start automatically when I sign in selected.
4. Optionally paste your full private dashboard link to save its key in
   Windows Credential Manager, allowing one-click dashboard access.
5. Click Install and start. Agent Watch appears in the Windows system tray,
   possibly under its hidden-icons arrow. A desktop shortcut is also created.
6. Restart/reload Codex and Copilot once, reviewing the hooks if requested.
   They now use the permanent installed folder.

If no pairing is found, run Setup Windows.cmd once using your full private
https://agents.zasady.com/#... link, then Install App.cmd. Node.js 24 LTS
must be installed. Get it from https://nodejs.org/ if needed.
The extracted download can be deleted after installation succeeds.

EVERYDAY USE
Sign in to Windows. Agent Watch starts in the background automatically.
Open/resume your agents. There is no terminal window to keep open.
Double-click the tray icon or choose Open dashboard from its menu.
The app restarts the collector if it exits and reconnects after network loss.
Windows runs independently of the Mac; the website is hosted on Cloudflare.
The computer running an agent must be awake to report its activity.

APP MENU
Open dashboard / Pause reporting / Restart collector / Show logs /
Start at login / Quit for this session.
Uncheck Start at login to disable automatic startup. Quit for this session
stops it until you open the app again or sign in next time.

UPDATES
Quit the tray app. Extract the new ZIP and run Install App.cmd again.
The permanent pairing/data folder is retained. Reload agents after an
integration update. Do not delete the installed .data folder.

QUESTIONS
Tell agents: Use agent_watch.ask_user for ordinary questions and wait for my
 dashboard answer.
Questions appear on the relevant agent card. Native app permission prompts
stay in the agent app. Questions expire after 15 minutes. The collector does
not execute remote commands.

TROUBLESHOOTING
No tray icon: open the Agent Watch desktop shortcut; check hidden tray icons.
Disconnected: choose Restart collector or Show logs from the tray menu.
No pairing: use Setup Windows.cmd first.
Download does nothing: open this URL in Edge or Chrome:
https://agents.zasady.com/downloads/agent-watch-windows.zip
Missing recent Codex chats: run Diagnose Codex.cmd. If the sessions folder
is wrong, Set Codex Folder.cmd can set it, then restart the collector.

SECURITY AND LIMITS
The Windows app is a lightweight PowerShell tray app using your existing
Node installation, not a signed EXE installer. It uses the current Windows
account and needs no administrator rights. The PowerShell execution policy
is set for this process only; no system-wide policy change is made.
Do not share private dashboard links or the installed .data directory.
Windows Credential Manager holds the optional dashboard access key.
Mac menu-bar startup is verified locally. Windows GUI/credential integration
still needs its first real test on the Windows PC.
