Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Changelog

## Unreleased
- **A fast Skylight sync for groceries and chores, without Claude** (optional, off until you turn it on). Every 2 minutes it brings the grocery list and the chores linked in `data/chore-map.json` into step with Reminders, both ways: a change on one side is copied, done beats not-done, the newer rename wins when both sides say when, and deletions never cross. It never creates, dates or reschedules a chore. The Skylight login lives in the Keychain. Setup is in docs/SETUP.md §3. Tested: 42 tests for the matching and conflict rules, chores by date and the connection to skylight-mcp (against a stand-in). Not tested: a real Skylight account, which waits on the Keychain login.
- **`ek add-list --title T`** adds a Reminders list. Tested: it refuses a name that already exists. Not tested: adding one, so as not to change a real Reminders account.

## 0.6.5
- **Theseus is in the Dock now,** like LeafJuice, with its menu bar icon as well. Right-click the Dock icon and choose Quit, or use Cmd-Q, Theseus > Quit, or the menu bar icon's Quit. Closing the window keeps Theseus running.
- **Every Quit really quits.** Before, Quit stopped the helper that gives Remote Control a terminal but not the `claude remote-control` it had started, so that kept running, and macOS called Theseus "in use" when you tried to replace it. Some Quits also didn't leave the note that tells the watchdog to leave Theseus closed, so it came back within a minute. Now every Quit leaves that note and stops everything Theseus started, politely first and by force after three seconds. If anything holds Quit up, Theseus exits anyway after eight seconds. Opening Theseus clears the note, so the watchdog looks after it again.
Expand Down
14 changes: 14 additions & 0 deletions docs/SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,20 @@ claude mcp add skylight --scope user -e [email protected] -e SKYLIG
For family events to show on the frame, turn on Skylight's two-way calendar sync (Skylight app → Sync Calendars) and
set `family_calendar` in config.json.

**Fast Skylight sync** (optional): keeps groceries and the chores in `data/chore-map.json` within about 2 minutes of
Skylight, both ways, without Claude. It never deletes anything and never dates or creates a chore. Rules and limits are at
the top of `engine/tools/skylight_sync.py`.
1. Put your Skylight login in the Keychain. `security` asks for the password twice without showing it, and it never lands in a file
or your shell history:
```bash
security add-generic-password -U -s "Theseus Skylight" -a [email protected] -w
```
2. Check what it would do first. This only reads: `python3 engine/tools/skylight_sync.py run --dry-run`.
3. Switch it on with `"skylight_sync": "tool"` in config.json, then start it every 2 minutes with the command that
`python3 engine/tools/skylight_sync.py install` prints.
4. `python3 engine/tools/skylight_sync.py status` shows the last pass and any alert. If Skylight asks you to sign in again, the
sync stops until you've done that and run `python3 engine/tools/skylight_sync.py resume`.

**Things 3 migration:** nothing to install. `/migrate` reads Things read-only. Things is never changed.

## 4. First run
Expand Down
3 changes: 3 additions & 0 deletions engine/RULES.md
Original file line number Diff line number Diff line change
Expand Up @@ -199,6 +199,9 @@ A `was:<section>` on a done item is where it came from, for the app's reopen. Le
Skylight-only. When a mapped chore is added or changed, keep both sides and the map in step.
**Changing a chore's schedule:** never move a Skylight series' start date, because that erases its past occurrences. End the old series
(`recurring_until`), create a new one, and update the map.
**Fast sync** (`skylight_sync: "tool"`, off by default): `engine/tools/skylight_sync.py` keeps groceries (5) and the chore-map links (6)
in step every 2 minutes, without Claude, from a LaunchAgent. While it's on, syncs don't mirror groceries or chores themselves. They run
`python3 engine/tools/skylight_sync.py status` and list its alerts under ⚠️ Needs attention, then clear the ones the user has dealt with.
7. **Title edits**: the most recently modified version wins. If unsure, keep the master version and log it.
8. **Calendar**: never edit or delete events the user didn't ask about. Create events via `calendar_source`, routed by
`calendar_routes` (default `default_calendar`). Household events go on `family_calendar` (which shows on Skylight if it's synced there).
Expand Down
1 change: 1 addition & 0 deletions engine/templates/config.json
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,7 @@
"grocery_reminders_list": "Groceries",
"skylight_todo_list": "To Do",
"skylight_grocery_list": "Grocery",
"skylight_sync": "off",
"skylight_todo_categories": [
"#Home"
],
Expand Down
15 changes: 15 additions & 0 deletions engine/tools/ek.swift
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@
// ek add-event --title T --start "2026-11-05 14:00" [--end ...|--minutes 60]
// [--cal Name] [--location L] [--notes N] [--allday] [--alert 15]
// ek lists
// ek add-list --title T (a new Reminders list, in the same account as the default list)
// ek reminders [--list "A,B"] [--completed-since 2026-10-01] [--all-lists]
// ek add-reminder --title T [--list Name] [--due "2026-11-05 09:00"|--due 2026-11-05]
// [--notes N] [--priority high|medium|low|none] [--url U]
Expand Down Expand Up @@ -224,6 +225,20 @@ case "lists":
ensure(.reminder)
emit(store.calendars(for: .reminder).map(calDict))

case "add-list":
ensure(.reminder)
guard let title = opt("title")?.trimmingCharacters(in: .whitespaces), !title.isEmpty else { fail("--title is required") }
if store.calendars(for: .reminder).contains(where: { $0.title.lowercased() == title.lowercased() }) {
fail("a list called '\(title)' already exists")
}
guard let source = store.defaultCalendarForNewReminders()?.source else { fail("no default Reminders account to add the list to") }
let list = EKCalendar(for: .reminder, eventStore: store)
list.title = title
list.source = source
do { try store.saveCalendar(list, commit: true) } catch { fail("couldn't add the list: \(error.localizedDescription)") }
var made = calDict(list); made["created"] = true
emit(made)

case "events":
ensure(.event)
let (from, _) = opt("from") != nil ? needDate("from") : (Calendar.current.startOfDay(for: Date()), false)
Expand Down
Loading
Loading