# pimutils/khal

:calendar: CLI calendar application

Repository: https://github.com/pimutils/khal
Canonical: https://ross.abutalabs.com/products/khal
Homepage: https://khal.readthedocs.io/
Language: Python
License: MIT
License Family: permissive
Topics: python, calendar, terminal, icalendar
Last push: 2026-08-24T21:14:20+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 4756, "days_push": 9, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3042, forks 231 (observed 2026-08-28T04:07:39.284054+00:00)

## What it is
khal is a standards-based CLI and terminal calendar application written in Python that reads and writes iCalendar events to vdir storage. It can synchronize with CalDAV servers via vdirsyncer and includes an interactive browser/editor called ikhal.

## Use cases
- manage my calendar from the terminal
- add calendar events quickly from the command line
- sync my calendar with a CalDAV server
- browse and edit iCalendar events in a TUI
- view upcoming events in a terminal agenda

## When to choose
- you want a lightweight, standards-based (iCalendar/CalDAV) calendar in the terminal
- you already use vdirsyncer or other pimutils tools
- you prefer keyboard-driven, scriptable calendar management on Linux/macOS/BSD

## When to avoid
- you need a graphical calendar interface
- you primarily use Windows (unsupported)
- you need to edit event timezones, which is not yet supported

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, scheduling
- domain: developer-tools
- platform: bsd, cli, python, cross-platform
- tags: calendar, icalendar, caldav, terminal-ui, vdirsyncer, pim, command-line, linux, macos

## Member repositories
- pimutils/khal (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:39.284054+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:29:13.869134+00:00, confidence not recorded.
  - readme: https://github.com/pimutils/khal (fetched 2026-08-28T04:07:39.284054+00:00, sha 19062603165d)
  - registry_pypi: https://pypi.org/pypi/khal/json (fetched 2026-08-29T09:44:47.517531+00:00, sha d35b5ee12d77)
- Data as of 2026-08-30T08:39:29.467469+00:00.