PerMark v0.7.1

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

Added

• Seven more interface languages: 日本語 (Japanese), 한국어 (Korean), Français (French), Português (Portugal) (European Portuguese), Català (Catalan), Galego (Galician) and Română (Romanian). Settings > Language lists them, and System default picks each one for its system languages (ja-JP, ko-KR, fr-CA, ca-ES-valencia and the others); Portuguese outside Brazil (pt-PT, pt-AO, pt-MZ...) now picks European Portuguese, while pt-BR and a bare pt keep Brazilian Portuguese. The Windows installer offers them, the right-click entries in the file manager are worded in them (for example "PerMark で開く", "PerMark로 열기", "Ouvrir avec PerMark"), and the Microsoft Store package declares them. In Japanese and Korean, the interface uses Japanese and Korean fonts (Yu Gothic UI, Meiryo UI or Hiragino Sans; Malgun Gothic or Apple SD Gothic Neo) instead of Chinese letter shapes. Romanian counts use its three plural forms ("1 fișier", "2 fișiere", "20 de fișiere"). Thanks to @kelvin-mariano for the translations, the installer and file manager wording, and the Japanese and Korean fonts (#61; Japanese and Korean were asked for in #23).

Changed

• Text is no longer masked: PerMark shows every value as written, in the reading view, in config sheets, in reviews and in the converter, and AI agents read it as written too. Key files such as *.pem, id_rsa or .netrc are no longer hidden from agents by their name either. To keep a file away from agents, list it in .aiignore, as before.

Fixed

• In a folder that includes other projects, what you do right after opening it (adding a tag, moving a file) is now also kept in that project's own record of your actions, which it shows when you open the project on its own. Before, actions in the first moments after opening could be missing there.
• The count next to Broken links is now the opened folder's own, and it shows only once PerMark has looked through all the documents. Before, it also counted the broken links of the git worktrees linked to the folder, so a folder with only a few broken links could show thousands, and the worktrees' links could push the folder's own off the list. When a linked worktree has broken links too, the tab now shows them apart: This folder first, then a section for each worktree (Linked worktree and its name), each with its count. A folder without linked worktrees looks as before. Thanks to @pkyes54 for the report (#62).
• When PerMark can't read some of the data it saved (for example because another program has the file open at that moment), it now tries again for a moment, then leaves the file as it is and doesn't write over it until it can read it again, usually after a restart. Before, it went on with empty defaults and could save them over that data, so the windows and tabs from last time, or other things it remembered, could be lost for good. When this happens to the windows and tabs from last time, a quiet note names the file.
• Web pictures are now only fetched from public internet addresses.
• A hand-off no longer names, to an AI agent, files that were hidden from agents after the hand-off was made; it counts them among the hidden ones instead.

Install

Platform	Download
Windows	the -setup.exe installer (recommended). The .msi stays for updating copies that were installed from a 0.5 .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.

PerMark v0.7.0

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

Added

• Projects inside a folder. When a folder you open holds other projects (folders with their own git repository or their own PerMark settings), a quiet note under the file list says so once and offers to include them, to choose, or No thanks; a short message with Undo follows your answer and then closes by itself. Included projects are followed from that folder: their changes and unread documents show there, and the file list marks each one with a project icon next to its folder name (and its short name when that is different). Resting the pointer on it, or choosing Project details in its menu, shows a small card about it. The new Settings > Projects inside lists every project found, included or not, with a filter, buttons to include or leave out all the projects listed, and for each included project its details and rules: hidden files, the agent, notifications, and its name and description. Projects that went missing can be located again or removed from the list, with Undo. When new projects appear, the note says where they are; when the folder's project list can't be read, the note says so and shows you the problem. The Changes panel says which project a change belongs to and lists projects that appear, move or go away (a project that went missing opens its place in Settings), and the Search panel can look in the whole folder or only in the project of the open document, and its search box says which. Before you answer, the note and the Choose page say that the list is saved in the folder (.permark/projects.toml), so it travels with it; a project's name and description are saved in that project's own .permark/project.toml, as the fields say. A folder without projects looks exactly as before, and a folder opens as fast with a long project list as without one: PerMark reads the projects right after the folder shows.
• Git for each project inside a folder. An included project with its own git repository now keeps its own git status in the folder that includes it: its changed files belong to that project, no longer to the outer folder, and comparing one of its documents with "the last commit" uses the project's own repository. PerMark reads each project's branch from its files at once and asks git about changes only when they matter (the project's files change, or you look at the project), a few projects at a time, so a folder with dozens of projects stays fast. PerMark also notes each project's first commit in the folder's project list, so a project you moved or renamed while PerMark was closed is found again the next time you open the folder: PerMark asks you first, naming the folder it found ("Is tools/new-app the project hub-x that was at hubs/hub-x?"), because copies of a repository look the same to it, then says what it did and puts you on that folder in the file list. A copy you said no to is never offered as the moved project, and when you answer that a folder is a new project, PerMark remembers it and does not ask again, also after a restart. In the file list, each such project shows its branch in gray after its name, with a small branch mark so it reads apart from the project's own short name, also before the project's first commit (or what git is doing there, such as REBASING, which is never cut short, or, when it is not on a branch, the commit it is at with a commit mark, its meaning in the tooltip), a warning mark when git can't read the project, and an open project marks its changed files as the outer folder's files are marked; in a narrow sidebar the branch steps aside. Its card adds the branch, the changes to send and to get as of the last fetch (↑ ↓), how many files changed and its last commit ("No commits yet" in a new repository), and a screen reader hears these when the card opens. Wherever a label such as MERGING or REBASING appears, its tooltip and screen readers say what it means in plain words, such as "A merge was started in git and isn't finished yet." Settings > Projects inside shows the branch and the number of changed files on each row ("Checking git…" while PerMark is still asking), and the status bar follows the project of the document you are reading, with the project's short name before its branch; choosing "Changes since: the last commit" there applies to that project's files too. When git is not available, no branch is shown anywhere and Settings says so once.
• Each project keeps its own reading state. In a folder that includes other projects, what you have read, your comments, the tags and descriptions you add, the folders you silence and the record of what you did now belong to the project the file is in. They are saved where that project keeps its own PerMark data: its .permark/ folder when it has one, otherwise your profile. So you see the same unread documents, comments and silenced folders whether you open the project on its own or from the folder that includes it, and the same tags you add from now on. What the folder already knew about a project's files (what you read, comments, silenced folders) is copied into that project's private data the first time you open the folder with this version or include the project; the project's own entries win, and the folder's own copy stays as it was, ready again if you leave the project out. Something added in the folder while a project was left out, such as a new comment, is copied too when you include the project again, and something you removed inside the project does not come back. Tags and descriptions the folder already kept for a project's files stay in the folder's own .permark/meta.toml and still show there; PerMark does not write them into the project's shared files. A folder silenced in the outer folder stays silenced inside its projects unless a project says otherwise. When a project without a .permark/ folder moves, its saved state moves with it. A folder can now also name its official tags and project categories, with their colors and icons, in .permark/vocabulary.toml. Where it does, every tag in the Tags tab, the tag editor and the tags under a document's title carries a small mark that says whether it is official, local to one project, or unlisted (found only in files); the shape of the mark and its words say it, not only its color, and the Tags tab explains the three marks at its top and also lists the official tags no file uses yet. A local or unlisted tag can be made official with the "Make official" button on its row or in its color and icon menu: PerMark first says what this does and which file it writes, and does nothing until you confirm. A project's category is offered from the official list as you type (the official names are also written under the field; any other name is kept as you write it), shows the same mark, and can be made official the same way. Settings > Projects inside lists the official tags and categories: you can add one (with Undo), rename one, remove one (PerMark asks first) or change its color and icon, and the color and icon menu of an official tag leads there. PerMark changes only that entry of the file; the tags written in your documents and the categories of your projects stay as they are. Each included project's details say how many of its own tags count as local. A project's card now also counts its open comments next to its unread documents, and each count opens the Unread or Comments tab showing only that project. Tags written at the top of documents (front matter) now come from the same background reading as search, so PerMark no longer reads a large folder twice for them, and they show at once the next time you open it.
• The right panel can show its views one above the other or as tabs. The outline and Live changes share the right panel, one above the other by default, with a line between them that you can drag (or move with the arrow keys) to give one more room. Each view has a ⋯ menu to move it up or down, show it as a tab next to the other, close it, or reset the layout; "Reset the right panel layout" is also in the command list. Your layout is the same in every folder; which views are open is kept for each folder. When a document has no headings, Live changes takes the whole height. With only one view, the panel looks as before.
• In the outline, a small dot now marks each section that just changed: while an agent writes, and while you review the changes in a document. Screen readers hear "changed" with the heading.
• The file list's menu now also opens from the keyboard, with Shift+F10 or the Menu key, at the row you are on.
• Go to a recent place... in the command palette lists the last 30 places you visited in this window, newest first, the same list as the menu of the Back and Forward buttons. Type a few letters to narrow it, and press Enter to go back to that place.
• In the Notes tab, Ctrl+Shift+S moves the note you have open to a project (Move to project...), like "Save as" in other apps. Outside the Notes tab the key does nothing.
• The status bar now says Live: off when the folder you opened can't report its changes (for example when the system ran out of watches), so PerMark can't follow them as they happen. On Windows, WSL folders (such as \\wsl.localhost\...) now always say so, instead of silently showing no new changes; network shares and mapped network drives keep following changes live. It shows on the Live button itself when that button is there. Click it, or press Enter on it, to read why and what to do; the Live changes panel says it too, and screen readers hear it when it happens.
• Search results now show the same marks as the file list: the unread dot and the git letter, with their meani...

PerMark v0.6.4

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

Fixed

• PerMark no longer closes when a document holds an HTML block with accented letters, Chinese text, emoji or other non-English characters; before, opening such a folder could quit the app while it looked for broken links. Thanks to @pkyes54 for the report and the fix.

Install

Platform	Download
Windows	the -setup.exe installer (recommended). The .msi stays for updating copies that were installed from a 0.5 .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.

PerMark v0.6.3

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

Fixed

• Right after a project opens, an agent's search now finds the keys of configuration files too; before, it could miss them for a moment while saying the answer was complete.
• When two projects copy files in at the same time, each progress card now shows only its own project's copy; before, the cards could mix both.
• A document that changes in a tab you are not looking at stays unread, and its changes stay offered for review, until you go to that tab and read it. Before, it could be marked as read while it was hidden behind another tab.
• When you switch tabs while PerMark is still preparing the question for files you dropped, your keys stay in the tab you switched to; the question waits in its own tab.
• A Notes tab behind another tab no longer checks for new notes every few seconds; it looks again when you come back to it.

Known limits

• Tabs, moving a tab to another window and dropping files have not been tested on macOS yet. There, the arrow keys in text fields may not work as expected; a fix is planned.

Install

Platform	Download
Windows	the -setup.exe installer (recommended). The .msi stays for updating copies that were installed from a 0.5 .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.

PerMark v0.6.2

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

Added

• Notes button. A button next to Settings opens your Notes in a tab with one click, or brings you to the Notes tab if it is already open. Ctrl+Shift+D does the same, and Ctrl+Shift+N makes a new note from anywhere.
• Drop files from outside, anywhere. Drag files or folders from your file manager onto the file list and the folder under the pointer lights up; when you let go, a small question at that spot asks Copy here, Move here or Cancel, and lists names that already exist (Keep both or Skip). Drop them anywhere else in the window, the start screen included, and each one opens as a tab; more than 8 ask first. Text files dropped on the Notes tab (Markdown, plain text, settings and data files such as YAML, JSON or CSV, and files like README) become loose files there, and pictures dropped on a document you are editing go into it. A label next to the pointer always says what the drop will do, in place of the dashed frame that covered the window, and folders you rest on open by themselves. Undo in the notice takes back exactly that drop, even after other changes, as long as those files were not touched since.
• Hide and show the side bars. Ctrl+B hides or shows the sidebar and Ctrl+Alt+B the right panel, as in earlier versions; a button at each end of the status bar does the same. Each project remembers which side bars you hid.
• Move a tab to another window. Right-click a tab and choose Move to window to move it into another open window; the list shows each window by the tab it is showing and how many tabs it has. Unsaved changes move with the tab. Moving a window's last tab closes the window it leaves.

Changed

• Every plugin is now on from the start, Token count and the Converter included, so you no longer need to turn them on in the Plugins page. A plugin you turned off yourself stays off. Token count still asks before it downloads a tokenizer's vocabulary, and nothing is downloaded when PerMark starts. The agent connection stays off until you turn it on for a project.
• Ctrl+B makes text bold in the source editor too, as it already did in the visual editor.
• The outline button always shows the outline, even when another panel was open on the right.
• In the Notes tab, Ctrl+1 to Ctrl+9 open your pinned notes (instead of switching tabs), Ctrl+N makes a new note and Ctrl+Shift+C copies the note. Use Ctrl+Tab or the tabs to switch tabs from there. The keyboard shortcuts list no longer reports these keys as shared, but it does warn when a key you choose is already used where the same command could run.

Fixed

• Clicking a note on the start screen, or "New note", now reaches the Notes tab even when it is open in another window.
• When another program saves .permark/meta.toml at the same moment PerMark writes your tags or descriptions there, PerMark no longer writes over that program's version: it reads it first and then adds your change.
• Files you add, copy or move in a project now appear in its file list right away, also while another open project is changing; before, they could stay out of the list until it was reloaded.

Known limits

• Tabs, moving a tab to another window and dropping files have not been tested on macOS yet. There, the arrow keys in text fields may not work as expected; a fix is planned.

Install

Platform	Download
Windows	the -setup.exe installer (recommended). The .msi stays for updating copies that were installed from a 0.5 .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.

PerMark v0.6.1

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

Added

• Tabs. Each folder or file you open gets a tab in the bar at the top of its window, and Notes open in a tab too. Click a tab to switch to it; Ctrl+Tab and Ctrl+Shift+Tab (or Ctrl+Alt+→ and Ctrl+Alt+←) go to the next and previous tab, Ctrl+1 to Ctrl+8 to a tab, Ctrl+9 to the last one, and Ctrl+W closes the tab. A tab with unsaved changes shows a dot. Right-click a tab to move it to a new window. When PerMark starts, your windows and tabs come back, and only the tab you see loads, so the start stays fast.

Changed

• A folder or file opens in one place only: if it is open already, its window and tab come forward. Settings → Editing → Open folders and files in offers New tab (the default), This tab and New window; the old "Ask" choice now means New tab, and the question dialog is gone.
• Opening from outside PerMark (a double-click, the command line) adds a tab to the window you used last.
• Closing a window with unsaved changes asks once for all its tabs: Save all, Discard or Cancel.
• The windows of 0.6.0 come back as tabs: each window keeps its folder or file as one tab, and a project that was open in two windows comes back once.

Fixed

• Windows come back where you left them, also when PerMark starts from a file you open. A new window opens slightly offset from the current one, at the same size, and a maximized window stays maximized. The first start after 0.5 takes the window place 0.5 saved.
• The document header no longer covers the outline or the live feed in a narrow window. When space runs short, less used buttons move into the "…" menu, and in a very narrow window the mode buttons show as icons.
• The scrollbar of a document is always visible and wider, so it is easier to grab.
• The buttons of the side bar (such as Broken links and Tags) always appear in the same order.

Known limits

• Tabs have not been tested on macOS yet. There, the arrow keys in text fields may not work as expected; a fix is planned.

Install

Platform	Download
Windows	the -setup.exe installer (recommended). The .msi stays for updating copies that were installed from a 0.5 .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.

PerMark v0.6.0

PerMark is a free, open-source unified document workspace: one place to read, write and organize Markdown and
the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it.
It works with any AI tool, or none: it only relies on your files and git.

PerMark is now a unified document workspace: one place to read, write and organize Markdown and the files around it, and to steer AI projects through their documents. AI speeds the work. Your vision steers it. This release rebuilds the whole program: many windows in one app, small config files and TOON as clean sheets, review of code and text files, and an agent connection with 13 tools. The name, the logo, your files and your notes stay where they were.

Upgrading from 0.5

PerMark 0.6 never changes your files to upgrade. It reads what 0.5 saved and copies it once; 0.5's own data stays where it was.

• Carried over: your notes folder and how notes are named, with the notes you pinned or shared and the files you opened in Notes; tags and descriptions; comments, including the ones you marked done; the folders you silenced; and your language and external editor. Projects that have a .permark/ folder keep their tags, settings and comments in it, as before.
• Not carried over: the text you typed into a file opened in Notes and had not saved (it stays on disk in the notes folder's .permark/pending/, untouched), which documents you had read or reviewed (every document starts as read), the recent folders list, window places, the earlier versions of your notes (new versions start now), the on-off switch of the agent connection (it starts off in every project: turn it on again where you want it), and the rest of the app settings (look at Settings once). Your files are never touched.
• Setting up again: the file a script can read for the open document is now .permark/local/agent-context.json (it was agent.json).
• Old TrailMark folders: 0.6 no longer renames .trailmark/ folders. If you still have TrailMark, update to 0.5.8 first.
• Going back: 0.5.8 cannot read the comments file after you mark a comment done in 0.6.

Added

• Many windows, one app. A bar at the top lists the open projects, files and Notes, switches between them (Ctrl+Alt+→ and Ctrl+Alt+←) and closes them with the x. The + menu opens a folder or a file, starts a new project, opens Notes or picks a recent folder.
• A full Settings page, a Plugins page and your own keys. Turn features on and off in Settings → Plugins; a feature that is off leaves nothing behind. Settings → Keyboard shortcuts shows every command, lets you change its key and warns when two commands share one.
• Small config files as clean sheets. TOML, YAML, INI, .env, .properties and ignore files (.gitignore, .aiignore and the like) open as sections, keys and values, with comments as captions. Editing a value changes only those bytes: comments, order and spacing stay. A part that cannot be edited exactly stays read-only, and Source is always there. Secret values (keys, tokens, passwords) are masked in the sheet.
• TOON. .toon files, the compact data format made for AI, open as tables and cards and can be edited in place. A toon block inside Markdown draws the same way.
• Review code and plain text. What an agent changed in a code file, a log or a data file shows line by line, and you keep or revert each change, as you do in Markdown. Lines that change while you watch glow. Very large text files open at once, the first part first.
• Next and previous change. F7 and Shift+F7 go to the next or previous change of the open document: the changes you have not reviewed yet, or the passages that are glowing.
• Focus mode (Ctrl+Alt+F) leaves only the page.
• Drop files into a project. Files and folders dragged in from the file manager come into the project, into the folder under the pointer. You choose copy or move, names that already exist are listed first, and one Undo takes it all back.
• Source is the raw file. Every byte as it is: nothing hidden, masked or drawn over it. It has find and replace (Ctrl+F, Ctrl+H) and go to line (Ctrl+G). A switch beside the modes shows a Mermaid or PlantUML drawing next to the text while you type (off until you turn it on).
• Web pictures on request. A picture from a web address shows as a chip with its description; a click loads that picture. In the document menu, Load web pictures in this project loads them by themselves for that project.
• Token count (off until you turn it on): how many tokens a document, a section or a folder takes. Exact for OpenAI's tokenizers (it asks before it downloads the small vocabulary), marked as approximate for Claude and Gemini.
• Converter (off until you turn it on): turns JSON, XML, YAML, CSV and TOML into TOON or another compact format (or into a readable one), shows the estimated token saving of each choice, and never writes over the original.
• Markdown of the AI era is recognized with no setup: agent files such as AGENTS.md, CLAUDE.md and SKILL.md, Cursor rules (.mdc), llms.txt, prompt files, and model and dataset cards (told by their front matter).
• A bigger agent connection. It now has 13 tools, with short answers an agent spends few tokens on. New: map (the project's files with sizes, tags and descriptions), outline (the parts of a file before reading it, optionally with the links in and out), read (one part of a file), and activity (what you did since the last hand-off). search takes a token budget. Permissions are set by group, per project, and a project's .permark/ can only narrow them. Files in .aiignore and private key files never reach an agent, and secret values are always masked. Hand off to agent copies one line for your prompt so the agent asks what you did instead of rereading the project. An agent still only reads, shows you a place and marks comments done; it never edits a file through PerMark.
• List indent and outdent buttons in the Edit toolbar.
• Choose a picture. The picture button in Edit opens the system file dialog; the pictures are saved next to the document.
• The interface speaks six languages: English, Português (Brasil), Español, Deutsch, 简体中文 and Italiano.

Changed

• One program for every window. Opening a second project no longer starts a second copy of PerMark.
• View, Edit and Source. The header switch is View for the rendered document, Edit for changing it, and Source for the file's text. The shortcuts stay Ctrl+E and Ctrl+Alt+E.
• Delete in the Explorer goes to the system trash at once, without asking. Ctrl+Z brings it back (on macOS the app cannot take a file out of the Trash).
• Heading levels are easier to tell apart, in reading and in Edit, and heading shortcuts (Ctrl+Shift+1 to 6) work on every keyboard layout.
• Git. PerMark uses the git installed on your computer, or its own built-in git when there is none. It still only reads git: it never commits, stages or creates a repository.
• Choosing PerMark for Markdown files is your decision: the installer asks (Markdown types checked, the others not), and on Windows it takes you to the Windows page where you pick the default app.
• Quick open searches all files that are not ignored; hidden ones (names that start with a dot) come after the others unless the Explorer shows them. The tag filter moved to the Tags scope of Search everywhere.
• "Since your last visit" compares the content of your documents, not file dates, and works without git.
• Follow mode waits while you are editing.
• Notes keep the 0.5 folder and file names. The newest 50 earlier versions of a note are kept, and a note you were typing is recovered after a crash.
• Updates check once a day, and a restart to update is refused while you have unsaved files, with a list of them.
• Code blocks in Edit take the language as text. Descriptions can be 160 characters.
• Pictures you paste or drop are saved next to the document.

Removed

• The setting that chose between reloading a changed file by itself or asking: a file you have not edited reloads, and one with your edits asks.
• The Explorer's Show only unread filter (the Unread tab lists the documents), the Outline's popover and its marks for changed sections.
• The table toolbar's Add row above and Add column to the left (below and to the right remain).
• Follow mode's pause while you scroll.
• The disabled Semantic switch in the search panel.
• The conversion of old .trailmark/ folders (see Upgrading).

Fixed

• The headings of a document looked alike from level 2 on; each level now has its own look.
• A nested list item could not be moved out a level from the toolbar.

Known limits

• PerMark 0.6 was tested on Windows. The macOS and Linux versions are built and checked by the project's CI and have not been tested by hand yet.
• The installers are not code-signed, so your system warns you the first time.
• The .msi installer does not add the Open with entries and its uninstall leaves them; use the -setup.exe. The .msi stays for updating copies installed from a 0.5 .msi.
• A window with a single file does not follow links to other documents.
• Find in page misses a match that runs across two styles (**bold** and plain text together).
• Edit mode does not draw pictures that are files next to the document (View and Source do).
• When a file changes while you edit it, the conflict choice is for the whole document, not change by change.
• The search panel does not refresh by itself when files change: search again.
• When live updates stop working (the system ran out of watches), PerMark does not tell you.
• A git worktree added while a project is open, and a .permark/ folder made outside the app, show up after you reopen the project. Tags ...

PerMark v0.5.8

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.

Draw a PlantUML diagram in the page, start a new file from a folder, and keep a wide block inside the pane.

Added

• PlantUML diagrams. A plantuml or puml block draws in the reading view, the same way a Mermaid block does. In Visual the source stays, with a live preview beside it. No Java and no PlantUML server. A diagram that would fetch a file does not run.
• New file. Right-click a folder, or the project name, and choose New Markdown file or New text file. The same two entries are in the Projects menu and in the Explorer menu. A text file opens in Source. On Windows, right-click a folder or its background and choose New Markdown file with PerMark: the folder opens with untitled.md in it.
• A note's path. From a note or a loose file, Copy path puts its path on the clipboard, and Show in file manager selects the file. Copy stays available while the path is known. A file that is missing is not shown.

Fixed

• Heading shortcuts in Visual. Ctrl+Alt with a number is the AltGr key on Windows, so those chords typed a character instead of changing the block. Paragraph and headings 1 to 6 are Ctrl+Shift+0 through Ctrl+Shift+6.
• A wide block stays inside the pane. Prose wraps in the column. A long table row or a diagram line scrolls inside its block, instead of growing the page past the window.

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.

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.

PerMark v0.5.6

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.

TrailMark is now PerMark. Same app, same logo, a name of its own.

Changed

• New name: PerMark. The app, its command (permark, permark mcp, permark context), its MCP server and the project folder
  (.permark/) take the new name. Nothing is lost on the way: an existing .trailmark/ folder becomes .permark/ the first time
  PerMark opens the project, and your settings, recent folders and notes carry over. If an agent is set up with the old
  trailmark command, run the setup lines from Settings → Agent connection again.

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.