A native macOS client for GitHub Projects v2.
Download the alpha · Roadmap · Report an issue · Contribute
Public alpha · macOS 15 or later
The interface is inspired by Linear, adapted to GitHub Projects.
Manage your GitHub Projects in a dedicated macOS window, with keyboard shortcuts and cached boards that stay available offline. Queued changes sync when GitHub is reachable again.
- Boards and lists — move cards and filter by status, assignee, label or repository.
- Issue details — read descriptions and activity, post Markdown comments and change assignees.
- Keyboard navigation — J/K to navigate, S for status, C for a draft, ⌘K to search the loaded project.
- Multiple accounts — switch between saved GitHub accounts; credentials stay in macOS Keychain.
Alpha limits: saved GitHub view filters are not applied and labels are read-only. Roadmap views, other project fields, repository issue lists, issue creation and the full issue timeline still need GitHub.
- Download the DMG for your Mac from Releases.
- Open it and drag Planche into Applications.
- Launch Planche, choose Sign in with GitHub, then select a project.
Requires macOS 15+. Updates are available in the app. The alpha is not notarized: if macOS blocks it after the first launch attempt, use System Settings → Privacy & Security → Open Anyway. Managed Macs may prohibit this.
For organization projects, choose Connect organizations… with the same GitHub account. Private personal repository cards may be redacted with OAuth alone. See sign-in options and permissions for GitHub App setup and the classic PAT alternative.
Requires macOS 15+, Bun 1.3+, Rust stable
and Xcode Command Line Tools (xcode-select --install).
git clone https://github.com/HorebZ/Planche.git
cd Planche
bun install
cp .env.example .env
chmod 600 .env
# Configure GitHub sign-in in .env (see the development guide).
bun run setup:signing
bun run devSet PLANCHE_GITHUB_CLIENT_ID for OAuth, or PLANCHE_TOKEN for local testing with
a classic PAT. Never put credentials in a VITE_ variable.
The development guide covers authentication, the CLI, tests
and releases.
Built with Tauri 2, React and Rust. planche-core
owns the GitHub client, SQLite cache and sync engine, shared by the app and CLI.
Bug reports and pull requests are welcome. Include reproduction steps, expected behavior and your macOS version in bug reports. Discuss larger changes in a roadmap issue before implementation.
Read AGENTS.md for architecture and code conventions, and run
bun run check before pushing.
