From 521afb269567f5369bfdf8a35b6face57765ff65 Mon Sep 17 00:00:00 2001
From: terminalchai <terminalchai@gmail.com>
Date: Mon, 30 Mar 2026 03:07:25 +0530
Subject: [PATCH] docs(cli): add PowerShell curl examples

---
 docs/cli.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/docs/cli.md b/docs/cli.md
index e70fde2..ed3c0d0 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -1,5 +1,7 @@
 # CLI Reference
 
+> **Windows (PowerShell):** use `curl.exe` instead of `curl`. PowerShell aliases `curl` to `Invoke-WebRequest`, which breaks the shell examples below. For JSON request bodies, prefer a file input such as `curl.exe ... -d "@input.json"`.
+
 ## skrun init
 
 Create a new Skrun agent.
@@ -199,3 +201,27 @@ skrun deploy       # npx installs MCP server at runtime
 skrun test         # Verify changes
 skrun deploy       # Re-deploy (bump version in agent.yaml first)
 ```
+
+### Test POST /run from PowerShell
+```powershell
+$body = @{
+  input = "Audit this landing page for SEO issues"
+} | ConvertTo-Json
+
+$body | Set-Content -Path input.json
+curl.exe -X POST http://localhost:3000/run `
+  -H "Content-Type: application/json" `
+  -d "@input.json"
+```
+
+### Call a deployed agent from PowerShell
+```powershell
+$body = @{
+  input = "Summarize the latest changelog entry"
+} | ConvertTo-Json
+
+$body | Set-Content -Path input.json
+curl.exe -X POST https://your-agent.example/run `
+  -H "Content-Type: application/json" `
+  -d "@input.json"
+```