@wavilikhin/ralph-wiggum 0.1.12 → 0.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
# Ralph Wiggum
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@wavilikhin/ralph-wiggum)
|
|
4
|
+
[](https://github.com/wavilikhin/ralph-wiggum/actions/workflows/publish.yml)
|
|
5
|
+
|
|
3
6
|
```
|
|
4
7
|
____ _ _ __ ___
|
|
5
8
|
| _ \ __ _| |_ __ | |__ \ \ / (_) __ _ _ _ _ _ _ __
|
|
@@ -9,6 +12,28 @@
|
|
|
9
12
|
|_| |___/
|
|
10
13
|
```
|
|
11
14
|
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
# npm
|
|
19
|
+
npx @wavilikhin/ralph-wiggum init
|
|
20
|
+
|
|
21
|
+
# bun
|
|
22
|
+
bunx @wavilikhin/ralph-wiggum init
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Or install globally:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# npm
|
|
29
|
+
npm install -g @wavilikhin/ralph-wiggum
|
|
30
|
+
|
|
31
|
+
# bun
|
|
32
|
+
bun install -g @wavilikhin/ralph-wiggum
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
12
37
|
This is a near-vanilla implementation of the [Ralph Wiggum autonomous loop](https://ghuntley.com/ralph/) pattern by Geoffrey Huntley. The core idea: run an AI coding agent in a loop where each iteration gets fresh context, picks exactly one task, implements it, validates it passes all checks, commits, and repeats until done. This produces clean atomic commits and avoids context window bloat.
|
|
13
38
|
|
|
14
39
|
Built for [OpenCode](https://opencode.ai), but should work with any CLI-based coding agent that can read files and run commands.
|