cowork-deck

Install · v0.5.0

Download cowork-deck

Free and MIT-licensed. No account, no key, no subscription of its own — it runs the claude you already have.

Before you start

Claude Code, installed and logged in. If claude is not on your PATH, the app says so on startup, and COWORK_CLAUDE_PATH pins the one you mean.

The GitHub CLI, optionally — only for the account bindings, the boards that read issues, and the pull requests. Without it, everything else still works.

Downloads

macOS

Then read the Gatekeeper note — you will need it, and it is not a sign that anything is wrong.

Linux

Windows

No published bundle yet. It builds and runs — see building from source — but nobody should read a download button that produces an untested binary.

Older versions, checksums and release notes: all releases on GitHub · changelog

macOS says the app “is damaged”

It is not. That wording is Gatekeeper's, and what it actually means is that the app is not notarized: there is no paid Apple Developer account behind this project, so macOS quarantines the download rather than checking a signature. Clear the flag once:

xattr -cr /Applications/cowork-deck.app

System Settings → Privacy & Security → Open Anyway is the same decision through the UI.

And if you would rather not clear a flag Apple put on a stranger's binary — fair. Everything in the bundle is in the public repository, and npm run tauri build produces the same app from source.

The first run

Three steps, and none of them is an account.

  1. Create a workspace and point it at a project folder.
  2. Start a session in it. That is a real claude in a PTY, in that folder.
  3. Everything else is optional and off until you turn it on: the GitHub binding, the board, scenarios, schedules, and sync.

Two environment variables, both optional: COWORK_CLAUDE_PATH pins a claude that is not on PATH, and COWORK_GH_PATH does the same for gh.

Building from source

Needed on Windows, and the honest option anywhere.

You will want Node.js and npm, a Rust toolchain, the Tauri v2 system dependencies, and Claude Code itself.

git clone https://github.com/followLemmi/cowork-deck.git
cd cowork-deck
npm install
npm run tauri dev      # hot reload
npm run tauri build    # a release bundle for this platform

In a fresh clone, run npm install && npm run build && npm run stage:reporter once before cargo test: neither dist/ nor src-tauri/binaries/ is in git, and Tauri's build script fails without them.

Uninstalling

Delete the app. Settings live in your platform's ordinary config directory and your boards are markdown files in folders you chose — nothing is hidden anywhere else, and nothing was sent anywhere.