jan-cli 0.24.0

YAML-defined CLI trees with progressive help, optional exec aliases, merged extra specs, and SQLite audit logging keyed by git branch
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

# Time triggers

Put a crontab expression (or a list of them) on a script node or its `run` child.
The **jan cron daemon** ticks every 100 ms, evaluates schedules, and runs matching
`run` leaves. Start it with `jan cron start`; stop with `jan cron stop`.

```yaml
commands:
  scripts:
    commands:
      misc:
        commands:
          morning-note:
            about: Append a daily note
            cron: "30 10 * * *"          # minute (5 fields)
            # cron: "* * * * * *"         # every second (6 fields)
            # cron: "*/5 * * * * * *"    # every 500 ms (7 fields)
            commands:
              run:
                exec:
                  argv: ["bash", "-lc", "echo hi >> ~/cron.txt"]
```

CLI details: [`jan cron`](../cli/cron.md).

## Expression syntax

Field counts determine granularity:

| Fields | Granularity | Example |
|--------|-------------|---------|
| 5 | minute | `30 10 * * *` |
| 6 | second | `0 * * * * *` (top of each minute) |
| 7 | 100 ms | `*/5 * * * * * *` (every 500 ms) |

Seven-field order: `decisecond second minute hour day-of-month month day-of-week`
(decisecond is 0–9, one tick = 100 ms).

Six-field order: `second minute hour day-of-month month day-of-week`.

Five-field order: `minute hour day-of-month month day-of-week` (unchanged).

Supported tokens per field: `*`, `N`, `A,B`, `A-B`, `*/S`, `A-B/S`.

| Field | Range |
|-------|-------|
| decisecond | 0–9 |
| second | 0–59 |
| minute | 0–59 |
| hour | 0–23 |
| day of month | 1–31 |
| month | 1–12 |
| day of week | 0–7 (0 and 7 are Sunday) |

Month/weekday **names** are not supported — use numbers.

Matching uses **local civil time**. Day-of-month and day-of-week are ANDed (both must match).

## Nicknames

| Nickname | Expands to |
|----------|------------|
| `@yearly` / `@annually` | `0 0 1 1 *` |
| `@monthly` | `0 0 1 * *` |
| `@weekly` | `0 0 * * 0` |
| `@daily` / `@midnight` | `0 0 * * *` |
| `@hourly` | `0 * * * *` |
| `@every_second` | `* * * * * *` |
| `@every_100ms` | `* * * * * * *` |

Install the daemon:

```bash
jan cron start
jan cron status
jan cron refresh   # after editing cron: in YAML
jan cron stop
```