Quickstart

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

This installs the caldir CLI and the default provider plugins.

Or install from source

Make sure you have Rust and Cargo installed.

# Clone the repo:
git clone https://github.com/t4t5/caldir

# Install the CLI:
cd caldir
cargo install --path caldir-cli

# Install the providers you want:
cargo install --path caldir-provider-google
cargo install --path caldir-provider-icloud
cargo install --path caldir-provider-caldav
cargo install --path caldir-provider-outlook
cargo install --path caldir-provider-webcal

Connect a calendar

Choose a provider where you have calendar data:

caldir connect google

caldir connect icloud

caldir connect caldav

Complete the authentication process and watch your events be pulled into your directory as ICS files!

~/caldir/
└── google/
    ├── 2025-03-25T0900__dentist.ics
    └── 2025-03-26T1400__sprint-planning.ics

Using agents

To explore caldir with tools like Claude Code or Opencode, ask it to install: SKILL.md