Hear your agent suffer through your code.
Endless Toil runs alongside your coding agent in real time, playing escalating recorded human groans as the code it reads starts to look more cursed.
Note: installing the plugin does not make it auto-activate in every thread by default. Start a new thread and ask Codex or Claude to use Endless Toil.
Clone this repository somewhere on your machine, then open that directory in Codex Desktop.
- Open
Plugins. - Search or browse for
Endless Toil, then open its details. - Select the plus button or
Add to Codex. - If prompted, complete any setup steps.
- Start a new thread and ask Codex to use
Endless Toil.
From Codex CLI, add this repository as a local marketplace root:
codex plugin marketplace add .
Then open the plugin browser:
Choose the Endless Toil marketplace, install Endless Toil, restart Codex if needed, and invoke the plugin or its bundled skill from a new thread.
Clone this repository somewhere on your machine, then start Claude from this repository root.
Add this repository as a local plugin marketplace:
/plugin marketplace add .
Then install the plugin:
/plugin install endless-toil@endless-toil
Restart Claude Code if prompted, then invoke the bundled skill:
From this repository root:
python3 plugins/endless-toil/skills/endless-toil/scripts/test_sounds.py --list
python3 plugins/endless-toil/skills/endless-toil/scripts/test_sounds.py groan wail abyss
- Python 3.10+
- A local audio player:
afplayon macOS, orpaplay,aplay, orffplayon Linux
If an audio player is unavailable, Endless Toil still prints scan results, but it will not play sounds.
Plugin structure and marketplace layout follow the OpenAI Codex and Claude Code plugin docs:
https://developers.openai.com/codex/plugins
https://code.claude.com/docs/en/plugins
