From 0f161fac287011b3e216383e2b8482f049fd6a7b Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Tue, 21 Jul 2026 22:09:38 +0300 Subject: docs: add alternate-screen output fallback --- SKILL.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'SKILL.md') diff --git a/SKILL.md b/SKILL.md index a7b86ef9..fafea549 100644 --- a/SKILL.md +++ b/SKILL.md @@ -180,7 +180,9 @@ Use the read source that matches the task: Use `--format ansi` when colors and terminal styling are evidence. Otherwise use text. -Full-screen agents may use the terminal alternate screen. Rows that disappear from that screen do not enter Herdr's host scrollback, so `recent`, `recent-unwrapped`, and larger `--lines` values cannot recover them. Enlarge the pane, request concise output, use the agent's transcript controls, or scroll inside the agent and read `--source visible`. +`--lines` asks Herdr for more rows from the pane's available screen and host scrollback. If increasing it does not reveal more of a completed response, the pane is probably running the agent on the terminal's alternate screen. Rows that leave the alternate screen do not enter Herdr's host scrollback, so a larger line count cannot recover them. + +After that failed read, ask the agent to write its complete response as Markdown in a temporary directory and reply only with the file path, then read the file directly. Use this only as a fallback; do not request file output in the initial prompt. ## Safety and coordination rules -- cgit v1.2.3