Documentation Index
Fetch the complete documentation index at: https://docs.selftune.dev/llms.txt
Use this file to discover all available pages before exploring further.
Usage
selftune cron <subcommand> [options]
Subcommands
setup
Install a scheduled job for automated operation:
selftune cron setup [--dry-run] [--platform cron|launchd|systemd|openclaw] [--tz TIMEZONE]
selftune run on a regular interval without requiring an
agent session or spending tokens on agent invocations.
| Flag | Description |
|---|
--dry-run | Show what would be configured without installing |
--platform | Scheduling system to use (auto-detected if omitted) |
--tz TIMEZONE | Timezone for scheduling (default: system timezone) |
list
Show installed scheduled jobs:
remove
Remove all installed scheduled jobs:
selftune cron remove [--dry-run]
| Platform | macOS | Linux |
|---|
| launchd | Default | — |
| systemd | — | Default |
| cron | Fallback | Fallback |
| openclaw | Via --platform openclaw | Via --platform openclaw |
Run history
Every cron execution is logged to a local cron_runs SQLite table, providing a persistent audit trail of scheduled work.
Logged jobs
| Job | Description |
|---|
sync | Pushes local telemetry to selftune Cloud |
status | Collects skill health and trend snapshots |
run | Runs the full evolution pipeline |
Captured fields
Each execution record includes:
| Field | Description |
|---|
jobName | Name of the scheduled job |
startedAt | ISO 8601 timestamp when execution began |
durationMs | Wall-clock duration in milliseconds |
status | success or error |
metrics | Job-specific counters (e.g. sessions synced, proposals generated) |
error | Error message and stack trace on failure |
selftune dashboard.
