Skip to content

Commit 47e431e

Browse files
Jie Tongcraft-agents-bot
authored andcommitted
docs: add retry guidance for Windows Defender scan delay
On Windows, the binary may not appear immediately after install due to Defender scanning. Instruct agents to wait and retry up to 3 times. Co-Authored-By: Eureka <agents-noreply@craft.do>
1 parent e4ab58f commit 47e431e

File tree

2 files changed

+3
-1
lines changed

2 files changed

+3
-1
lines changed

index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -518,7 +518,7 @@ <h3 id="agent-setup">Agent setup workflow</h3>
518518
<strong>Wait for user confirmation</strong> — the agent pauses and asks the user to confirm the installation completed. The installer may fail silently or need user action.
519519
</li>
520520
<li>
521-
<strong>Verify installation</strong> — the agent checks the binary exists at the expected path (<code>~/.local/bin/m365</code> on macOS/Linux, <code>%LOCALAPPDATA%\m365-cli\m365.exe</code> on Windows) and runs <code>m365 --help</code>.
521+
<strong>Verify installation</strong> — the agent checks the binary exists at the expected path (<code>~/.local/bin/m365</code> on macOS/Linux, <code>%LOCALAPPDATA%\m365-cli\m365.exe</code> on Windows) and runs <code>m365 --help</code>. On Windows, Defender may scan the binary before it becomes available — the agent retries a few times with short delays if not found immediately.
522522
</li>
523523
<li>
524524
<strong>Login</strong> — the agent runs <code>m365 login</code> using the <strong>absolute path</strong> to the binary (since PATH may not be updated in the current session). The user completes Microsoft Entra ID sign-in in the browser. The agent verifies with <code>m365 status</code>.

skills/m365-cli/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,8 @@ test -f ~/.local/bin/m365 && echo "installed" || echo "not found"
5151
Test-Path "$env:LOCALAPPDATA\m365-cli\m365.exe"
5252
```
5353

54+
**If the binary is not found yet:** On Windows, Defender may scan the newly downloaded binary before it becomes available. Wait 5–10 seconds and check again — retry up to 3 times before reporting failure to the user.
55+
5456
Also verify the binary is on PATH and functional:
5557
```bash
5658
m365 --help

0 commit comments

Comments
 (0)