Margin 0.5.0

Margin 0.5.0 adds source-agnostic Markdown comparison and portable review threads for focused human–agent collaboration—without taking ownership of Git or introducing background services.

Highlights

• Compare any two explicit Markdown files in calm inline or aligned side-by-side views, with collapsed unchanged context, word-level emphasis, whitespace display, change navigation, swap, and refresh.
• Save a self-contained .marginreview artifact with immutable snapshots, threaded comments, actor provenance, resilient anchors, and forward-compatible extensions.
• Create, inspect, reply to, resolve, and reopen comparison comments from the margin compare CLI, including bounded JSON, standard input, paging, revision guards, and stable retry IDs for agents.
• Apply selected or all changes in either direction with stale-content checks, symlink refusal, atomic closed-file writes, annotation reanchoring, and one-step native undo for open editors.
• Keep ordinary launch behavior unchanged: comparison work is loaded only when explicitly requested. The release-candidate startup matrix passed for files through 5 MiB and directories through 10,000 entries.

Downloads

• Margin-0.5.0-macOS-arm64.pkg — installs the Mac app and CLI together.
• Margin-0.5.0-macOS-arm64.zip — portable Mac app and CLI.
• Margin-CLI-0.5.0-linux-x86_64.tar.gz — standalone Linux x86-64 CLI.
• Margin-CLI-0.5.0-linux-aarch64.tar.gz — standalone Linux ARM64 CLI.

Verify downloads with SHA256SUMS; GitHub build-provenance attestations are published for every release file.

macOS trust notice

The app executables are ad-hoc signed and the installer is unsigned for this release. macOS will require explicit approval in System Settings under Privacy & Security. Do not disable Gatekeeper globally. Developer ID signing and notarization are planned.

Full changelog: v0.4.1...v0.5.0

Margin 0.4.1

Margin 0.4.1 — quicker navigation and a better welcome back

Margin 0.4.1 makes everyday file work feel native and gives both humans and agents a clearer path for improving the tool.

Highlights

• Right-click files and folders in the navigator for Open, Rename…, Copy Path, Copy Full Path, and Reveal/Open in Finder.
• New windows show recently opened directories, sorted by recency, with full paths, copy controls, and “Last opened” dates.
• margin man now asks agents to notice bugs, unclear documentation, and missing features. margin man feedback progressively discloses privacy-conscious GitHub issue guidance and contribution links.
• Rename operations preflight affected open documents and remap open tabs and saved workspace paths together.
• Recent-folder loading stays off the first-paint path, preserving Margin’s fast launch behavior.

Navigator shortcuts

• Rename selected item: Return
• Copy workspace-relative path: Shift-Option-Command-C
• Copy full path: Option-Command-C
• Reveal in Finder: Option-Command-R

Install

• macOS: download Margin-0.4.1-macOS-arm64.pkg for the unified Margin app and CLI installer, or use the zip for a portable app bundle.
• Linux x86-64: download Margin-CLI-0.4.1-linux-x86_64.tar.gz.
• Linux ARM64: download Margin-CLI-0.4.1-linux-aarch64.tar.gz.

Verify downloads against SHA256SUMS. GitHub build-provenance attestations are available for every release asset.

Important macOS signing note

The app and executable are ad-hoc signed, the installer is unsigned, and this release is not notarized. macOS will require explicit per-app approval in System Settings. You do not need to disable Gatekeeper globally. Developer ID signing and notarization are planned.

See the repository README and Docs/INSTALLATION.md for complete installation and first-open instructions.

Verification

• All 208 native Swift tests pass, including the new recent-folder, context-menu, hotkey, rename-safety, and agent-feedback contracts.
• MarginBench passes all 249 package tests and all nine portable-binary reference episodes on both Linux architectures.
• Startup regression gates pass for small, medium, and large files and for 100-entry and 10,000-entry directories.
• Every release artifact was checksum-verified, archive-tested, and independently matched to its GitHub build-provenance attestation.

Full changelog: v0.4.0...v0.4.1

Margin 0.4.0

Margin 0.4.0 — first public release

Margin is a fast native Markdown editor for macOS with file-native comments and a standalone collaboration CLI for macOS and Linux. It is an independent open-source tool used by the OpenProse team; it is not the OpenProse product and is not required to use the OpenProse platform.

Highlights

• Native Apple-silicon Mac editor for literal Markdown, reader mode, inline discussion, review, suggestions, handoffs, and coordinated multi-file changes.
• One macOS installer containing both Margin.app and the margin CLI, plus a portable Mac archive.
• Standalone Linux CLI archives for x86-64 and ARM64; no Mac app or OpenProse account is required.
• Apache-2.0 source release with contributor, security, architecture, installation, CLI, performance, and release documentation.
• Optional MarginBench research tooling for deterministic human-agent and agent-agent collaboration evaluation.

Install

• macOS: download Margin-0.4.0-macOS-arm64.pkg for the unified installer, or the zip for a portable app bundle.
• Linux x86-64: download Margin-CLI-0.4.0-linux-x86_64.tar.gz.
• Linux ARM64: download Margin-CLI-0.4.0-linux-aarch64.tar.gz.

Verify downloads against SHA256SUMS. GitHub build-provenance attestations are available for every release asset.

Important macOS signing note

The app and executable are ad-hoc signed, the installer is unsigned, and this release is not notarized. macOS will require explicit per-app approval in System Settings. You do not need to disable Gatekeeper globally. Developer ID signing and notarization are planned.

See the repository README and Docs/INSTALLATION.md for complete installation and first-open instructions.

Verification

• All 172 native Swift tests pass.
• Both MarginBench Python environments pass all 156 tests, along with deterministic self-tests, neutral preflights, and tracked public-result audits.
• Release artifacts were checksum-verified and carry GitHub build-provenance attestations.
• Startup regression gates cover small, medium, and large files plus 100-entry and 10,000-entry directories. See Docs/PERFORMANCE.md for measured results and the guarantee boundary.

Full changelog: https://github.com/openprose/margin/commits/v0.4.0