calendar

README

Calendar

Calendar in the terminal.

Usage

cal

View a day's events (styled in a terminal, plain when piped; force either with --color always / --color never):

cal view [today]
cal view tomorrow
cal view yesterday
cal view 2026-08-01

Add an event:

cal add "Lunch with Will" --time 12:30 --duration 45m
cal add Standup --date tomorrow --time 9:15 --duration 15m
cal add Launch --date 2026-08-01 --all-day

[!NOTE] On first launch, allow your terminal to access Calendars in System Settings.

Installation

Install with Go:

go install github.com/maaslalani/calendar@main

Or download a binary from the releases.

EventKit

calendar reads your events directly from Apple's native EventKit framework, so it shows the same calendars as Calendar.app.[^go-eventkit]

[^go-eventkit]: EventKit access is powered by go-eventkit.

Calendar File System

[!WARNING] Not Implemented.

Interact with your calendar as a file system. See 0001-calfs.md for the design.

.
└── 2026
    └── 01
        ├── 01
        │   └── Meeting
        │       ├── description
        │       ├── invited
        │       │   ├── alice@example.com
        │       │   ├── bob@example.com
        │       │   └── carol@example.com
        │       ├── start -> 8:00AM
        │       └── end -> 10:00AM
        ├── 02
        ├── 03
        ├── 04
        │   ├── Event
        │   └── Event
        └── 05

License

MIT

Feedback

I'd love to hear your feedback on improving calendar.

Feel free to reach out via:

• Email
• Twitter
• GitHub issues

---

_zzz