calcurse

A text-based calendar and scheduling application.

Usage (CLI Mode)

Use calcurse in non-interactive mode for quick queries and updates.

Query

List appointments for the next 2 days:

calcurse -r2

Query a specific date range:

calcurse -Q --from 2026-01-20 --to 2026-01-22

Add Items

Add an appointment:

calcurse -a "Meeting with Team" 2026-01-21 14:00 60

(Format: Description, Date, Time, Duration in mins)

Add a todo:

calcurse -t "Buy milk" 1

(Format: Description, Priority)

Interactive Mode (TUI)

For the full TUI experience, run in a PTY session (e.g., inside tmux or using process with pty=true).

calcurse