Quickstart

Linux or macOS:

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

Windows:

powershell -c "irm https://caldir.org/install.ps1 | iex"

This installs the caldir CLI and the default provider plugins. Prebuilt binaries are also available on the releases page.

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

Install with Nix

nix run github:t4t5/caldir -- --help

Or add github:t4t5/caldir as a flake input and use packages.${system}.default (or overlays.default) in your NixOS or home-manager config. The package includes all provider binaries.

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