Contains the mysteries of time.
README.md

Eye of Agamotto #

Eye of Agamotto (eoa) is a self-hosted, single-user-first CalDAV and CardDAV server written in Rust. It pairs a standards-conformant WebDAV engine (RFC 4918, 4791, 6352, 6578, 6764) with an embedded relational store, revocable secret-token share feeds, a CORS-aware edge for browser clients such as Calino, and server-side meeting invitations over email.

It serves CalDAV and CardDAV clients and the Calino web app, signs people in with passkeys, sends and reads meeting invitations by email, and gives agents an MCP endpoint authorized with OAuth. It runs on Railway as one all-in-one service with SQLite on a volume, or anywhere a container runs.

eoa's web app is a light fork of Calino, the browser calendar client by Ivan Malinovski, released under the MIT License. eoa does not vendor Calino: each image build clones a pinned Calino release and applies the small patch series in deploy/calino/patches/, which wires Calino to eoa's runtime configuration, IndexedDB storage, invitation answers and safety, eoa's branding, and a link back to this source. deploy/calino/README.md describes each patch, and Calino's LICENSE ships with every image as calino-LICENSE.txt.

The source is at https://tangled.org/ngerakines.me/eye-of-agamotto.

Specification #

The specification lives in openspec/ and describes eoa as it is. openspec/specs/ holds the normative requirements as 27 capability specs, and openspec/eye-of-agamotto.md is the technical companion: Part I (§1–§23) for behavior, Part II (§24–§35) for the implementation, with the rationale, algorithms, catalogs and the decision register (§26). Specs are edited in the same commit as the code; work larger than one commit is an OpenSpec change under openspec/changes/.

Layout #

The Cargo workspace has three crates. crates/eoa-dav is the storage-agnostic CalDAV and CardDAV protocol library, crates/eoa-mcp is the Model Context Protocol endpoint for agents, and crates/eoa is the server library and the eoa binary. Shared test fixtures live in fixtures/.

Development #

Every check and build is a justfile recipe. just ci-fast runs formatting, lints, specification validation, the fast test tier and doc tests. The toolchain is pinned to Rust 1.98 by rust-toolchain.toml. The developer tools are just, cargo-nextest, cargo-deny, cargo-machete, sqlx-cli, Node.js 20.19 or newer (for the OpenSpec CLI) and Podman or Docker.

License #

Licensed under either of the Apache License, Version 2.0 (LICENSE-APACHE) or the MIT license (LICENSE-MIT), at your option. Calino, which the images build from upstream and patch, is MIT licensed by Ivan Malinovski.