Skip to content

Stow 0.2.0 (alpha)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@byanthny byanthny released this 04 Nov 18:36
· 85 commits to main since this release
v0.2.0
This tag was signed with the committer’s verified signature.
byanthny Anthony Das
SSH Key Fingerprint: cgTfZOH4yxjbQyAjC62ZCBRNMzB5H1UBgNZfG2UMqWU
Verified
Learn about vigilant mode.
8bc7273
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Stow is a small native macOS board for Markdown notes and GitHub pull requests. This is the first alpha. Download the unsigned DMG below or build it yourself, expect rough edges, and tell us what breaks.

What's new since 0.1.0

  • Profiles.
    • Keep work and personal apart, or any split you like. Each profile has its own notes, cards, theme and windows, plus a name, color and icon.
    • Switch with ⌃⌥1 to ⌃⌥9, or from the board header.
    • Deleting a profile moves its folder to the Trash.
  • Owner views. Show only the pull requests from the owners you pick, group cards by owner, and optionally keep only the selected owners' cards on disk.
  • Code in notes. Inline code and fenced code blocks show in a monospaced font while you type and in Preview. Notes stay plain Markdown files.
  • Notes.
    • Remove a note's pull request link from its menu or by right-clicking the link.
    • Deleting a note with text asks first.
    • Start a note by typing on the board.
    • Notes and the card's add-note button have clearer icons.
  • The board. The header shares the title bar row. Cards have pin, note and dismiss buttons. Settings → Board can hide the board title.
  • Fixes.
    • A saved owner whose GitHub login ends in a hyphen is no longer dropped. Before, dropping it could widen "Keep only selected owners on disk" to every owner.
    • Clearer messages when the profile list can't be read or comes from a newer Stow.

Requirements

  • Running: macOS 14 or later. Hands-on testing so far covers macOS 26 on Apple silicon. Automated smoke checks pass on Intel with macOS 15. macOS 14 is untested.
  • Building: Xcode 16.4 or later, which needs macOS 15.3 or later.
  • GitHub (optional): the GitHub CLI, signed in with gh auth login --hostname github.com. Stow asks before using it.

Install

Download Stow-0.2.0.dmg below, open it, and drag Stow to Applications. It's unsigned, so macOS asks you to allow it the first time it opens. GitHub Actions built it from this release's tag. To check it, run gh attestation verify Stow-0.2.0.dmg --repo byanthny/stow, or compare it with Stow-0.2.0.dmg.sha256.

Or build from source:

git clone https://github.com/byanthny/stow.git
cd stow
./scripts/package.sh

Unzip build/Stow.zip and move Stow.app to Applications. That package is signed ad hoc for your own Mac. Only use DMGs from this repository's Releases, and don't run builds from anywhere else.

What to try

  • Notes: write, pop out, pin on top, edit the .md file in another app, and add a code snippet.
  • Profiles: make a second profile, switch between them, and quit and reopen.
  • With GitHub on: the Needs you and Waiting sections, owner views, and pinning.

Reporting bugs

Use the bug report form and include your Stow version, macOS version and Mac. Use synthetic data: never paste private notes, pull request data or tokens. Report vulnerabilities privately; see SECURITY.md.

Privacy

  • No analytics, telemetry, account or server.
  • Notes and cached pull requests stay on your Mac, readable only by your macOS user.
  • Stow never reads or stores your GitHub token.

Known limits

  • External display moves, keyboard navigation and VoiceOver still need hands-on checks.
  • Hands-on profile checks are still in progress.
  • Builds are signed ad hoc only. Signed and notarized downloads come later.

Licensed under GPL-3.0-or-later.

Assets 4
Loading