caldir

Manage calendar events as plaintext .ics files via the caldir CLI.

Updated May 3, 2026
One-click install
npx skills add https://github.com/druejaramillo/skills --skill caldir-druejaramillo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caldir
Source: https://github.com/druejaramillo/skills/tree/main/tools/caldir
Command: npx skills add https://github.com/druejaramillo/skills --skill caldir-druejaramillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the fragmentation of calendar management by allowing you to treat your schedule as a local directory of human-readable files, enabling version control, grep-based searching, and offline editing.

Core Features & Use Cases

  • Plaintext Calendar Management: Store events as individual .ics files that are easy to read and modify with standard text editors.
  • CLI Synchronization: Seamlessly sync local changes with external calendar providers using the caldir CLI.
  • Use Case: Quickly query your upcoming week or add a new meeting by interacting with your local filesystem or the CLI, ensuring your calendar remains portable and searchable.

Quick Start

Use the caldir skill to list all events scheduled for today across your work and personal calendars.

Frequently Asked Questions about caldir

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage calendar events as plaintext files for version control?

Plaintext calendar management stores events as individual .ics files in a directory, enabling version control, grep-based searching, and offline editing before syncing changes back to external calendar providers.

How do I sync local .ics files with an external calendar provider?

You sync local plaintext .ics files with external calendar providers using the caldir command-line interface, which handles ICS formatting, UID generation, and provider-side synchronization to keep your schedule updated.

Can I query upcoming calendar events directly from the command line?

Yes, you can query upcoming calendar events directly from the command line by interacting with your local filesystem or the caldir CLI to list scheduled events across your synced work and personal calendars.

What is the best way to edit ICS calendar data offline?

The best way to edit ICS calendar data offline is using a standard text editor to modify the individual plaintext .ics files in your local directory, then synchronizing the changes via the CLI when connectivity is restored.

Do I need the caldir CLI tool to format and generate UIDs for .ics files?

Yes, you need the caldir CLI tool because it automatically handles ICS formatting and UID generation required to create valid calendar files and successfully synchronize them with external providers.

Related Skills