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.
- Create a workspace and point it at a project folder.
- Start a session in it. That is a real
claudein a PTY, in that folder. - 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.