Skip to content

docs(coop): link amq-keepalive companion in supervisor recipes - #263

Merged
avivsinai merged 1 commit into
mainfrom
docs/amq-keepalive-companion
Jul 21, 2026
Merged

docs(coop): link amq-keepalive companion in supervisor recipes#263
avivsinai merged 1 commit into
mainfrom
docs/amq-keepalive-companion

Conversation

@avivsinai

Copy link
Copy Markdown
Owner

Recovers the docs link from Ohad's #244 (which he closed) and the outcome of the #245 review: keep amq-keepalive external, and link it from AMQ's supervisor-recipes section.

Adds a short pointer in COOP.md to ohade/amq-keepalive — a standalone macOS companion that supervises target-aware amq wake for explicitly registered terminal sessions (Ghostty, cmux) via a user LaunchAgent, with SessionStart reattach hooks. It stays external, keeps AMQ daemon-free/transport-only, and talks to AMQ solely through the public CLI.

Text is Ohad's own wording from #244; verified the target repo is public and non-empty.

Co-authored with Ohad (credited in the commit).

🤖 Generated with Claude Code

Point the supervisor-recipes section at ohade/amq-keepalive, a standalone
macOS companion that supervises target-aware `amq wake` for explicitly
registered terminal sessions (Ghostty, cmux) via a user LaunchAgent. Keeps
AMQ daemon-free and transport-only; the tool stays external and talks to AMQ
solely through the public CLI. Recovers the docs link from Ohad's #244.

Co-Authored-By: Ohad Edelstein <ohade@users.noreply.github.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@avivsinai
avivsinai merged commit d9c87b5 into main Jul 21, 2026
5 checks passed
@avivsinai
avivsinai deleted the docs/amq-keepalive-companion branch July 21, 2026 18:23
avivsinai added a commit that referenced this pull request Jul 21, 2026
Follow-up accuracy fix to #263. Codex caught that the wording (inherited
verbatim from Ohad's #244) conflated two distinct mechanisms — it
credited the user LaunchAgent with reattaching wake after reboot.

Verified against the companion README's Boundaries section:
- "The tool does not launch or resurrect terminal sessions."
- "Reboot survival comes from reattaching on session start, not from
assuming a terminal id survives … restart. The recreated session
registers its current target."

So: the LaunchAgent supervises registered wakes through sleep; the
SessionStart hooks handle reboot reattach. Split the claim accordingly.

Caught by codex; verified live against ohade/amq-keepalive README.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant