ctx update

Author: wcygan

CLAUDE.md

@@ -12,7 +12,7 @@ Guidance for Claude Code when working with this repository.
 
 ```bash
 cargo build                    # Build debug binary
-cargo test                     # Run all tests (106 tests)
+cargo test                     # Run all tests (127 tests)
 cargo clippy                   # Lint (must pass with no warnings)
 cargo fmt                      # Format code
 cargo run -- <command>         # Run with args
@@ -28,6 +28,7 @@ cargo run -- <command>         # Run with args
 | `status` | Show progress bar from IMPLEMENTATION_PLAN.md | — |
 | `archive` | Save spec/plan to `.ralphctl/archive/<timestamp>/`, reset to blank | `--force` |
 | `clean` | Remove ralph loop files | `--force` |
+| `update` | Install latest version from GitHub | — |
 
 ## Dependencies
 
@@ -39,6 +40,9 @@ cargo run -- <command>         # Run with args
 | `reqwest` | HTTP client for GitHub template fetching |
 | `regex` | Checkbox pattern matching |
 | `dirs` | XDG-compliant cache directory resolution |
+| `chrono` | Timestamp generation for archives |
+| `ctrlc` | Graceful Ctrl+C handling |
+| `nix` | Unix signal handling |
 
 ## Architecture
 
@@ -62,9 +66,12 @@ cargo run -- <command>         # Run with args
 
 **Template caching** (`templates.rs`): Network-first strategy—fetch from GitHub, cache locally, fall back to cache on failure. Cache: `~/.cache/ralphctl/templates/` (Linux) or `~/Library/Caches/ralphctl/templates/` (macOS).
 
-**Magic strings** (`run.rs`): Loop termination signals in Claude output:
-- `[[RALPH:DONE]]` — All tasks complete
-- `[[RALPH:BLOCKED:<reason>]]` — Cannot proceed, requires human intervention
+**Magic strings** (`run.rs`): Loop control signals in Claude output:
+- `[[RALPH:CONTINUE]]` — Task completed, more tasks remain; loop continues automatically
+- `[[RALPH:DONE]]` — All tasks complete; exit successfully
+- `[[RALPH:BLOCKED:<reason>]]` — Cannot proceed; exit with code 3 for human intervention
+
+Detection order: BLOCKED checked first, then CONTINUE/DONE (first match wins).
 
 ### Exit Codes
 

README.md

@@ -4,15 +4,27 @@ A CLI tool for managing Ralph Loop workflows—autonomous development sessions d
 
 ## Installation
 
-### Cargo Install (compile from source)
+Install as a binary compiled from source:
 
 ```bash
 cargo install --git https://github.com/wcygan/ralphctl
 ```
 
 ### Prerequisites
 
-Requires the `claude` CLI to be installed and available in PATH.
+Requires the `claude` CLI to be installed and available in PATH. You must be authenticated with Claude.
+
+## Quickstart
+
+These 3 self-contained commands get you started:
+
+```bash
+ralphctl init
+ralphctl interview
+ralphctl run
+```
+
+They will setup the necessary structure, create context in the correct format, and [run the loop](https://github.com/wcygan/ralphctl/blob/368a650db9ab6c9385cec19ac94074744f0669ec/src/main.rs#L372).
 
 ## Workflow
 
@@ -144,6 +156,16 @@ ralphctl clean [--force]
 
 Removes SPEC.md, IMPLEMENTATION_PLAN.md, PROMPT.md, and ralph.log.
 
+### `ralphctl update`
+
+Install the latest version of ralphctl from GitHub.
+
+```bash
+ralphctl update
+```
+
+Runs `cargo install --git https://github.com/wcygan/ralphctl` to fetch and compile the latest release.
+
 ## How It Works
 
 The Ralph Loop is an autonomous development workflow:
@@ -163,6 +185,7 @@ Each iteration starts with clean context. This eliminates "context rot"—the de
 
 The loop detects these signals in Claude's output:
 
+- `[[RALPH:CONTINUE]]` — Task completed, more tasks remain; loop continues automatically
 - `[[RALPH:DONE]]` — All tasks complete, exit successfully
 - `[[RALPH:BLOCKED:<reason>]]` — Cannot proceed, requires human intervention