diff options
| author | Craig Jennings <c@cjennings.net> | 2026-07-19 15:42:22 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-07-19 15:42:22 -0500 |
| commit | b3195e9e55e185281d4d965333b1ad4ebb2ca6ee (patch) | |
| tree | 09858fe1e5afe569602ac9babc7df0b0bea9973a /claude-rules/desktop-capture.md | |
| parent | beb7f0bb76eaf0da3afd07fb8617361361556882 (diff) | |
| download | rulesets-b3195e9e55e185281d4d965333b1ad4ebb2ca6ee.tar.gz rulesets-b3195e9e55e185281d4d965333b1ad4ebb2ca6ee.zip | |
docs(rules): use gui-open to show Craig visuals
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.
Diffstat (limited to 'claude-rules/desktop-capture.md')
| -rw-r--r-- | claude-rules/desktop-capture.md | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/claude-rules/desktop-capture.md b/claude-rules/desktop-capture.md index 0051c4d..c4a67f9 100644 --- a/claude-rules/desktop-capture.md +++ b/claude-rules/desktop-capture.md @@ -38,9 +38,12 @@ output isn't available; it needs the compositor installed. Open it on a *separate* real workspace and tell them which one, so it never grabs their active workspace. They switch when ready. Craig's viewer preference -is `imv`; launch it through the compositor (`hyprctl dispatch exec "imv -<files>"`) so it survives the agent's shell rather than a bare `&` job that gets -reaped. +is `imv`; launch it with `gui-open --image <file>` (dotfiles-shipped) rather +than a bare `&` job or `hyprctl dispatch exec`: it detaches through `systemd-run +--user` so the agent shell can't reap it, resolves the current Hyprland instance +after a compositor restart, and confirms the viewer is mapped and visible before +returning. An HTML render uses `gui-open <file>` (or `--browser`) the same way. +If `gui-open` isn't on PATH, the machine needs a dotfiles pull. ## Always clean up |