Skip to content

Commit e324f41

Browse files
docs(scouts): scrub host-TZ/DST reference from README (#52)
The 'crontab times are in the host's local timezone' paragraph leaked the ops context of our own devbox (UTC host, CDT user). Replace with a scheduler-agnostic note that lists cron, systemd timers, GitHub Actions, and launchd — the scout CLI doesn't care which one you use, and customers shouldn't read internal ops details in what is otherwise a clean target-architecture doc.
1 parent 23c283e commit e324f41

1 file changed

Lines changed: 9 additions & 10 deletions

File tree

scouts/README.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -58,19 +58,18 @@ ralph scout tail my-scout # watch an in-flight run
5858

5959
Output lands in `results/<scout-name>/pw-YYYYMMDD-HHmm/` (also gitignored).
6060

61-
## Running nightly via cron
61+
## Running on a schedule
6262

63-
If you set up a nightly cron, it will fail silently if `scouts/` is empty.
64-
Either seed a scout from a template or run `ralph scout init` once before
65-
the first cron invocation. Pin the user dir explicitly in the crontab entry
66-
if you want scouts to live outside the repo:
63+
Scouts are a CLI, so any scheduler works — cron, systemd timers, GitHub
64+
Actions `schedule:`, launchd on macOS. Pin `RALPH_USER_DIR` in the entry if
65+
you want scout data to live outside the repo:
6766

6867
```cron
69-
0 9 * * * RALPH_USER_DIR=$HOME/ralph-data /path/to/ralph-for-kiro \
70-
scout --concurrency 3 --min-iterations 2 --max-iterations 4 \
68+
RALPH_USER_DIR=$HOME/ralph-data
69+
0 9 * * * /path/to/ralph-for-kiro scout \
70+
--concurrency 3 --min-iterations 2 --max-iterations 4 \
7171
>> $HOME/ralph-data/cron.log 2>&1
7272
```
7373

74-
Remember that crontab times are in the host's local timezone — if your
75-
devbox runs UTC and you want a local-CST time, convert accordingly (and
76-
remember DST will shift the run by an hour twice a year).
74+
The scheduler will fail silently if `scouts/` is empty — seed with
75+
`ralph scout init` or `--from-example` once before the first run.

0 commit comments

Comments
 (0)