← Back to Skills Marketplace
Resilient Claude Agent
by
matt martinez
· GitHub ↗
· v1.0.17
· MIT-0
201
Downloads
0
Stars
0
Active Installs
18
Versions
Install in OpenClaw
/install resilient-claude-agent
Description
Run Claude Code sessions in tmux for fire-and-forget execution with crash recovery, model routing, and structured task state.
Usage Guidance
This skill is internally consistent but explicitly enables a powerful, dangerous mode: it runs Claude with --dangerously-skip-permissions and dispatches shell commands into tmux. Only install it if you trust the orchestrator and are willing to run the agent in an isolated account/container/VM. Before installing: (1) audit the claude and openclaw binaries on PATH, (2) avoid using the 'claude-' tmux prefix for other unrelated sessions, (3) prefer a dedicated user or container for these tasks, and (4) consider whether you need an alternative that requires explicit human consent rather than skipping permissions. If you cannot guarantee the orchestrator's trustworthiness or prefer stricter controls, do not install this skill.
Capability Assessment
Purpose & Capability
Name/description (resilient Claude sessions in tmux) matches the included scripts and declared binary requirements (tmux, claude, openclaw). The files implement lifecycle, monitoring, resume, and atomic manifest updates that you would expect for this purpose.
Instruction Scope
The SKILL.md and scripts explicitly instruct running claude with --dangerously-skip-permissions, dispatching commands into tmux via send-keys, writing files in the project dir and temp dirs, and killing tmux sessions that match a prefix. These actions are dangerous but are openly documented and integral to the skill's design; they do broaden the runtime scope (arbitrary shell execution via the orchestrator and manipulation of tmux sessions).
Install Mechanism
Instruction-only with included scripts (no download/extract/install spec). Nothing writes arbitrary remote code at install time; all code is provided in the skill bundle. This is low-risk from an install mechanism perspective.
Credentials
No credentials or sensitive environment variables are required. Only MONITOR_* tuning env vars are referenced optionally. The skill does rely on external binaries (claude, openclaw) which the SKILL.md correctly asks users to audit, but it does not request unrelated secrets or broad system credentials.
Persistence & Privilege
always:false and no special platform privileges requested. The skill creates tmux sessions and temp directories and updates its own manifest files, but it does not claim to persist as an always-enabled skill or modify other skills' configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install resilient-claude-agent - After installation, invoke the skill by name or use
/resilient-claude-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.17
- Fix false-positive task abandonment: pane classifier was matching broad patterns (continue?, (y/n)) anywhere in the last 30 lines of output, killing healthy tasks whose output happened to contain those phrases.
Now matches only actual prompt shapes at end-of-line within the last 5 lines, and requires persistence across 2 consecutive polls before abandoning.
- Fix manifest data loss under concurrent writes: wrapper and monitor both update the manifest; previously they wrote to the same .tmp path and could clobber each other. Now uses mkdir-based locking and per-call
mktemp paths.
- Fix retry-budget escape for flapping tasks: RETRY_COUNT was reset on fresh output, so a crash-resume-work-crash loop never hit MONITOR_MAX_RETRIES. Added a separate TOTAL_RETRY_COUNT that never resets and drives
the cap.
- Fix resume dispatch on paths with spaces: tmux send-keys was passing bash $WRAPPER_PATH unquoted; any skill install path containing whitespace (common on macOS) broke the resume path. Now shell-quotes via printf
'%q'.
v1.0.16
Version 1.0.16
- Added a new script: scripts/local-smoke-test.sh for running local smoke tests.
- No other changes to core functionality.
v1.0.15
1. wrapper: touch done → kill -TERM $monitor_pid
2. monitor: TERM trap fires immediately (trap is installed before monitor.pid exists, so no race)
3. handle_term function: checks done file → exists → logs "Completion signal received" → exit 0
4. EXIT trap (cleanup): updates manifest if needed, kills tmux session, removes monitor.pid
5. Monitor process is gone within milliseconds of wrapper finishing
v1.0.14
- Monitor writes its PID to monitor.pid at startup and installs trap ':' USR1. The no-op handler is the key trick — bash interrupts sleep whenever a trapped signal arrives, so the monitor wakes from its polling
sleep and immediately re-runs the loop iteration, sees done, and exits cleanly through the EXIT trap.
- Wrapper sends kill -USR1 <monitor_pid> right after touch done. Best-effort: if monitor.pid doesn't exist or the signal fails, the monitor still catches completion on its next scheduled poll.
- Cleanup removes monitor.pid on exit.
v1.0.13
- Launch command (nohup ... & with log redirect): prevents SIGHUP from killing the monitor when the Brain's shell context exits. Output goes to $TMPDIR/monitor.log for post-mortem inspection.
- Signal traps (TERM/HUP/INT): log the signal and exit cleanly, firing the EXIT trap for manifest cleanup. SIGKILL still can't be trapped — nohup is the real fix — but softer signals now get graceful handling.
v1.0.12
No user-visible changes in this release.
- Version bump to 1.0.12 with no changes to files or documentation content.
v1.0.11
Version 1.0.11 of resilient-claude-agent
- No code or documentation changes detected in this version.
- No new features, bugfixes, or updates specified.
v1.0.10
**Added a comprehensive "Trust Model" section clarifying runtime permissions and security expectations.**
- Documents all security-relevant capabilities and mitigations, including `--dangerously-skip-permissions` and tmux behaviors.
- Outlines required trust assumptions and recommendations for deployment.
- No code or behavioral changes; documentation update only.
- No file changes detected in this release.
v1.0.9
No user-visible changes; documentation updated only.
- Updated skill documentation (SKILL.md) instructions for launching Claude Code sessions.
- Clarified that the wrapper now invokes Claude Code with the --dangerously-skip-permissions flag to ensure non-interactive operation inside tmux.
- No changes to code or runtime behavior.
v1.0.8
- No changes to source files in this release.
- Documentation only: SKILL.md updated for clarity and formatting; no behavioral or functional changes.
v1.0.7
resilient-claude-agent v1.0.7
- Update documentation to clarify that the model field in the manifest now accepts both short aliases (e.g., opus, sonnet) and full model names (e.g., claude-opus-4-6, claude-sonnet-4-6).
- No code changes; documentation only.
v1.0.6
No changes detected.
- Version 1.0.6 contains no file modifications compared to the previous release.
- Behavior, features, and documentation remain the same as the prior version.
v1.0.5
Version 1.0.5 of resilient-claude-agent
- No code or documentation changes detected in this release.
- Version increment only; functionality and usage remain unchanged.
- Fix permission errors on ClawHub install: monitor and wrapper now invoked with bash prefix so execute bits aren't required
v1.0.4
### Version 1.0.4
- Added `scripts/lib.sh` as a new file to the repository.
- Simplified required binaries in metadata (removed `jq` and `bash`).
- Changed the task state manifest format from JSON (`manifest.json`) to plain key=value (`manifest`) files.
- Updated all related documentation and examples to reflect the new manifest format and requirements.
v1.0.3
- Added perl and openclaw as required binaries in the skill metadata.
- No functional or behavioral changes; documentation updated to accurately reflect system requirements.
v1.0.2
No file changes detected; documentation update only.
- The SKILL.md was updated to clarify prompt handling for additional safety.
- In the "Prompt safety" section, replaced subshell command substitution with explicit stdin redirection in the wrapper (`claude -p --model "$MODEL" - < "$TASK_TMPDIR/prompt"`), emphasizing that prompts never appear in arguments or shell expansions.
- All instructions and safety notes were reviewed for accuracy; no logic or behavioral changes were made.
v1.0.1
- Skill renamed from **resilient-coding-agent** to **resilient-claude-agent**
- Added `jq` and `bash` as required dependencies in metadata
- Usage guidance updated: Orchestrator now explicitly decides when to delegate; self-invocation removed
- Clarified description and usage to focus on orchestrator-driven delegation and improved conciseness
v1.0.0
Initial release. Fire-and-forget Claude Code execution in tmux with three-layer health monitoring, automatic crash recovery, hang detection, model routing, and structured task state.
Metadata
Frequently Asked Questions
What is Resilient Claude Agent?
Run Claude Code sessions in tmux for fire-and-forget execution with crash recovery, model routing, and structured task state. It is an AI Agent Skill for Claude Code / OpenClaw, with 201 downloads so far.
How do I install Resilient Claude Agent?
Run "/install resilient-claude-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Resilient Claude Agent free?
Yes, Resilient Claude Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Resilient Claude Agent support?
Resilient Claude Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Resilient Claude Agent?
It is built and maintained by matt martinez (@mattmartinez); the current version is v1.0.17.
More Skills