Skip to content

Commit 6bede8f

Browse files
Kasper Jungeclaude
authored andcommitted
docs: add CLI banner and terminal preview to landing page for users who want to see what ralphify looks like before installing
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 42b3ced commit 6bede8f

2 files changed

Lines changed: 34 additions & 2 deletions

File tree

β€Ždocs/assets/cli-banner.pngβ€Ž

21.4 KB
Loading

β€Ždocs/index.mdβ€Ž

Lines changed: 34 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,13 @@ hide:
33
- toc
44
---
55

6-
# Ralphify
6+
<p align="center">
7+
<img src="assets/cli-banner.png" alt="Ralphify CLI banner" style="max-width: 500px;" />
8+
</p>
79

8-
**Put your AI coding agent in a `while True` loop and let it ship.**
10+
<p align="center" style="font-size: 1.3em; margin-top: -0.5em;">
11+
<strong>Put your AI coding agent in a <code>while True</code> loop and let it ship.</strong>
12+
</p>
913

1014
Ralphify is a minimal CLI harness for autonomous AI coding loops, inspired by the [Ralph Wiggum technique](https://ghuntley.com/ralph/). It pipes a prompt to an AI coding agent, validates the work with checks, and repeats β€” each iteration starts with a fresh context window.
1115

@@ -43,6 +47,34 @@ ralph run # Starts the loop (Ctrl+C to stop)
4347

4448
`ralph init` creates a config file and a starter prompt. `ralph run` reads the prompt, pipes it to the agent, waits for it to finish, and does it again. Edit `PROMPT.md` while the loop is running β€” changes take effect on the next iteration.
4549

50+
### What it looks like
51+
52+
```
53+
$ ralph run -n 3 --log-dir ralph_logs
54+
55+
── Iteration 1 ──
56+
βœ“ Iteration 1 completed (52.3s) β†’ ralph_logs/001_20250115-142301.log
57+
Checks: 2 passed
58+
βœ“ lint
59+
βœ“ tests
60+
61+
── Iteration 2 ──
62+
βœ— Iteration 2 failed with exit code 1 (23.1s)
63+
Checks: 1 passed, 1 failed
64+
βœ“ lint
65+
βœ— tests (exit 1)
66+
67+
── Iteration 3 ──
68+
βœ“ Iteration 3 completed (41.7s) β†’ ralph_logs/003_20250115-143012.log
69+
Checks: 2 passed
70+
βœ“ lint
71+
βœ“ tests
72+
73+
Done: 3 iteration(s) β€” 2 succeeded, 1 failed
74+
```
75+
76+
Iteration 2 broke a test. Iteration 3 automatically received the failure output and fixed it β€” that's the self-healing loop in action.
77+
4678
---
4779

4880
## Why it works

0 commit comments

Comments
Β (0)