v0.8.0

Scratch v0.8.0

What's New

Syntax Highlighting & Mermaid Diagrams

• Code blocks now feature syntax highlighting for 20 languages with a GitHub-inspired color scheme
• Select a language from the dropdown or type it after the opening backticks
• Mermaid diagram blocks render live SVG previews with an Edit/Preview toggle
• Diagrams automatically inherit your app's theme colors

KaTeX Math Support

• Write LaTeX math expressions with full KaTeX rendering
• Use $$...$$ for display-style block equations
• Click any rendered expression to edit it in a popup editor

Ollama AI Editing

• Added Ollama as an AI editing provider alongside Claude and Codex
• Run local LLMs for AI-assisted editing without sending data to the cloud
• Select your preferred Ollama model directly from the command palette

Drag-to-Resize Editor Width

• Drag the editor margins to resize the page width in real time
• Your preferred width is saved per session

Save Previewed Notes to Folder

• When you open a note in preview mode (e.g. drag a file in or use "Open With Scratch"), you now have an option to save it to your notes folder

Bug Fixes

• Fixed console window flash on Windows — git and CLI commands no longer briefly show a console window
• Fixed double-window issue on Windows — app no longer opens two windows on startup
• Fixed close window shortcut on Windows — Ctrl+W now correctly closes the window
• Fixed hidden filenames — notes starting with . are now handled correctly
• Fixed mise path resolution — improved PATH detection for mise-managed tool installations
• Improved security practices across the codebase

Installation

Download DMG (macOS)

1. Download Scratch_0.8.0_universal.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Windows
Download Scratch_0.8.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.8.0_amd64.AppImage or Scratch_0.8.0_amd64.deb below.

Requirements

• macOS 10.15+ (Universal binary — Intel and Apple Silicon)
• Windows 10/11
• Linux (Ubuntu 22.04+ or equivalent)

Contributors

Thanks to everyone who contributed to this release:

• @eeee0717 — KaTeX math support, hidden filenames fix
• @blksmr — Drag-to-resize editor width
• @DevDengChao — Close window shortcut, double-window fix on Windows
• @cpenned — Security improvements
• @wdonsong — mise path resolution fix

Scratch v0.7.1

Scratch v0.7.1

What's New

Wikilinks

• Type [[ to link between notes with autocomplete suggestions
• Click a wikilink to navigate to the target note
• Also added wikilinks to the toolbar and '/' menu

Git Pull & Multi-Device Sync

• Pull remote changes with a sync button in the footer
• Badge shows available commits to pull
• Background polling (60s) detects new remote commits
• Error handling for merge conflicts, auth failures, and diverged branches

Interface Zoom

• Zoom the entire interface from 70% to 150%
• Keyboard shortcuts: Cmd+= (zoom in), Cmd+- (zoom out), Cmd+0 (reset)
• Zoom controls also available in Settings > Appearance > Typography
• Zoom level persisted per-folder

Bug Fixes

• Fixed editor find shortcut (Cmd+F) focus behavior — repeated presses now reliably focus the search input
• Fixed local image display on Windows by adding notes folder to the Tauri asset protocol scope
• Fixed settings page scrollbar layout shift

Installation

Download DMG (macOS)

1. Download Scratch_0.7.1_universal.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Windows
Download Scratch_0.7.1_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.7.1_amd64.AppImage or Scratch_0.7.1_amd64.deb below.

Requirements

• macOS 10.15+ (Universal binary — Intel and Apple Silicon)
• Windows 10/11
• Linux (Ubuntu 22.04+ or equivalent)

Contributors

Thanks to everyone who contributed to this release:

• @blksmr — Wikilinks, interface zoom
• @aleksAperans — Git pull & multi-device sync
• @eeee0717 — Editor find shortcut fix, settings scrollbar fix

Scratch v0.7.0

Scratch v0.7.0

What's New

OpenAI Codex CLI Support

• Edit notes with OpenAI Codex as an alternative to Claude Code CLI
• Choose between Claude and Codex from the AI edit modal or command palette
• Great for ChatGPT subscribers who want AI-assisted editing

Native Print & Export

• Print as PDF using native window.print() for high-quality, text-selectable PDFs
• Export Markdown files directly from the export menu or command palette

Customizable Note Names

• New defaultNoteName setting with template tag support
• Supported tags: {date}, {time}, {year}, {month}, {day}, {random}, {counter}

"Open Notes Folder" Command

• Added "Open Notes Folder" to the command palette (Cmd+P)

Bug Fixes

• Fixed "Open Folder" in settings to navigate into the notes directory instead of selecting it in the parent
• Fixed Claude CLI flags — updated deprecated --permission-mode bypassPermissions to --dangerously-skip-permissions
• Fixed CLI path resolution to prioritize native installs over npm-installed versions

Installation

Download DMG (macOS)

1. Download Scratch_0.7.0_universal.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Windows
Download Scratch_0.7.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.7.0_amd64.AppImage or Scratch_0.7.0_amd64.deb below.

Requirements

• macOS 10.15+ (Universal binary — Intel and Apple Silicon)
• Windows 10/11
• Linux (Ubuntu 22.04+ or equivalent)

Contributors

Thanks to everyone who contributed to this release:

• @omaredu — Codex CLI support
• @cpenned — Claude CLI flag and path resolution fixes

Scratch v0.6.0

Scratch v0.6.0

What's New

Single-File Preview Mode

• Open any .md file in a lightweight preview window — no notes folder needed
• Great for quickly viewing or editing standalone markdown files

Drag-and-Drop

• Drag a .md file onto the Scratch window to open it in preview mode
• Files inside your notes folder automatically open in folder mode instead

"Open With" / File Associations

• Scratch registers as a handler for .md and .markdown files
• Right-click any markdown file in Finder → Open With → Scratch

Copy Filepath

• Right-click a note in the sidebar to copy its absolute filepath to the clipboard
• Handy for pasting into terminal or AI tools

Bug Fixes

• Fixed plain-text copy/export producing excessive blank lines between list items and blocks — plain text is now cleanly normalized from the markdown source

Installation

Download DMG (macOS)

1. Download Scratch_0.6.0_universal.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Windows
Download Scratch_0.6.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.6.0_amd64.AppImage or Scratch_0.6.0_amd64.deb below.

Requirements

• macOS 10.15+ (Universal binary — Intel and Apple Silicon)
• Windows 10/11
• Linux (Ubuntu 22.04+ or equivalent)

Contributors

Thanks to everyone who contributed to this release:

• @farhaduneci — plain-text copy spacing fix

Scratch v0.5.1

What's New

Patch release to fix auto-updater artifact generation. No functional changes from v0.5.0.

If you're coming from v0.4.0, see the v0.5.0 release notes for all new features.

Bug Fixes

• Fixed auto-updater not generating latest.json and signature files in CI builds
• Synced version across all manifest files (Cargo.toml, package-lock.json)

Scratch v0.5.0

Scratch v0.5.0 — Slash Commands, Focus Mode & Cross-Platform Builds

What's New

Slash Commands

• Type / in the editor to quickly insert headings, lists, code blocks, tables, and more
• Popup menu with search filtering

Focus Mode

• Distraction-free writing with Cmd+Shift+Enter
• Hides the sidebar and centers the editor with smooth animated transitions

Markdown Source Mode

• Toggle raw markdown view with Cmd+Shift+M
• Edit markdown directly and switch back to rich text seamlessly

Page Width & RTL Support

• Configurable page width: narrow, normal, wide, or full (Settings > Appearance)
• Right-to-left text direction support

Subfolder Support

• Notes in subfolders are now discovered automatically
• Displayed in a flat list within Scratch

CI/CD & Cross-Platform Builds

• Automated release pipeline with GitHub Actions
• Builds for macOS (universal), Windows (NSIS installer), and Linux (AppImage/deb)
• macOS builds are code-signed and notarized

Bug Fixes

• Fixed YAML frontmatter handling in the markdown parser
• Fixed note duplication on rename and file watcher double-refresh

Installation

Download DMG (macOS)

1. Download Scratch_0.5.0_universal.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Windows
Download Scratch_0.5.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.5.0_amd64.AppImage or Scratch_0.5.0_amd64.deb below.

Requirements

• macOS 10.15+ (Universal binary — Intel and Apple Silicon)
• Windows 10/11
• Linux (Ubuntu 22.04+ or equivalent)

Contributors

Thanks to everyone who contributed to this release:

• @bdsqqq — subfolder discovery & YAML frontmatter fix
• @alexeira — search improvements
• @imrofayel — CI/CD workflow proposal

v0.4.0

Scratch v0.4.0 — Table Editing, AI Editing & Windows Support

What's New

Table Editing

• Insert tables via grid picker (5×5 selector) in the toolbar
• Right-click context menu for table operations: add/delete rows and columns, toggle headers, delete table
• Bordered scrollable container for wide tables
• Block-level images with proper paragraph spacing

AI Editing with Claude Code

• Edit notes with Claude Code CLI directly from the command palette (Cmd+P → "Edit with Claude Code")
• AI prompt modal with response display, markdown rendering, and undo support
• Proactive CLI detection with graceful error handling

Keyboard Shortcuts Reference

• New Shortcuts tab in Settings showing all available keyboard shortcuts
• Platform-aware display (⌘ on macOS, Ctrl on Windows/Linux)

Windows Support (thanks @Charlsz)

• Cross-platform keyboard shortcut handling
• Windows build targets (NSIS installer and MSI)

Auto-Update Support

• Built-in update checking on startup and manually via Settings → General
• Signed updates served from GitHub Releases

Installation

Download DMG (macOS)

1. Download Scratch_0.4.0_universal.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Windows
Pre-built Windows binaries are not yet available. To run on Windows, clone the repo and build from source with npm run tauri build.

Requirements

• macOS 10.15+ (Universal binary — Intel and Apple Silicon)
• Windows 10/11 (build from source)

Checksums

sha256:6efa40e170f0da6519da717b82796707b9ef43342706f71038a4384069939622 — Scratch_0.4.0_universal.dmg
EOF
)"

v0.3.0

Scratch v0.3.0 — Table Support & Styling Improvements

What's New

Markdown Table Support

• Paste markdown tables directly into the editor and they render as formatted tables
• Full table styling with borders, header highlighting, and hover effects
• Cell selection highlighting
• Powered by TipTap TableKit extension

Improved Task List Spacing

• Better breathing room between checklist items
• Fixed uneven spacing between parent and nested child items

Styling Fixes

• Added solid border color variable for light and dark themes
• Cleaned up table cell margins for consistent spacing

Installation

Download DMG

1. Download Scratch_0.3.0_aarch64.dmg below
2. Open the DMG and drag Scratch to Applications

Homebrew

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Requirements

• macOS (Apple Silicon)
• Not yet tested on Intel Macs, Windows, or Linux

Checksums

sha256:c9e40cf043c796fab7e9025306449024dc7826dd389b3331f4bccdbf157a1c2a — Scratch_0.3.0_aarch64.dmg

v0.2.0 — Second Public Beta

Scratch v0.2.0 — Pin Notes, In-Note Search & Auto-Updates

What's New

Pin Notes

• Pin important notes to the top of the note list
• Pin/unpin via right-click context menu, editor toolbar, or command palette (Cmd+P)
• Pinned notes sort by date at the top, unpinned below

In-Note Search (Cmd+F)

• Search within the current note with real-time highlighting
• Navigate matches with Enter/Shift+Enter or arrow buttons
• Match counter shows current/total matches
• Yellow highlight decorations with brighter active match

Auto-Updates

• Built-in update checking via Tauri updater plugin
• Signed updates served from GitHub Releases

Fixes & Improvements

• Fix git status infinite re-render loop
• Fix date truncation in editor header when buttons overflow
• Add Homebrew installation instructions to README

Installation

Homebrew (Recommended)

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Manual Download

1. Download Scratch_0.2.0_aarch64.dmg below
2. Open the DMG and drag Scratch to Applications
3. Important: Open Terminal and run: xattr -cr /Applications/Scratch.app
   (Required because the app isn't signed with an Apple Developer certificate yet)

Requirements

• macOS (Apple Silicon)
• Not yet tested on Intel Macs, Windows, or Linux

This is a beta release. Feedback and bug reports welcome!

Checksums

sha256:79107641adf332eefe29d655a4c99b463b80e1783114cf4316d68d9c389e3538 — Scratch_0.2.0_aarch64.dmg

v0.1.0 — First Public Beta

Scratch v0.1.0 — First Public Beta

A minimalist, offline-first markdown note-taking app for Mac.

Highlights

• Offline-first — No cloud, no account, no internet required. Your notes stay on your machine.
• Markdown-based — Notes stored as plain .md files you own and control
• WYSIWYG editing — Rich text editing that saves as clean markdown
• Full-text search — Fast Tantivy-powered search with command palette (Cmd+P)
• Works with AI agents — Detects external file changes and refreshes on demand
• Git integration — Optional version control for your notes
• Customizable — Light/dark/system theme and editor typography settings

Installation

Homebrew (Recommended)

brew tap erictli/tap
brew install --cask erictli/tap/scratch

Manual Download

1. Download Scratch_0.1.0.dmg below
2. Open the DMG and drag Scratch to Applications
3. Important: Open Terminal and run: xattr -cr /Applications/Scratch.app (This is required because the app isn't signed with an Apple Developer certificate yet)

Requirements

• macOS (Apple Silicon)
• Not yet tested on Intel Macs, Windows, or Linux

---

This is a beta release. Feedback and bug reports welcome!