Download the right build
Installers are on GitHub Releases. On macOS, pick the .dmg that matches your CPU:
| Check | Download |
|---|---|
uname -m prints arm64 (Apple Silicon) |
Dickory.Docs_*_aarch64.dmg |
uname -m prints x86_64 (Intel Mac) |
Dickory.Docs_*_x64.dmg |
Run in Terminal:
uname -mOn Apple Silicon, if the native aarch64 build misbehaves, try the x64 DMG — it runs under Rosetta.
First launch (unsigned build)
CI builds are not notarized. If macOS blocks the app:
- Right-click Dickory Docs in Applications → Open, or
- Allow it in System Settings → Privacy & Security.
Use Open With
- Install Dickory Docs from the DMG into Applications.
- In Finder, right-click a Markdown file (e.g.
README.md). - Choose Open With → Dickory Docs.
If Dickory Docs is not listed, choose Other…, select the app in Applications, and click Open.
The app opens the file in split editor + preview (or preview-only if you hid the editor). If the folder is not already a workspace, Dickory Docs adds the parent directory automatically.
v0.3.1 fix
v0.3.0 registered Markdown types in Info.plist but could not accept files from Finder because the underlying window layer (Tao 0.16) did not implement document-open delegate methods. v0.3.1 adds those handlers so Open With works as intended.