dariussingh

Whiletrue — Git skill for Claude Code

Git community

Local Python orchestrator that runs pipelines of agent and deterministic steps around Claude Code, opencode and Codex: gates, human-in-the-loop, parallel git worktrees, crash-safe resume.

How to install Whiletrue

This entry records only its repository, not the path inside it, so there is no exact command to give. Open dariussingh/whiletrue and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Whiletrue does

Local Python orchestrator that runs pipelines of agent and deterministic steps around Claude Code, opencode and Codex: gates, human-in-the-loop, parallel git worktrees, crash-safe resume.

Alternatives in Git

Bulletproof Quick Start Guide — Target Audience: Complete beginners Never used Python/git before 11.1k ★
Loki Verify — Run Loki's deterministic PR verification on the current change and summarize the evidence verdict 1.1k ★
Cmt — When user uses /cmt slash command, commit current git changes using fast mode by default, or strict mode when 301 ★

README

whiletrue

**The loop around your coding agents.**

Run pipelines of agentic and deterministic steps around Claude Code, opencode and Codex, locally, with gates, humans in the loop, and crash-safe resume.

[![PyPI](https://img.shields.io/pypi/v/whiletrue?logo=pypi&logoColor=white)](https://pypi.org/project/whiletrue/) [![Python](https://img.shields.io/pypi/pyversions/whiletrue?logo=python&logoColor=white)](https://pypi.org/project/whiletrue/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Docs](https://img.shields.io/badge/docs-docs%2F-informational)](docs/README.md)

LangGraph builds the agent; whiletrue runs the loop around agents you already have.

Recording of a real run: two Claude Code agents work in parallel in tmux panes while a control panel and shell show status, both items pass their pytest gate and park for human approval, then approve and resume finish them

A real run, not a mock-up: two Claude Code agents in parallel, a pytest gate, a human approval and a resume, about $0.23 in total. Captured from the live tmux panes; the two tmux windows are drawn side by side.

uvx whiletrue init      # scaffold a Ralph loop
uvx whiletrue run       # agent -> pytest gate -> repeat until green

Overview

Coding agents are good at one task and bad at finishing a backlog unattended. whiletrue is the orchestrator you put around them. You describe the loop in a single `whiletrue.yaml`: which agent does the work, which deterministic gate checks it, when to retry, when to ask a person. whiletrue validates the config before spending a token, runs it, and records every step so you can inspect, replay or resume it.