Band Band

Installation

Band is distributed as a macOS desktop application. The app bundles both the dashboard UI and the web server that manages your projects, workspaces, and tasks.

System requirements

  • macOS 13 (Ventura) or later
  • Apple Silicon (M1/M2/M3/M4) or Intel Mac
  • Git installed and available on your PATH
  • A coding agent such as Claude Code installed and configured

Download

Download the latest .dmg file from the GitHub Releases page. Choose the build that matches your Mac's architecture:

  • Band_x.x.x_aarch64.dmg for Apple Silicon Macs (M1 and later)
  • Band_x.x.x_x64.dmg for Intel Macs

Install the app

  1. Open the downloaded .dmg file.
  2. Drag Band.app into your Applications folder.
  3. Eject the disk image.
  4. Open Band from your Applications folder or Spotlight.

On first launch, macOS may show a security prompt because the app is not notarized through the Mac App Store. If you see "Band can't be opened because Apple cannot check it for malicious software," go to System Settings → Privacy & Security and click Open Anyway.

First launch

When Band starts for the first time, it does the following:

  1. Creates the ~/.band directory to store configuration and state.
  2. Starts the web server on port 3456.
  3. Opens the dashboard window.

The web server runs in the background as long as Band is open. You can access the dashboard from any browser at http://localhost:3456.

The Band CLI

Band includes a command-line interface that lets you manage projects, workspaces, and tasks from your terminal. The CLI binary is bundled with the desktop app and communicates with the web server over HTTP.

After installing Band, you can verify the CLI is working by running: 

band projects list

If the CLI is not on your PATH, you may need to add it. The binary is located inside the app bundle or can be installed separately.

Verify the server is running

You can confirm the web server is up by visiting http://localhost:3456 in your browser or by running: 

curl http://localhost:3456/api/health

If you see a response, the server is running and you are ready to add your first project.

Next step

Now that Band is installed, head to Adding your first project to register a git repository.