--- title: Iliad MD v0.3.0 description: Release notes for Iliad MD v0.3.0 — a calm writing surface, and the place to review what your AI agent wrote. category: Release Notes order: 86 --- # Iliad MD v0.3.0 Iliad MD v0.3.0 is a signed and notarized macOS release for Apple Silicon Macs. It is the biggest change to Iliad so far: the app now does two things, and tries to do them well. 1. **Write one document at a time**, with small AI help that never takes over: inline completion, the ✦ AI menu on selected text, and the corrector. 2. **Review what an AI agent wrote.** When Claude Code, Codex, or any other tool edits the Markdown in your folder, Iliad shows every change in the document, chunk by chunk, and you keep or restore it. > Image to add: release-v0.3.0.png - Iliad window with no side panel: the file tree with Notes and Comments rows under the open document, and an outside edit showing Keep and Restore on one chunk. ## What's New ### Review outside changes chunk by chunk When another tool edits a document while Iliad is open, each changed chunk appears in place with **Keep** and **Restore**. The toolbar above the document still offers **Keep all** and **Restore all**. Files created outside Iliad offer **Keep file** or **Move to Trash**; files deleted outside offer **Confirm deletion** or **Restore file**. A restore never overwrites newer work: if the file changed again, Iliad refreshes the review instead. Keep and Restore are buttons only. `Tab` and `Esc` never act on outside chunks, so nothing on disk changes by accident. See [Reviewing Agent Changes](/learn/ai-review-workflow/). ### Notes and comments are plain files Each document can have two companion files next to it: - `name.comments.md` holds the comments you attach to passages. - `name.notes.md` holds your writing notes for that document (voice, audience, facts). **Writing assists → Open notes** creates and opens it. They are ordinary Markdown, so any agent can read them, and they move, duplicate, and go to the Trash together with their document. In the file tree they appear as **Notes** and **Comments · N** under the document you have open. See [Comments, Notes, And The ✦ AI Menu](/learn/comments-tighten-edit-selection/). ### The `iliad` command and a Claude skill Choose **Iliad MD → Install ‘iliad’ Command…** to put `iliad` on your `PATH`. Then: - `iliad status` tells you (and your agent) which folder and document are open. - `iliad open file.md --line 42` shows a document in Iliad at a line. - `iliad skill install` installs a skill for Claude Code that explains how to work with Iliad: check `iliad status`, read the notes, address and delete handled comments, keep edits minimal, and finish with `iliad open`. See [Working With Claude Code](/learn/working-with-claude-code/). ### One Gemini key for all built-in AI Inline completion and the ✦ AI menu both run on one Gemini API key, set in **Writing assists**. Without a key, autocomplete is off and ✦ AI is shown disabled; clicking it takes you to the key field. ### Faster inline completion Three keys ask for a length directly: `⌘,` a sentence, `⌘.` a paragraph, `⌘/` the full idea. `⌘↵` (the AI key) suggests a sentence and grows it when pressed again; with text selected it opens the ✦ AI menu. `Tab` accepts, `Esc` dismisses, `⌥↑`/`⌥↓` shows another suggestion, and **Steer…** gives the next one a direction. See [Autocomplete](/learn/autocomplete/). ### The ✦ AI menu Select text, press `⌘↵` or click **✦ AI**, and choose **Rewrite**, **Expand**, **Shorten**, **Summarize**, **Turn into a list**, or type your own instruction. The result is shown in place; `Tab` accepts and `Esc` rejects. ## What Was Removed, And Why Iliad no longer has a built-in agent. These are gone: - the assistant chat panel, its history, context attachments, and process receipts; - the Codex connection and the OpenAI API key (and the OpenAI fallback for autocomplete); - voice dictation (and the microphone permission); - the Telegram remote and its relay; - house rules in `AGENTS.md` read by the built-in agent. Claude Code, Codex, and similar tools are now much stronger at long, multi-document work than a panel inside an editor could be, and they keep improving on their own. Keeping a second agent inside Iliad duplicated them and took most of the maintenance. So larger AI work happens in your agent of choice, writing to the folder, and Iliad becomes the calm place where you write and where you see and judge what the agent did. Your `AGENTS.md` or `CLAUDE.md` files are untouched; outside agents still read them. ## How To Migrate - **Comments move automatically.** The first time you open a workspace in 0.3.0, Iliad moves its saved comments into `name.comments.md` files next to their documents. Comments on documents that no longer exist are skipped. - **Writing notes move automatically.** The first time you open a document that had notes, Iliad writes them to `name.notes.md` (only if that file does not exist yet). - **Add a Gemini key.** Open **Writing assists** in the topbar and paste a Gemini API key in the key field ("Get a key" links to Google AI Studio). Google bills this API separately. Your old OpenAI key and Codex login are no longer used. - **Connect your agent.** Install the command from the app menu, run `iliad skill install` for Claude Code, or `iliad skill print` to paste the instructions into another agent's `AGENTS.md`. - Old chat history and pending internal proposals are no longer read. They stay in the app's data folder and are harmless. ## Download The public download is available from the GitHub release page: `https://github.com/brainforwarding/iliad/releases/tag/v0.3.0`