Skip to content

Stow 0.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@byanthny byanthny released this 04 Nov 13:11
· 132 commits to main since this release
v0.1.0
This tag was signed with the committer’s verified signature.
byanthny Anthony Das
SSH Key Fingerprint: cgTfZOH4yxjbQyAjC62ZCBRNMzB5H1UBgNZfG2UMqWU
Verified
Learn about vigilant mode.
2ac6368
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 version: a pre-release you build from source.

Highlights

  • Notes as plain Markdown files.
    • Each note is a UTF-8 .md file you can edit in any app. Stow reloads outside edits and keeps both versions if they conflict.
    • On the board, notes show as one-line rows. Open one inline, or pop it out into its own window, pinned on top or not.
  • A calm pull request board.
    • Needs you and Waiting, using the GitHub CLI login you already have.
    • Cards lead with owner/repo #number, and each section shows three cards before Show more.
    • Partial or missing data never marks a pull request ready.
  • Your layout, your defaults. Settings → Board covers section order, how many cards show, whether Notes can collapse, how notes open, and the header title.
  • Themes as short text configs. Copy, paste, or share key = value themes with presets, opacity, and separate interface and note fonts.
  • Backups that stay yours.
    • Markdown import and export, plus a full backup and restore.
    • A restored backup never turns GitHub or accessories on, and never chooses a program to run.

Requirements

  • macOS 14 or later. Hands-on testing so far covers macOS 26 on Apple silicon. Automated smoke checks pass on Intel with macOS 15, and macOS 14 is untested.
  • Xcode 16.4 or later to build.
  • GitHub is optional. To use it, install the GitHub CLI and sign in with gh auth login --hostname github.com. Stow asks before using it.

Install

There is no signed download yet. 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. The package is signed ad hoc for your own Mac. Don't share it, and don't run builds from other people.

Privacy and security

  • 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.
  • Report vulnerabilities privately; see SECURITY.md.

Known limits

  • External display moves, keyboard navigation, and VoiceOver still need hands-on acceptance.
  • Work/personal profiles are in progress and not part of this release.

Licensed under GPL-3.0-or-later.

Assets 2
Loading