PerMark v0.5.7

PerMark is a free, open-source Markdown app: read what your AI writes, write what it reads. It opens any .md
file as a clean page, keeps notes that save themselves, and turns a project folder into an IDE for following your
agents. It works with any AI tool, or none: it only relies on your files and git.

Review what an agent changed, send your comments to it, and keep a noisy folder quiet.

Added

• Silence a folder. Right-click a folder or a file and choose Silence. It stays in the tree, and it opens and edits, but its changes, unread marks and Git letters stay quiet. A folder inside it can Listen on its own, and that choice covers what is already there and what appears later. Listen brings the folder back as already read, so older changes do not all arrive at once. Search leaves silenced paths out until Include silenced is on. An agent's search and unread list are unchanged.
• Complete as you type, without AI. In Source, a link target offers files in the folder as a path from the current document, and after # the headings of that document. A word you have started offers words from the document and from file names. In Visual, the link box does the same for its target, and a word you have started offers those words beside the caret. Enter or Tab accepts; Esc closes.
• Projects. A Projects button at the top of the activity bar lists recent folders and offers New project, Open folder and Close folder. New project adds a .permark folder to the folder you pick. Opening a folder, a recent folder, a new project, or a folder from the Explorer's menu asks whether it opens in this window or in a new one.
• Broken links. A Broken links panel lists every link in the project whose file does not exist. When one file with that name exists somewhere else, Repair points the link at it. When several do, you pick which one.
• See a Mermaid diagram while you edit its text. In Source, with the caret in a Mermaid block, the drawing sits beside the text and updates as you type. A text Mermaid cannot draw yet keeps the last drawing of that block and says so. Dragging nodes is not part of this.
• Review what changed since you last read a document. A quiet bar names how many blocks changed. Review shows each one in the reading view, and Keep or Revert accepts it or writes the old text back. Your own edits are already approved, and a change is not written if the file moved on while you were looking.
• Send comments to your agent. In the Comments tab, Send to agent on a comment, or Send all at the top, copies a prompt with the document, the section, the lines, the quoted passage and your words. Paste it into any agent chat. The prompt asks the agent to mark each comment done with a short reply. get_context, permark context and the state file say how many comments are open, so an agent that reads where you are knows to look.

Changed

• 简体中文 wording is tighter in a few places (the tagline, a few hints and the Git legend), following a native speaker's review.

Install

Platform	Download
Windows	the -setup.exe installer (or the .msi)
macOS	the universal .dmg (Apple silicon and Intel)
Linux	the .AppImage, .deb or .rpm

PerMark updates itself: when a new version is out, it offers a one-click "Restart to update".

The app is not code-signed yet

The installers are unsigned, so your system warns you the first time. They are built by GitHub Actions
from the tagged commit, and the in-app updates are verified with a signature.

Windows (SmartScreen). If you see "Windows protected your PC", click More info, then Run anyway.

macOS (Gatekeeper). If macOS says it can't verify PerMark, open System Settings, Privacy & Security,
scroll to the Security section and click Open Anyway. On older macOS versions you can right-click the
app and choose Open instead. From a terminal: xattr -dr com.apple.quarantine /Applications/PerMark.app.

Linux. Make the AppImage executable (chmod +x PerMark_*.AppImage) and run it, or install the .deb / .rpm.