- namespace
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-attach -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-attach -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-attach -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jmagly/aiwg --skill ralph-attach -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/jmagly/aiwg/tree/HEAD/agentic/code/addons/agent-loop/skills/ralph-attachFrom the publisher
Attach to a running external agent loop and tail its output log in real time. Press Ctrl+C to detach without interrupting the loop.
Users may say:
The ID of the loop to attach to. If omitted, attaches to the most recently started active loop.
/ralph-attach --loop-id abc123
When multiple loops are active, you must specify --loop-id. Run /ralph-status first to list active loop IDs.
When triggered:
.aiwg/ralph-external/loops/ to find active loop state files--loop-id is not provided, select the loop with the most recent startedAt timestamp that has status: "running"--loop-id is given, list them and prompt the user to specifylogFile path from its state JSON (typically .aiwg/ralph-external/logs/<loop-id>.log)succeeded, failed, aborted)Output format while tailing:
[10:42:01] Agent loop abc123 — ACTIVE (iteration 3/10)
[10:42:01] Running verification: npm test
[10:42:03] PASS src/auth/auth.test.ts
[10:42:03] Tests: 12 passed, 0 failed
[10:42:04] Iteration 3: VERIFIED — criteria met
[10:42:04] Agent loop: SUCCESS
On loop completion:
═══════════════════════════════════════════
Agent Loop Completed: SUCCESS
Loop ID: abc123
Iterations: 3
Duration: 4m 12s
Report: .aiwg/ralph-external/reports/abc123.md
═══════════════════════════════════════════
Detached from loop abc123.
No active loops:
No active agent loops found.
Start one with:
aiwg ralph "your task" --completion "criteria"
Or check completed loops with:
/ralph-status --all
Loop ID not found:
Loop 'xyz999' not found in .aiwg/ralph-external/loops/.
Active loops:
abc123 — Fix auth tests (running, iteration 2/10)
def456 — Migrate to ESM (running, iteration 5/20)
Attach with: /ralph-attach --loop-id abc123
Log file missing or unreadable:
Cannot read log for loop abc123.
Expected: .aiwg/ralph-external/logs/abc123.log
Check that the loop process is still running and has write access to the log directory.
Multiple loops active (no --loop-id):
Multiple active agent loops. Specify which to attach to:
abc123 — Fix auth tests (running, iteration 2/10, started 10:38)
def456 — Migrate to ESM (running, iteration 5/20, started 09:15)
Usage: /ralph-attach --loop-id <id>
.aiwg/ralph-external/loops/<loop-id>.json.aiwg/ralph-external/logs/<loop-id>.log.aiwg/ralph-external/reports/<loop-id>.md/ralph-attach
Response: Streams live output from the single running agent loop.
/ralph-attach --loop-id abc123
Response: Streams output only from loop abc123.
Press Ctrl+C while attached.
Response: Returns to normal prompt; the agent loop continues running unaffected.
/ralph-status — Check loop IDs and current iteration progress/ralph-abort — Stop a loop entirely/ralph-resume — Resume a paused loop/ralph-external — Start a new crash-resilient external loopAttach to a running agent loop's live output stream
---name: ralph-attachdescription: Attach to a running agent loop's live output stream---# agentic/code/addons/agent-loop/skills/ralph-attach/SKILL.mdFAQ
Download agentic/code/addons/agent-loop/skills/ralph-attach/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/jmagly/aiwg.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.