Project Editors for AI, including Yaxed
Project editors for Mac. A Markdown editor built for AI projects, with plans and agent instructions. How it differs from other editors. Why I recommend Yaxed.
Use a project editor to guide an AI agent. Most people use AI in a chat window, where each conversation starts fresh and the results stay in the chat history. Experienced users of AI agents such as Claude Code and Codex keep the work in a project folder instead. The folder holds the instructions the agent reads at the start of every session, the plan it follows, and the record of what it did and decided. A project editor is the app you use to read and manage that folder, so you can keep the agent's plans and instructions clear and current. Then the agent does the work you want.
A project editor is one topic in "Set Up Your Mac", my guide to setting up a Mac. For everything else, see the full Mac setup roadmap.
Three types of editors for Markdown
Markdown is the plain text format AI agents read and write. There are three types of editors for Markdown. They differ in what they are built to manage:
- Simple Markdown editor - Built for one document at a time. You open a file, read it formatted, and edit it. A simple Markdown editor is enough when you only want to read a file an agent wrote. The article Markdown Editors for AI describes the kinds of Markdown editors.
- Project editor - Built for a project folder, the folder where an AI agent works. It lists the agent's instruction files, shows which documents the agent changed, and keeps your edits and the agent's from overwriting each other. You guide the AI agent with plans, specifications, instructions, and records that change every session.
- Knowledgebase - Built for a library of linked notes that grows over months or years, often called a "second brain." Obsidian is the best known. The article Knowledgebase Apps for AI compares knowledgebase apps and shows how an AI agent can keep one for you.
A code editor such as VS Code, Zed, or Cursor can also open Markdown files, but it is built for code. It shows Markdown as raw text, with a formatted preview in a separate pane. It also surrounds your documents with programming tools that many people who direct an AI agent never use. If you write code by hand, a code editor may be what you need. A project editor is easier if an AI agent writes most of the code, and you spend more of your time reading documents than writing raw code.
Why an AI project needs a project editor
An AI agent remembers almost nothing from one session to the next. What carries over is what it finds in the project folder. Claude Code reads its instructions from CLAUDE.md and Codex reads AGENTS.md. Both also read the plans and notes the project keeps. The article Agent Instructions explains the instruction files. The article Starter Projects shows how a project folder is set up.
Most of your work will be in those documents. You read the plan before the agent starts, correct an instruction when the agent gets something wrong, and trim what the agent writes. You'll need to keep documents short and current, which is the job a project editor is made for.
Ordinary editors make the job harder in three ways. An agent may rewrite a file while you have it open. Some editors keep showing the old version, or save your old copy over the agent's change. A project may hold dozens of documents, but most editors don't show which ones the agent just changed. And the instruction files sit among everything else, sometimes in hidden folders such as .claude, where a newcomer won't find them.
Yaxed, the project editor I recommend
Yaxed helps you manage an AI agent, with plans and instructions. It is a free Markdown editor, built for AI projects, from research and writing to coding. Uniquely, you can use the app to get help from experts.
I built Yaxed myself because other Markdown editors were not ideal for work with AI. Here's what it does.
Shows an agent's files
Open a project folder from the Finder, with File > Open, by dragging the folder onto the window, or by typing yaxed . in a terminal application. The sidebar lists the agent's instruction files first (AGENTS.md, CLAUDE.md, GEMINI.md) along with the project's README.md. Yaxed also recognizes the agents' settings folders (.claude, .codex, .agents), skill files, the changelog, and the license. Each of these has an info button that opens a Mac Install Guide article explaining what the file is for, which helps when an agent creates a file you haven't seen before. Housekeeping files such as .DS_Store stay hidden.
Merges file changes
When an agent changes a document you have open, Yaxed shows the new version at once. If you were typing at the same time and your edits don't overlap the agent's, Yaxed merges them. Only a real conflict asks you a question, with three choices: "Keep Mine", "Use the Agent's", and "Compare". Whatever you choose, the version history keeps the earlier text, so you can get it back. In a project that uses Git (the version control system most developers use), the sidebar marks the files changed since your last commit, so you can see what the agent touched. Yaxed saves as you type. It never changes any part of a file you didn't edit, so Git shows only your real changes.
Easier reading and edits
You read and edit the formatted document, with headings, tables, task lists, diagrams, and front matter shown clearly. When you need the raw Markdown, open it in a second window that stays in step with the first. Yaxed's Find in Project searches every document in the project. On a Mac with Apple Intelligence turned on, the TLDR tab shows a short summary of the front document, written on your Mac by Apple's own model, so your text never leaves the computer. Seven themes, each with a light and a dark version, set the look. You can also export a document as a PDF or print it.
Help from experts
The Experts tab is unique to Yaxed. AI agents seem very knowledgeable. But they don't know everything. Sometimes we need seasoned advice from human experts. Or help with "unknown unknowns," when we need expert help in formulating the right questions or instructions to guide AI.
You can write a question for Yaxed to send, through your own GitHub account, to Yaxed's public forum on GitHub. The answers appear in the same tab. The forum is public and you need a GitHub account to use it.
Creates starter projects
In the Yaxed app, File > New Project makes a copy of an example project, ready to open with an AI agent. They are the same projects the "Set Up Your Mac" apps install, including a simple project for trying an agent, two coding projects (a small one and a full-size one), a knowledgebase, and a set of Jupyter notebooks for Python. The article Starter Projects explains how they are organized.
And, of course, Yaxed is free
Yaxed is free and no account or subscription is needed. It runs on a Mac with Apple Silicon and macOS 15 or later, in English only. It needs no AI account of its own, because it works with the AI apps you already have. It honors your privacy and gathers no data, except anonymous usage statistics used to improve the product.
Other project editors
A few other editors are made for the documents that people and AI agents share. All of them are new. Nimbalyst combines a wiki that agents write with a visual workspace for Claude Code and Codex. OpenKnowledge calls itself a Markdown editor for humans and agents. Ritemark is made for people who don't write code. The markjason app is made for reading and editing agents' files on a Mac. Some of these run an AI agent inside the editor, which suits you if you want one app for everything. No product leads this group yet, so check each one's site before you choose.
Install Yaxed
The "Set Up Your Mac" apps offer Yaxed on a "Project editor" screen. If you choose it, the app installs Yaxed, makes it the default app to open Markdown files, and installs the yaxed command to open files from the terminal if you want.
To install Yaxed yourself, download yaxed.dmg from Yaxed's download page on GitHub. Open the file and drag Yaxed to your Applications folder.
To open a project, open any folder from Yaxed's File > Open menu.
Working beside an AI agent
With a project editor open beside the agent, the project folder becomes the place where you direct the work. The agent writes plans and records. You read them, correct them, and decide what it does next. Open Yaxed when you start a session with an agent. Keep it open while the agent works, so you see each change as it happens.
Recommended reading
- Markdown Editors for AI describes the other kinds of Markdown editors and the features that set them apart.
- Knowledgebase Apps for AI compares Obsidian, Tolaria, and other apps for linked notes, and shows how an AI agent can keep a wiki for you.
- Agent Instructions explains
CLAUDE.mdandAGENTS.md, the instruction files an AI agent reads. - Spec-Driven Development explains how to plan work in Markdown specs before an agent writes code.
Continue setting up your Mac
Don't miss the full visual roadmap and checklist that shows how to set up a Mac for software development, with all the essential tools and settings you might not yet know about.