Tmux Ralph Loop — Productivity skill for Claude Code

tmux-ralph-loop

A resumable ticket loop for **Codex, Claude Code, OpenCode, and Pi**, running interactively in tmux.

Developed specifically for [Matt Pocock’s skill workflow](https://github.com/mattpocock/skills): plan the work, produce a spec, break it into tickets, then let the loop drive implementation. It automates opening a session, running [`implement`](https://github.com/mattpocock/skills/blob/main/skills/engineering/implement/SKILL.md), waiting for it to finish, and opening the next session—until the tickets are done or your input is needed.

**Agents can mark themselves blocked when they need something from you.** Because they run interactively inside tmux, you can attach to their session, answer questions, and unblock the same agent without starting over.

Why use it?

• Fresh context: each new attempt starts a new agent; the agent chooses an eligible ticket.
• Resume after interruptions: restart the watcher without launching duplicate work.
• Inspect progress: keep prompts, terminal logs, reports, and runtime events on disk.
• Keep dependencies in order: completed blockers and unchanged, checked acceptance criteria gate progress.

From idea to implementation

Install [Matt’s skills](https://github.com/mattpocock/skills#installation-30-second-setup) and run [`setup-matt-pocock-skills`](https://github.com/mattpocock/skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md) for your project, choosing **local Markdown files** as the tracker.

1. Run `wayfinder` over a few sessions to work through the decisions until the path is clear.
2. Use `to-spec` to turn the resolved decisions into a specification.
3. Use `to-tickets` to create numbered, dependency-