ralph-operations

Use when managing Ralph orchestration loops, analyzing diagnostic data, debugging hat selection, investigating backpressure, or performing post-mortem analysis

Ir para a instalação

Repositório: duclm1x1/Dive-Ai
Última atividade na origem: 10 de fevereiro de 2026 às 17:50
Idioma detectado do SKILL.md: inglês
Estrelas: 4
Forks: 2

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/duclm1x1/Dive-Ai --skill ralph-operations

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

Status	Color	Meaning
running	green	Loop is actively executing
queued	blue	Completed, waiting for merge
merging	yellow	Merge in progress
needs-review	red	Merge failed, requires intervention
merged	dim	Successfully merged (with `--all`)
discarded	dim	Abandoned (with `--all`)

ralph loops                       # Any loops running?
cat .ralph/loop.lock 2>/dev/null  # Primary loop details
ralph loops stop <id>             # Graceful stop
ralph loops stop <id> --force     # Immediate stop
ralph loops discard <id>          # Abandon + clean worktree

ralph loops diff <id>             # What changed
ralph loops logs <id> -f          # Live event log
ralph loops history <id>          # State changes
ralph loops attach <id>           # Shell into worktree

File	Contents
`.ralph/events.jsonl`	Event stream: hats, iterations, tool calls
`.ralph/agent/summary.md`	Current session summary
`.ralph/agent/handoff.md`	Handoff context for next iteration
`.ralph/agent/scratchpad.md`	Working notes
`.ralph/agent/tasks.jsonl`	Runtime task state

ralph loops merge <id>            # Queue for merge
ralph loops process               # Process pending merges now
ralph loops retry <id>            # Retry failed merge

jq -r '.prompt' .ralph/loop.lock 2>/dev/null
tail -20 .ralph/merge-queue.jsonl | jq .

RALPH_DIAGNOSTICS=1 ralph run -p "your prompt"

LATEST=$(ls -t .ralph/diagnostics/ | head -1)
SESSION=".ralph/diagnostics/$LATEST"

File	Contains	Key Fields
`agent-output.jsonl`	Agent text, tool calls, results	`type`, `iteration`, `hat`
`orchestration.jsonl`	Hat selection, events, backpressure	`event.type`, `iteration`, `hat`
`performance.jsonl`	Timing, latency, token counts	`metric.type`, `iteration`, `hat`
`errors.jsonl`	Parse errors, validation failures	`error_type`, `message`, `context`
`trace.jsonl`	All tracing logs with metadata	`level`, `target`, `message`

wc -l "$SESSION/errors.jsonl"
jq '.' "$SESSION/errors.jsonl"
jq -s 'group_by(.error_type) | map({type: .[0].error_type, count: length})' "$SESSION/errors.jsonl"

jq '{iter: .iteration, hat: .hat, event: .event.type}' "$SESSION/orchestration.jsonl"
jq 'select(.event.type == "hat_selected") | {iter: .iteration, hat: .event.hat, reason: .event.reason}' "$SESSION/orchestration.jsonl"
jq 'select(.event.type == "backpressure_triggered") | {iter: .iteration, reason: .event.reason}' "$SESSION/orchestration.jsonl"

jq 'select(.type == "tool_call") | {iter: .iteration, tool: .name}' "$SESSION/agent-output.jsonl"
jq -s '[.[] | select(.type == "tool_call")] | group_by(.iteration) | map({iter: .[0].iteration, tools: [.[].name]})' "$SESSION/agent-output.jsonl"

jq 'select(.metric.type == "iteration_duration") | {iter: .iteration, ms: .metric.duration_ms}' "$SESSION/performance.jsonl"
jq -s '[.[] | select(.metric.type == "token_count")] | {total_in: (map(.metric.input) | add), total_out: (map(.metric.output) | add)}' "$SESSION/performance.jsonl"

jq 'select(.level == "ERROR" or .level == "WARN")' "$SESSION/trace.jsonl"

SESSION=".ralph/diagnostics/$(ls -t .ralph/diagnostics/ | head -1)"
echo "=== Session: $SESSION ==="
echo -e "\n--- Errors ---"
wc -l < "$SESSION/errors.jsonl" 2>/dev/null || echo "0"
echo -e "\n--- Iterations ---"
jq -s 'map(select(.event.type == "iteration_started")) | length' "$SESSION/orchestration.jsonl"
echo -e "\n--- Hats Used ---"
jq -s '[.[] | select(.event.type == "hat_selected") | .event.hat] | unique' "$SESSION/orchestration.jsonl"
echo -e "\n--- Backpressure Count ---"
jq -s 'map(select(.event.type == "backpressure_triggered")) | length' "$SESSION/orchestration.jsonl"
echo -e "\n--- Termination ---"
jq 'select(.event.type == "loop_terminated")' "$SESSION/orchestration.jsonl"

jq -s '[.[] | select(.type == "tool_call")] | group_by(.name) | map({tool: .[0].name, count: length}) | sort_by(-.count)' "$SESSION/agent-output.jsonl"

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%S.000000Z)'","loop_id":"<loop-id>","event":{"type":"needs_review","reason":"Merge process died"}}' >> .ralph/merge-queue.jsonl
ralph loops discard <loop-id>

git worktree repair
ralph loops prune

ralph clean --diagnostics              # Delete all sessions
ralph clean --diagnostics --dry-run    # Preview deletions

Task	Command
List active loops	`ralph loops`
List all (including merged)	`ralph loops --all`
View loop changes	`ralph loops diff <id>`
View loop logs	`ralph loops logs <id>`
Follow logs live	`ralph loops logs <id> -f`
Stop running loop	`ralph loops stop <id>`
Merge completed loop	`ralph loops merge <id>`
Retry failed merge	`ralph loops retry <id>`
Abandon loop	`ralph loops discard <id>`
Clean stale processes	`ralph loops prune`

Task	Command
List active loops	`ralph loops`
List all (including merged)	`ralph loops --all`
View loop changes	`ralph loops diff <id>`
View loop logs	`ralph loops logs <id>`
Follow logs live	`ralph loops logs <id> -f`
Stop running loop	`ralph loops stop <id>`
Merge completed loop	`ralph loops merge <id>`
Retry failed merge	`ralph loops retry <id>`
Abandon loop	`ralph loops discard <id>`
Clean stale processes	`ralph loops prune`

ralph-operations

Opções de instalação

Revise os arquivos de origem