Install & launch
Requirements
- macOS 13 (Ventura) or later
- An AI coding agent you already use, Claude Code, Cursor CLI, Codex CLI, or GitHub Copilot CLI. See Connect your agent.
Install
- Download codraft from your account portal.
- Open the
.dmgfile. - Drag codraft.app to your Applications folder.
- Double-click codraft to launch. If macOS asks whether to open the app, click Open.
First launch
The first time you open codraft you'll see an empty document, an untitled page on cream paper, with a small toolbar at the top.
You can start writing immediately. Type some text, format it with the usual shortcuts (⌘B, ⌘I), or paste in Markdown from anywhere.
Open an existing document
Three ways:
- Drag a
.mdfile onto the codraft window or icon in the Dock. - File → Open… from the menu bar (
⌘O). - From your agent. Ask it to "open
notes/project.mdin codraft" once you've connected it.
codraft only opens plain Markdown files. Your document stays as a regular .md file on disk, you can keep editing it in any other editor whenever you want.
Save your work
codraft autosaves every change while you write, you'll see "Saved" in the title bar settle a moment after you stop typing.
- For new documents, the first save asks you where to put the file (
⌘S). - For existing files, every keystroke is saved back in place.
- Use File → Save As… (
⌘⇧S) to fork the document to a new location.
You can also export to other formats (DOCX, PDF, HTML) when you're ready to share.
Next
- Connect your agent, point Claude Code (or your agent of choice) at codraft so you can co-author.
- Comment, and it acts, the core co-authoring move.