Skip to content

Commit 862a273

Browse files
josealekhineclaude
andcommitted
docs: document Ralph loop and ctx slash commands in README
Update README with: - ctx tasks archive/snapshot commands in Command Reference - ctx loop command for generating Ralph loop scripts - Table of /ctx-* slash commands installed by ctx init - Updated loop generation example using ctx loop Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent adca721 commit 862a273

2 files changed

Lines changed: 33 additions & 3 deletions

File tree

.context/TASKS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@
8181
- [x] Make script executable by default
8282
- [x] Add `ctx loop --prompt PROMPT.md` — specify custom prompt file
8383
- [x] Add `ctx loop --tool claude|aider|generic` — target specific AI CLI
84-
- [ ] Document in README that `/ralph-loop` exists for Claude Code users
84+
- [x] Document in README that `/ralph-loop` exists for Claude Code users
8585

8686
### Phase 10: Project Rename `#priority:medium` `#area:branding`
8787
- [x] Rename project from "Active Memory" to "Context"

README.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,9 @@ ctx drift
146146
| `ctx session list` | List saved sessions |
147147
| `ctx session load <file>` | Load/display a previous session |
148148
| `ctx session parse <file>` | Parse JSONL transcript to markdown |
149+
| `ctx tasks archive` | Move completed tasks to archive |
150+
| `ctx tasks snapshot` | Create point-in-time snapshot of TASKS.md |
151+
| `ctx loop [--tool T]` | Generate a Ralph loop script (claude/aider/generic) |
149152

150153
### Examples
151154

@@ -411,10 +414,37 @@ everything across iterations.
411414
At its core, Ralph is just a loop that repeatedly invokes an AI with a prompt
412415
file.
413416

414-
**Claude Code** has a built-in Ralph Loop plugin: Just run `/ralph-loop` to
417+
**Claude Code** has a built-in Ralph Loop plugin: Just run `/ralph-loop` to
415418
start an autonomous loop directly in your session.
416419

417-
For other AI tools (*or custom setups*), you can create your own `loop.sh`:
420+
**ctx slash commands**: When you run `ctx init`, it also installs Claude Code
421+
slash commands for quick context operations:
422+
423+
| Command | Description |
424+
|--------------------|------------------------------------|
425+
| `/ctx-status` | Show context summary |
426+
| `/ctx-agent` | Load full context packet |
427+
| `/ctx-save` | Save context to session file |
428+
| `/ctx-add-task` | Add a task |
429+
| `/ctx-add-learning`| Add a learning |
430+
| `/ctx-add-decision`| Add a decision |
431+
| `/ctx-archive` | Archive completed tasks |
432+
| `/ctx-loop` | Generate a Ralph loop script |
433+
434+
For other AI tools (*or custom setups*), generate a loop script with `ctx loop`:
435+
436+
```bash
437+
# Generate a loop script for Claude
438+
ctx loop --tool claude --prompt PROMPT.md
439+
440+
# Generate for Aider
441+
ctx loop --tool aider --max-iterations 20
442+
443+
# Run the generated script
444+
./loop.sh
445+
```
446+
447+
Or create your own minimal loop:
418448

419449
```bash
420450
#!/bin/bash

0 commit comments

Comments
 (0)