@bobfrankston/gcal 0.1.44 → 0.1.45
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -20,12 +20,15 @@ gcal <command> [options] Run command
|
|
|
20
20
|
| Command | Description |
|
|
21
21
|
|---------|-------------|
|
|
22
22
|
| `list [n]` | List upcoming n events (default: 10) |
|
|
23
|
+
| `list -since <date>` | List events from `<date>` forward (past dates allowed) |
|
|
23
24
|
| `add <title> <when> [duration]` | Add event (explicit args) |
|
|
24
25
|
| `add` | Add event (type description interactively) |
|
|
25
26
|
| `add "free text description"` | Add event (AI parses single text arg) |
|
|
26
27
|
| `add -clip` | Add event from clipboard text (AI-parsed) |
|
|
27
28
|
| `del\|delete <id> [id2...]` | Delete event(s) by ID (prefix match) |
|
|
28
29
|
| `remind <id> <dur> [dur2...]` | Add reminder(s) to existing event |
|
|
30
|
+
| `resched <id> <when> [duration]` | Reschedule event (preserves duration by default) |
|
|
31
|
+
| `snooze <id> [when]` | Snooze event; defaults to `+1d` |
|
|
29
32
|
| `import <file.ics>` | Import events from ICS file |
|
|
30
33
|
| `calendars` | List available calendars |
|
|
31
34
|
| `assoc` | Set up .ics file association (Windows) |
|
|
@@ -42,6 +45,7 @@ gcal <command> [options] Run command
|
|
|
42
45
|
| `-b`, `-birthdays` | Include birthday events (hidden by default) |
|
|
43
46
|
| `-clip` | Read from clipboard (for add command) |
|
|
44
47
|
| `-r`, `-reminder <dur>` | Add popup reminder (e.g., 30m, 1h); repeatable |
|
|
48
|
+
| `-since <date>` | Start listing from `<date>` (e.g. `"10 days ago"`, `"April 1"`, `yesterday`) |
|
|
45
49
|
| `-all` | Delete all instances of recurring event |
|
|
46
50
|
|
|
47
51
|
## Examples
|
|
@@ -49,6 +53,8 @@ gcal <command> [options] Run command
|
|
|
49
53
|
```bash
|
|
50
54
|
gcal meeting.ics # Import ICS file
|
|
51
55
|
gcal list # List next 10 events
|
|
56
|
+
gcal list -since "10 days ago" # Include events from 10 days ago forward
|
|
57
|
+
gcal list -since "april 1" -n 50 # 50 events since April 1
|
|
52
58
|
gcal add "Dentist" "Friday 3pm" "1h"
|
|
53
59
|
gcal add "Lunch" "1/14/2026 12:00" "1h"
|
|
54
60
|
gcal add "Meeting" "tomorrow 10:00"
|
|
@@ -57,10 +63,22 @@ gcal add "Dentist appointment Friday 3pm for 1 hour"
|
|
|
57
63
|
gcal add -clip # Add from clipboard text
|
|
58
64
|
gcal add "Dentist" "Friday 3pm" -r 30m # Add with 30-min reminder
|
|
59
65
|
gcal remind abc12345 30m # Add 30-min reminder to event
|
|
66
|
+
gcal resched abc12345 "next friday 3pm" # Reschedule to new date/time
|
|
67
|
+
gcal resched abc12345 tomorrow # Move to tomorrow (preserves time-of-day)
|
|
68
|
+
gcal snooze abc12345 # Snooze +1 day
|
|
69
|
+
gcal snooze abc12345 +1w # Snooze +1 week
|
|
60
70
|
gcal add # Type event description
|
|
61
71
|
gcal -u bob@gmail.com # Set default user
|
|
62
72
|
```
|
|
63
73
|
|
|
74
|
+
### Reschedule / snooze
|
|
75
|
+
|
|
76
|
+
`resched` and `snooze` find events up to 30 days in the past by default, so stale
|
|
77
|
+
reminder events remain findable. Use `-since <date>` to widen that window. For
|
|
78
|
+
timed events, if `<when>` lacks a time-of-day (e.g. `tomorrow`, `next friday`) the
|
|
79
|
+
original start time is preserved. All-day events stay all-day. Relative offsets
|
|
80
|
+
`+1d` / `+1w` / `+1h` / `+1m` advance from the event's current start.
|
|
81
|
+
|
|
64
82
|
## File Association (Windows)
|
|
65
83
|
|
|
66
84
|
```bash
|