Endless Toil is a plugin for Codex Desktop, Codex CLI, and Claude Code that plays escalating human groans in real time as your coding agent reads increasingly cursed code.
Key Takeaways
Works as a local plugin marketplace entry; supports Codex Desktop, Codex CLI (codex plugin marketplace add .), and Claude Code (/plugin install endless-toil@endless-toil).
Audio output uses afplay on macOS or paplay/aplay/ffplay on Linux; degrades gracefully to scan-result printing if no audio player is found.
Sound levels escalate through named tiers: groan, wail, and abyss, testable standalone via python3 plugins/endless-toil/skills/endless-toil/scripts/test_sounds.py.
Plugin structure follows the OpenAI Codex and Claude Code plugin specs, making it a working reference implementation of cross-runtime plugin packaging.
Requires Python 3.10+ and does not auto-activate; must be explicitly invoked per thread.