Getting started

Install

curl -sSf https://caldir.org/install.sh | sh

This installs the caldir CLI and the Google Calendar and iCloud provider plugins.

Install from source

Make sure you have Rust and Cargo installed.

cargo install --path caldir-cli
cargo install --path caldir-provider-google   # Google Calendar
cargo install --path caldir-provider-icloud   # Apple iCloud

Connect a calendar

# Google Calendar
caldir connect google

# Apple iCloud
caldir connect icloud

This opens your browser for authentication, fetches your calendars, and creates a local directory for each one under ~/caldir/.

Sync your events

# Pull remote events to local
caldir pull

# Your calendar is now in ~/caldir/
ls ~/caldir/

After pulling, you’ll have a directory structure like:

~/caldir/
  personal/
    2025-03-20T1500__client-call.ics
    2025-03-21__offsite.ics
  work/
    2025-03-25T0900__dentist.ics
    2025-03-26T1400__sprint-planning.ics