Eagraí Clainne documentation

Eagraí Clainne is a self-hosted family organization system. It keeps a household's jobs, events, meals, lists and rewards on the family's own hardware. No data leaves the house.

The system ships as one Go binary. The binary serves the web app, the Connect RPC API, the MCP endpoint and these docs. An Android app, a CLI and MCP clients speak to the same API.

Sections

• Architecture decision records — the significant decisions, recorded as they were made: authentication, storage, authorization, service shape.
• API reference — every service, RPC and message, generated from the protobuf sources.
• Webhook events — every event the server can send to a registered webhook, with the pattern and signature rules.

Ground rules

These rules hold across the whole system:

• Every capability starts as a protobuf definition. Clients use the generated API surface and nothing else.
• Authorization denies by default. Each RPC has an explicit permission entry.
• Dates are YYYY-MM-DD. Clocks are 24-hour. These formats do not change with locale.
• The system depends on no third-party services at runtime. Push notifications go through the family's own ntfy server.