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

  1. Download codraft from your account portal.
  2. Open the .dmg file.
  3. Drag codraft.app to your Applications folder.
  4. 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 .md file 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.md in 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