Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Fix bracketed paste bug, remove jq dependency, add task guard, add README, add safety warnings
What This Skill Does
A tmux-based workflow for running Claude Code tasks in background sessions using completion callbacks instead of polling. Tasks signal their own completion via an event command, eliminating repeated output reads. Suited for multi-file coding work that needs to run unattended.
Uses completion callbacks instead of polling, cutting supervision token usage by 80-97% compared to skills that read terminal output every 30-60 seconds.
When to use it
- Refactoring an auth module to JWT while continuing other work
- Implementing a new feature across 5+ files in the background
- Running a multi-file code migration without active supervision
- Confirming a long-running background task completed with a single check
- Deciding whether to spawn a session or just edit files directly
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Refactor the auth module to use JWT across multiple files
- 1Check that the task involves 3+ files, confirming Claude Code is appropriate
- 2Run start.sh with the task description and a completion callback command appended
- 3Wait for the openclaw system event notification signaling task completion
- 4Run monitor.sh --lines 50 to confirm the result
- 5Run stop.sh to clean up the tmux session
Auth module refactored to JWT; session closed after one monitoring read
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.