aboutsummaryrefslogtreecommitdiff
path: root/claude-rules/desktop-capture.md
Commit message (Collapse)AuthorAgeFilesLines
* docs(rules): use gui-open to show Craig visualsCraig Jennings7 days1-3/+6
| | | | | | | | interaction.md and desktop-capture.md told the agent to launch a viewer with google-chrome-stable ... & or hyprctl dispatch exec "imv ...". Both files already noted the failure mode: a coding-agent shell reaps an ordinary background child after it returns, so the window dies before Craig sees it. gui-open (dotfiles a34d479, on PATH) closes that. It detaches through systemd-run --user so the shell can't reap it, resolves the current Hyprland instance after a compositor restart, and confirms a mapped, visible client before returning. Both files now launch through it — gui-open <path> auto-detects image vs HTML, with --image/--browser to force. The separate-workspace guidance stays. gui-open replaces only the launch, which was the fragile part. Proposed by archsetup after shipping the tool. It's dotfiles-owned, not a rulesets script, so this is guidance only; a machine without it needs a dotfiles pull.
* docs: add off-workspace window/capture ruleCraig Jennings2026-07-111-0/+57
When an agent opens a window or takes a screenshot to verify its own work, it shouldn't hijack the workspace the user is actively using. New claude-rules/desktop-capture.md: render self-captures on an off-screen output (a Hyprland headless output) and tear them down. When showing the user something, open it on a separate real workspace and name it. verification.md points at it. The principle is environment-general. The recipe is Hyprland-specific. Verified non-disruptive on ratio 2026-07-06.