OmaCal

Site, downloads and the CLI guide: omacal.app

A native desktop calendar for Google Calendar, iCloud and any CalDAV server. Born on Omarchy Linux; runs on any Linux and on macOS. Tauri v2, Rust, Svelte 5. No servers: your events live in a local database, your tokens in your keyring, and nothing of yours passes through us.

Your terminal and your agent read the same calendar

The app binary is also a CLI. Reads come straight off the local database, offline:

omacal agenda --json
omacal events list --from 2026-09-01 --to 2026-09-05 --json
omacal search quarterly review

Writes (events create / update / delete / respond) are carried out by the running app through the same guards its own form has. The CLI refuses to guess which occurrences of a repeating event you mean, or whether guests get emailed. Stable JSON envelope, stable exit codes, never prompts.

Wiring an agent is one command, and every update refreshes the installed skill:

omacal skill install

The full guide, with real output: omacal.app/agents.

Built into Omarchy, not just running on it

Colours follow your Omarchy theme live. Installing also installs the omacal.upcoming bar widget: what is running now, today's remaining meetings, due tasks.

Invitations cannot slip past you

A new invitation notifies you and stays on screen until you deal with it; one click accepts. The header tray keeps Yes / Maybe / No for anything unanswered, plus who declined your meetings and what was rescheduled or cancelled. Only the invitation itself notifies. Answering updates the calendar at once while the reply saves behind it, so a morning's worth of invitations takes a morning's worth of clicks and no waiting; one that fails comes back to you on the invitation it belongs to.

Tasks, on the grid with the meetings

Task lists sync from CalDAV alongside the calendars, and for an account that brings none there are lists that live on this machine. A task due at a time is drawn at that hour, among the meetings — drag it to another hour or another day, tick it off where it sits. One due on a date sits in the day's row above the grid instead.

A task with a time announces itself when it is due, at the lead your phone set if it carries one. The Tasks pane holds the rest: what is outstanding, what is done, and which list each one is on.

It never emails people on your behalf

Moving an event with guests asks first, and without notifying is the default. Saving an edit asks who to tell. CalDAV edits are etag-guarded: a change that raced another device tells you instead of overwriting.

Sign-in with nothing to configure

No API key, no cloud project. Installed builds carry OmaCal's own Google-verified client. iCloud connects with an app-specific password; any other CalDAV server with its URL. Task lists (VTODO) come along.

Public calendars need no account at all: Add WebCal account takes a webcal:// or https:// address — a university timetable, a fixture list, a holidays feed — and follows it on the same sync as everything else. A subscription is someone else's calendar, so it is read-only throughout.

Install

curl -fsSL https://omacal.app/install.sh | sh

Linux on x86_64 or ARM64 (Omarchy on an Apple Silicon Mac, through Asahi, included) and macOS on Apple Silicon. On Linux the AppImage lands in ~/.local/bin with a desktop entry; on a Mac, OmaCal.app in Applications with the omacal command on your PATH, signed and notarized. A .deb, .rpm and .dmg are on the releases page. A minimal Hyprland session needs a keyring running: gnome-keyring, KeePassXC or kwallet.

Updating

When a newer release exists the header grows an Update button; one click fetches it, verifies the signature and restarts. Re-running the install line does the same. A .deb or .rpm is replaced with the newer package; AppImage managers update in place through the published .zsync. omacal doctor prints the version you are on.

The rest, briefly

Five views, Day to a whole-year ribbon; quick add from one typed line (q), shown as a receipt before anything is created; the weather in every day's header; a week that can start today and show the next three, five or seven days; keyboard-first, with ? showing every key; a list mode that leaves empty days out; search that resolves a repeating event to one result; several accounts, with colours that stay local; reminders that mirror what your phone fires; the same meeting held on two calendars drawn as one block, if you turn it on; and an interface scale for a screen whose own scaling never reaches the app.

Building from source: docs/running-on-omarchy.md · docs/running-on-macos.md. The design record lives under docs/superpowers/.

License

MIT — see LICENSE.