From 1cf3e297f3921903c50aa0154f711f2f1c168a28 Mon Sep 17 00:00:00 2001
From: sysCat64 <691686+sysCat64@users.noreply.github.com>
Date: Sat, 20 Jun 2026 15:31:01 +0900
Subject: [PATCH] Document Windows print-mode issue

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 41c89a5..68713c2 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,12 @@ plugins/codex-agy-plugin/scripts/agy-print.sh -- "-starting prompt text"
 For review and second-opinion requests, Codex should ask `agy` to return findings only and not modify files.
 For release-readiness or repeated reviews, Codex should pass a blocker-only prompt: report only High/Medium issues that can break install, runtime, validation, CI, or distribution; return `APPROVED` when there are no blockers.
 
+## Known Issues
+
+On Windows, there is a report that `agy --print` can exit with code `0` but produce empty stdout when launched from Codex/non-interactive PowerShell, while the same command works from an interactive PowerShell session. See [Issue #1](https://github.com/sysCat64/codex-agy-plugin/issues/1).
+
+This plugin relies on `agy --print` writing the final response to stdout. It does not read Antigravity internal transcript or log files as a fallback because those files are not a stable integration boundary.
+
 ## Validate
 
 ```bash