Skip to main content
The Claude Board desktop app is an Electron wrapper around the web application. It provides a native experience with a setup wizard on first launch.

​
Setup Wizard

When you open Claude Board for the first time, the setup wizard guides you through initial configuration:

Data directory

Choose where Claude Board stores its database and uploads. Defaults to the OS-specific application data path.

Port selection

Pick the port for the embedded Express server. Default is 4000. The wizard checks if the port is available.

Claude CLI check

The wizard verifies that the claude CLI is installed and accessible on your PATH.

​
Splash Screen

While the server starts up, a splash screen displays the Claude Board logo and a loading indicator. The main window opens once the server is ready to accept connections.

​
Single Instance Lock

Only one instance of Claude Board can run at a time. If you try to open a second instance:
  • The existing window is brought to the front
  • The second instance exits silently
This prevents port conflicts and database locking issues from multiple processes accessing the same data directory.

​
System Tray

The desktop app minimizes to the system tray. Right-click the tray icon for options:
  • Show — bring the window to front
  • Quit — stop the server and exit

​
Changing Settings After Setup

To reconfigure the data directory or port after initial setup:
  1. Open the app’s settings from the menu
  2. Update the values
  3. Restart the app for changes to take effect
Changing the data directory does not migrate existing data. Copy the database and uploads folder manually if needed.