Corkly

Kanban board for local Markdown files.
Corklyly is a cross-platform evolved fork of the original macOS-exclusive repository, Corkly.

Installation

Windows

Download the latest Corkly_<version>_x64-setup.exe from the Releases page and run it. The installer is a per-user install (no admin rights required) and adds cork to your PATH.

Note on SmartScreen warning: The Windows installer is not code-signed, so on first launch Windows Defender SmartScreen will display "Windows protected your PC". Click More info → Run anyway to proceed. This is expected — Corkly does not carry an Authenticode signature.

Upgrading from a previous Windows install: Please fully uninstall your existing Corkly (Settings → Apps → Corkly → Uninstall) before running a new setup.exe, rather than installing directly over it. Windows installers reuse the previous version's uninstaller during an in-place upgrade, and older Corkly builds had a bug there that could corrupt your PATH environment variable.

Linux

Download either Corkly_<version>_amd64.deb (Debian / Ubuntu) or Corkly_<version>_amd64.AppImage (any distro) from the Releases page.

# Debian / Ubuntu
sudo dpkg -i Corkly_<version>_amd64.deb

# AppImage
chmod +x Corkly_<version>_amd64.AppImage
./Corkly_<version>_amd64.AppImage

The .deb installer registers cork on your PATH.

How it works

Corkly has no database. A workspace is just a folder, and every task is a plain Markdown file inside it — so your board lives entirely in version-controllable, editor-friendly text.

• One task = one .md file. The file name is the task title; the Markdown body is the task description.
• Frontmatter holds the metadata. status, order, tags, and date live in the YAML frontmatter at the top of each file.

---
status: In Progress
order: 0
tags:
  - feature
  - urgent
date: 2026-06-12
---

Write the project README, including a "How it works" section.

Because it's all just files, you can edit tasks in any editor, grep them, and track the whole board in Git.

CLI

Installing via Homebrew also puts a cork command on your PATH.

# Open a new window.
cork

# Open a directory as a workspace.
cork ./path/to/workspace

License

MIT