Macaroni Messenger is a chat client delivered as a single HTML file that stores every message in a Git repository. The demo loads a hard‑coded read‑only *.macaroni* dataset, avoiding unauthenticated GitHub API limits on first view. Users can run messenger.html locally in Chrome, Chromium or Edge without any server, registration, or token for quick testing.

To join a real conversation, open Settings, connect a GitHub repository, and supply a fine‑grained token with repository Contents read/write scope. The client then uses Git fetch, pull and push and caching as its synchronization layer, storing chats under the .macaroni directory structure (users, chats, messages, inbox). No backend code runs; Git itself acts as database, transport and history.

Because the backend is Git, privacy depends entirely on repository visibility: a public repo exposes all messages, while a private repo shares them with anyone holding access. Large repositories become sluggish, so creators are advised to split chats across multiple repos. The project remains open‑source under the DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE, inviting developers to experiment with this minimalist messaging model today.