Skip to main content

​
Prerequisites

Before installing Claude Board, make sure you have:

Claude Code CLI

Install and authenticate the Claude Code CLI. Run claude --version to verify.

Git

Git must be installed for branch automation and commit tracking. Run git --version to verify.

GitHub CLI (optional)

Install gh and run gh auth login if you want Auto PR creation.

​
Desktop App

Download the latest release for your platform:

Windows

.exe / .msi installer (x64)

macOS

.dmg — Intel & Apple Silicon

Linux

AppImage & .deb

​
First Launch

On first launch, the 6-step setup wizard guides you through:
  1. Language selection — English or Turkish
  2. System check — Validates Claude CLI, Node.js, Git, and port availability
  3. Data directory — Where the SQLite database and uploads are stored
  4. MCP server port — Default 4000, auto-checks availability
  5. First project — Creates your initial project with a working directory
The setup wizard runs only once. You can change settings later from the app menu.

​
Build from Source

Building from source requires both Rust and Node.js toolchains.

​
Prerequisites

​
Steps

npx tauri dev builds the Rust backend, starts the Vite dev server for the React frontend, and opens the app window with hot-reload enabled.

​
Production Build

To produce a distributable installer:
The output is written to src-tauri/target/release/bundle/ and includes platform-specific installers.

​
Verify Installation

After installing, verify everything works:
  1. Launch Claude Board — you should see the setup wizard (first run) or the main board
  2. Open Settings and confirm the MCP server port is active
  3. Create a test project pointing to any code directory
  4. Create a simple task (e.g., “List all files in the project root”) and move to In Progress
  5. Watch the live terminal — you should see Claude’s output streaming in real-time