Scratch v1.0.0

Scratch v1.0.0

Scratch is 1.0 🎉

Scratch has reached the shape I set out to build: a minimalist, offline-first markdown notes app that stays out of your way. With 1.0, I'm marking it stable.

That also means a change in pace: I'm no longer monitoring issues and PRs regularly, and I can't guarantee I'll get to everything — see the Contributing section for details. Scratch is MIT licensed, so if you want to take it further or in a new direction, fork away.

What's New

Find & Replace

• The find bar (Cmd+F) now includes Replace and Replace All actions (Ctrl/Cmd+Enter to replace all)

Resizable Sidebar

• Drag the sidebar's right edge to adjust its width — your preferred width is remembered

macOS Autocorrect & Spellcheck

• The editor now supports system spellcheck and autocorrect, like Apple Notes
• Smart quotes and dash substitution stay off so markdown syntax is never rewritten

Windows Title Bar Improvements

• The native Windows title bar now follows the app theme
• Fixed the in-app layout under the native title bar (no more dead space above the content)

Readable Date Tokens for Note Names

• The default note name template supports new tokens: {monthName}, {monthShort}, {weekday}, {weekdayShort}, and {dayOrdinal} — e.g. "Tuesday, July 28th"

Git Remote Management

• Change or remove the git remote directly from Settings → General → Version Control

Bug Fixes

• Fixed native window controls (minimize/maximize/close) not responding on first launch on Linux
• Renamed the Linux .deb package from scratch to scratch-notes so it no longer conflicts with Ubuntu's unrelated scratch package

In-App Update Notes

Scratch 1.0! Find & replace, resizable sidebar, macOS autocorrect, Windows title bar improvements, readable date tokens for note names, git remote settings, and Linux fixes.

Installation

Download DMG (macOS)

1. Download Scratch_1.0.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_1.0.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_1.0.0_amd64.AppImage or scratch-notes_1.0.0_amd64.deb below.

Note for existing .deb users: the package is now named scratch-notes. In-app updates will work as before; after upgrading you can optionally run sudo apt remove scratch to drop the old package entry.

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:

• @Nivet2006 — Find & Replace
• @ssiohan — resizable sidebar
• @pettijohn — Linux window controls fix
• @djdevpro — Windows title bar layout fix
• @GihanRathnayake — Wayland window controls diagnosis

Scratch v0.10.0

Scratch v0.10.0

What's New

Custom Theme Color Picker

• Personalize the app accent color with a full color picker in Settings → Appearance

Multi-Note Selection & Batch Drag-to-Folder

• Select multiple notes and drag them into a folder in one action

Keyboard Shortcuts & Markdown Syntax Modal

• View all keyboard shortcuts and markdown syntax from a new in-app reference modal

Configurable Ignored Folders

• Exclude specific folders from note discovery in Settings → General

Code Block Copy Button

• Rendered code blocks now include a one-click copy button

Bug Fixes

• Fixed print-as-PDF rendering blank pages
• Fixed autofocus and preserved scroll/cursor position when toggling source mode
• Fixed editor focus not restoring when dismissing the command palette
• Improved hyperlink handling in the editor
• Fixed markdown formatting being lost when copying from the editor
• Fixed top content clipping in the desktop window

In-App Update Notes

Custom theme color picker, multi-note selection with batch drag-to-folder, keyboard shortcuts modal, configurable ignored folders, code block copy button, and various bug fixes.

Installation

Download DMG (macOS)

1. Download Scratch_0.10.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.10.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.10.0_amd64.AppImage or Scratch_0.10.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:

• @blksmr — multi-note selection, keyboard shortcuts modal, markdown copy fix
• @adi0x90 — desktop window clipping fix
• @Talhamehar007 — code block copy button
• @jordanlee — print-as-PDF fix
• @Gold240sx — initial custom theme color picker

Scratch v0.9.1

Scratch v0.9.1

Bug Fix

• Fixed context menu auto-selecting the first item when browser zoom is below 100%

Installation

Download DMG (macOS)

1. Download Scratch_0.9.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.9.1_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

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

Requirements

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

Scratch v0.9.0

Scratch v0.9.0

What's New

Folder Support

• Organize notes in a collapsible folder tree (enable in Settings → General → Enable Folders)
• Create, rename, and delete folders from the sidebar or command palette
• Drag and drop notes and folders to reorganize
• Selecting a note auto-expands its parent folders

scratch CLI Command (macOS)

• Install from Settings → General to open notes from the terminal
• scratch file.md opens a note, scratch . sets the current directory as your notes folder, scratch launches the app
• If the app is already running, arguments are forwarded to the existing window

OpenCode AI Editing

• Added OpenCode as an AI editing provider alongside Claude, Codex, and Ollama
• Auto-discovered alongside other installed CLI tools

VCS Integration Toggle

• Git features are now opt-in — enable in Settings → General → Version Control
• When disabled, all git UI is hidden

Keyboard & Editing Improvements

• New shortcuts: Duplicate note, Delete note, jump to empty note
• Auto-focus on new note titles (opt-in)
• Automatic bidi text direction in the editor
• Faster format bar animations
• Selected note stays visible during keyboard navigation

In-App Update Notes

Adds folder support with drag-and-drop, scratch CLI command (macOS), OpenCode AI editing, VCS integration toggle, and keyboard improvements.

Installation

Download DMG (macOS)

1. Download Scratch_0.9.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.9.0_x64-setup.exe below and run the installer. WebView2 will be downloaded automatically if needed.

Linux
Download Scratch_0.9.0_amd64.AppImage or Scratch_0.9.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:

• @julianbragachi — scratch CLI command
• @n00ki — OpenCode integration, VCS toggle, bidi support, keyboard shortcuts, auto-focus, format bar improvements

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