From ef0b4bc6e201c137b22da4604590d28ebae7c2bd Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Sat, 20 Jun 2026 03:15:21 +0300 Subject: fix: support agent env hints refs #679 related #699 --- docs/next/website/src/content/docs/agents.mdx | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs') diff --git a/docs/next/website/src/content/docs/agents.mdx b/docs/next/website/src/content/docs/agents.mdx index 249be702..5e50dfdd 100644 --- a/docs/next/website/src/content/docs/agents.mdx +++ b/docs/next/website/src/content/docs/agents.mdx @@ -43,6 +43,10 @@ The screen snapshot comes from the recent bottom of the pane buffer, not the scr Claude Code, Codex, GitHub Copilot CLI, Droid, Qoder CLI, and Cursor Agent CLI integrations are intentionally not lifecycle authorities. They provide native session identity for restore, but their hooks do not cover the whole lifecycle. They can miss permission approval results, escape interrupts, or other transitions. For those agents, Herdr still uses screen manifest detection. +## VMs and sandbox wrappers + +On Linux, wrappers such as VMs, Bubblewrap, or `fence` can hide the real agent process from host `/proc`. Set `HERDR_AGENT=` on the command, for example `HERDR_AGENT=claude fence -- claude`, to tell Herdr which existing agent screen manifest to use. The hint is scoped to that foreground process; avoid exporting it globally from your shell unless every inherited foreground process should be treated as that agent. + ## Blocked state Blocked detection is deliberately strict for screen-manifest agents. Herdr only marks `blocked` when the live bottom-buffer snapshot matches known visible approval, question, or permission UI. If no manifest rule matches for a known agent, Herdr falls back to `idle` and labels that fallback as `default_known_agent_idle_fallback` in explain output. -- cgit v1.2.3