Privacy
Short version: your writing stays on your Mac. Iliad has no accounts and no tracking. Nothing leaves your Mac until you ask the AI for help, and then only the passage you're working on goes out. With the free AI, neither Iliad nor Groq keeps it.
Last updated: 25 September 2026 · Iliad MD 0.4.0
Your documents
Your documents are ordinary Markdown files in a folder you choose. Iliad opens and saves them on your Mac. It never uploads them anywhere.
Comments you leave on a document are saved in a file next to it, in the same folder (for example chapter.comments.md). They are yours like any other file, and they are never sent to the AI.
When text leaves your Mac
Only when you ask. Typing never sends anything. Text is sent when you press a suggestion key (⌘, sentence, ⌘. paragraph, ⌘/ full idea) or pick an action in the ✦ AI menu, and only this:
- For a suggestion at your cursor: the document's title, the headings around your cursor, and the text before and after it, up to about a page (roughly 2,500 characters before and 1,000 after). If you use Steer…, also the direction you typed.
- For ✦ AI on a selection: the paragraph (or list item, table or code block) that contains your selection, up to 4,000 characters, and the instruction you typed or picked.
Nothing more than that: never your folder, your other files or your comments. The answer comes back to your Mac only, and nothing changes in your document until you accept it.
The AI runs on Groq, with the openai/gpt-oss-120b model. How the text gets there depends on which of the two ways you use it.
Free AI (the default)
With no key of your own, your request goes from your Mac to Iliad's AI server, which passes it to Groq and streams the answer back. Three parties are involved:
- Cloudflare runs Iliad's AI server (a Cloudflare Worker). It carries your request, including the text, and sees your internet address, as any network in the path does. Logging on Iliad's server is turned off; Cloudflare's own handling of traffic follows Cloudflare's privacy policy.
- Groq writes the answer. It receives the text from Iliad's server, not from your Mac, so it doesn't see your internet address. Zero Data Retention is on for Iliad's Groq account (checked on 25 September 2026), so Groq doesn't keep the text or the answer. How Groq handles data.
- Iliad (that's me) doesn't store your text, the answer, or your internet address. To keep the free AI fair and its cost bounded, the server keeps only daily counters: how many requests each install made, and how many came from each network. An install is a random ID; a network is a one-way scrambled code of your internet address that changes every day, so it can't be turned back into the address or linked across days. The counters are deleted within 48 hours.
The random install ID is created the first time you use the free AI and saved on your Mac. It is not linked to your name, email, Mac or documents. Requests also carry the app's version number, so an old version can be asked to update.
The free AI has a daily limit, reset at 00:00 UTC. When it runs out, Iliad tells you when it comes back. There is no counter to watch and nothing is queued.
Your own Groq key (optional)
In Writing assists → Use my key you can paste a Groq API key. From then on, requests go straight from your Mac to Groq: no Iliad server in between, and no daily limit from Iliad.
- What you send is covered by your own Groq account and its terms. By default Groq may keep requests for up to 30 days, only to troubleshoot or investigate abuse; you can turn on Zero Data Retention in your Groq account's Data Controls.
- Your key is stored only on your Mac, encrypted and protected by the macOS Keychain. Iliad sends it only to Groq: once to check it before saving, then with each request.
- Iliad never switches ways on its own. If your key stops working, Iliad tells you; it doesn't quietly send your text through the free route instead.
Iliad never uses your text for anything but your answer. No accounts, no analytics, no ads, no training. If you'd rather a document never leave your Mac, don't ask the AI for help on it: Iliad sends nothing unless you do.
Other times Iliad goes online
- Checking for updates. Iliad asks GitHub whether there is a new version. GitHub sees your internet address, as any website would. Nothing about your documents is sent.
- Finding the AI server. With the free AI, Iliad may read a small file from iliad.md, at most once a day, that says where Iliad's AI server is. It asks for nothing about you; it's like visiting this website.
- YouTube videos. If a document contains a YouTube link, Iliad shows the video using YouTube's privacy-enhanced player (youtube-nocookie.com). YouTube sees that request, as it would in a browser.
Claude Code, Codex and other tools
If you let an AI tool like Claude Code or Codex work in your folder, that tool follows its own privacy terms. Iliad only shows you, on your Mac, what the tool changed.
This website
iliad.md uses no cookies and no analytics. The fonts come from Google Fonts and the download comes from GitHub, so those two services see your internet address when you visit or download.
Questions
Iliad and its AI server are made and run by Sebastián Marambio. Both are open source, so anyone can check all of this in the code. If something here is unclear, ask me on GitHub. If this page changes, the date at the top changes with it.