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.

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.
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.

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.

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.

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.

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.

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

This page is generated from release-notes-v0.3.0.md, which you can also read as Markdown.