Aiwg ralph-status

Check status of current or previous agent loop

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/addons/agent-loop/skills/ralph-status" ~/.claude/skills/jmagly-aiwg-ralph-status-6ea9b9 && rm -rf "$T"

manifest: agentic/code/addons/agent-loop/skills/ralph-status/SKILL.md

source content

Al Status

Check the status of agent loops.

Usage

/ralph-status              # Current loop status
/ralph-status --verbose    # Detailed iteration history
/ralph-status --latest     # Show latest completion report
/ralph-status --all        # List all completion reports

Your Actions

Default (Current Loop)

Read
```
.aiwg/ralph/current-loop.json
```
Display status summary

If active loop exists:

Agent Loop: ACTIVE

Task: {task}
Completion: {completion}
Progress: {current}/{max} iterations
Duration: {elapsed}
Status: {running | paused}

Last iteration:
  Result: {result}
  Learnings: {learnings}

Use /ralph-resume to continue or /ralph-abort to stop.

If no active loop:

No active agent loop.

Use /ralph "task" --completion "criteria" to start one.

--verbose

Include full iteration history:

Agent Loop: ACTIVE

Task: {task}
Completion: {completion}
Progress: {current}/{max} iterations

Iteration History:
| # | Time | Action | Result | Learnings |
|---|------|--------|--------|-----------|
| 1 | 10:30 | Initial attempt | 3 failures | Need auth mocks |
| 2 | 10:32 | Added mocks | 1 failure | Date edge case |
| 3 | 10:34 | Fixed date | In progress... | - |

--latest

Read and display most recent completion report:

Find latest
```
completion-*.md
```
in
```
.aiwg/ralph/
```
Display contents

--all

List all completion reports:

Agent Loop History

| Date | Task | Status | Iterations |
|------|------|--------|------------|
| 2025-01-15 10:45 | Fix auth tests | SUCCESS | 3 |
| 2025-01-14 15:20 | Migrate to ESM | SUCCESS | 8 |
| 2025-01-13 09:00 | Add coverage | MAX_ITER | 10 |

View report: /ralph-status --report 2025-01-15

State File Location

Current loop:
```
.aiwg/ralph/current-loop.json
```
Iterations:
```
.aiwg/ralph/iterations/
```
Reports:
```
.aiwg/ralph/completion-*.md
```

Error Handling

No state directory:

Al has not been used in this project yet.

Get started with:
  /ralph "your task" --completion "verification command"

Or:
  /ralph --interactive

Corrupted state:

agent loop state file is corrupted.

Options:
1. Delete and start fresh: rm -rf .aiwg/ralph/
2. Check file manually: cat .aiwg/ralph/current-loop.json

References

@$AIWG_ROOT/agentic/code/addons/ralph/README.md — Ralph addon overview and loop executor documentation
@$AIWG_ROOT/docs/cli-reference.md — CLI reference for ralph-status and related commands
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/vague-discretion.md — Loop completion and iteration limit rules
@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework context