SwiftAsyst

A WYSIWYG Markdown editor for VS Code that turns your AI agent into a document editing assistant. Write and edit documents in a clean, rendered view while your AI agent (GitHub Copilot, Cursor, or any tool that edits files) handles the heavy lifting.

How It Works

1. Open any .md file and reopen it with "SwiftAsyst" (right-click tab → Reopen Editor With...).
2. Ask your AI agent to edit the document — via Copilot Agent Mode, Cursor Composer, or any tool that writes to files.
3. The editor detects external changes and shows a clean block-level diff: old paragraphs in red, new paragraphs in green.
4. Accept or reject each change individually, or use Accept All / Reject All.

The extension never calls an AI model itself. It's purely a rendering and review layer on top of whatever agent you already use.

Features

• WYSIWYG rendering — see your Markdown as a formatted document, not raw syntax
• Block-level diffs — clear red/green blocks with per-change Accept/Reject buttons
• Live preview — the rendered view updates in real-time as the agent edits
• Mermaid diagrams — fenced mermaid code blocks render as interactive diagrams
• Copilot integration — auto-dismisses Copilot's native review overlay so the extension handles all review
• Zero dependencies — lightweight, fast, no external packages

Supported AI Agents

• GitHub Copilot (Agent Mode recommended)
• Cursor (Composer or Agent Mode)
• Any tool that edits .md files directly

Getting Started

1. Install the extension from the VS Code Marketplace.
2. Open a Markdown file.
3. Right-click the editor tab → "Reopen Editor With..." → "SwiftAsyst".
4. Start prompting your AI agent to edit the document.

Requirements

• VS Code 1.93 or later
• An AI coding agent (GitHub Copilot, Cursor, etc.) for the editing workflow

Tips

• For best results, configure your agent to auto-apply edits so this extension is the sole review layer.
• In Copilot, use Agent Mode (not Edit Mode) for autonomous multi-step document editing.
• The diff review appears after 800ms of silence, so rapid agent edits are batched together.
• Click Manual Test in the toolbar to test the diff viewer without any AI agent.