ralph-attach
SolidAttach to a running agent loop's live output stream
AI & Automation 142 stars
21 forks Updated yesterday MIT
Install
Quality Score: 93/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Al Attach
Attach to a running external agent loop and tail its output log in real time. Press Ctrl+C to detach without interrupting the loop.
## Natural Language Triggers
Users may say:
- "ralph attach"
- "attach to ralph"
- "follow ralph"
- "watch ralph output"
- "tail the agent loop"
- "stream ralph progress"
## Parameters
### --loop-id (optional)
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.
## Behavior
When triggered:
1. Read `.aiwg/ralph-external/loops/` to find active loop state files
2. If `--loop-id` is not provided, select the loop with the most recent `startedAt` timestamp that has `status: "running"`
3. If no active loop is found, report clearly and exit
4. If multiple loops are active and no `--loop-id` is given, list them and prompt the user to specify
5. Resolve the loop's `logFile` path from its state JSON (typically `.aiwg/ralph-external/logs/<loop-id>.log`)
6. Begin reading the log file from the current end, streaming new lines as they are appended
7. Display each new line to the user as it arrives, prefixed with a timestamp
8. Continue until the user presses Ctrl+C or the loop reaches a terminal state (`succeeded`, `failed`, `aborted`)
9. On loop completion, print a final status banner and exit cleanly
**Output format while tailing**:
```
[10:42:0...
Details
- Author
- jmagly
- Repository
- jmagly/aiwg
- Created
- 9 months ago
- Last Updated
- yesterday
- Language
- TypeScript
- License
- MIT
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Solid
ralph-status
Check status of current or previous agent loop
142 Updated yesterday
jmagly AI & Automation Solid
ralph-analytics
Show analytics and metrics from agent loop execution history
142 Updated yesterday
jmagly AI & Automation Solid
ralph-external
Crash-resilient external loop with state persistence and CI/CD integration
142 Updated yesterday
jmagly AI & Automation Solid
agent-loop-ext
Crash-resilient external agent loop with state persistence and CI/CD integration
142 Updated yesterday
jmagly AI & Automation Listed
ralph-wiggum
Support files for Ralph Wiggum loop commands and setup.
2 Updated 2 days ago
nota-america