Band Band

Dashboard Overview

The Band desktop app is a native application built with Tauri that serves as your central command center for managing coding agent workspaces. It provides a compact, always-accessible interface for monitoring projects, workspaces, and agent activity.

Application Layout

The dashboard uses a single-window design with a clear visual hierarchy. The main window is divided into three areas:

  • Top toolbar — Contains the settings menu, label filter dropdown, theme toggle, and an add-project button. The toolbar provides quick access to the most common actions.
  • Project list — The main scrollable area displays all registered projects. Each project shows its name and a list of workspaces underneath it. Workspaces display their branch name, agent status indicator, git status, and CI status.
  • Status bar — The bottom area shows setup prompts (such as installing the CLI or Claude Code hooks) and error messages when they occur.

Title Bar

On macOS, Band uses a native overlay title bar that displays Band by default or Band - <branch> when a git branch is detected. The title bar supports native window dragging.

Theme Support

Band supports three theme modes that control the visual appearance of the entire application:

  • System — Follows your operating system preference. When your OS switches between light and dark mode, Band updates automatically.
  • Light — Forces a light color scheme regardless of system settings.
  • Dark — Forces a dark color scheme regardless of system settings.

You can cycle through themes by clicking the theme toggle button in the top toolbar. The icon changes to reflect the current mode: a monitor icon for system, a sun icon for dark (click to switch to light), and a moon icon for light (click to switch to dark). Theme preference is persisted in your settings.

Tasks Window

The tasks window opens as a separate native window (900x700 pixels) and provides a consolidated view of all coding agent tasks across your projects. From this window you can submit new tasks, filter by project or status, cancel running tasks, and re-run completed or failed ones. See the Tasks Window documentation for details.

Cronjobs Window

The cronjobs window is another separate native window that lets you manage scheduled agent tasks. You can create recurring jobs with cron expressions, scope them to a project or specific workspace, and enable or disable them on the fly. See the Cronjobs Window documentation for details.

Keyboard Navigation

The project list supports full keyboard navigation. Use Arrow Up and Arrow Down to move the focus highlight between workspaces, and press Enter to open the focused workspace. The focused workspace is indicated by a ring highlight. Clicking any workspace with the mouse also works as expected.

Setup Prompts

When Band detects that required components are not installed, it shows setup prompts at the bottom of the dashboard:

  • CLI installation — Prompts to install the band CLI binary to /usr/local/bin so you can use it from any terminal.
  • Hooks installation — Prompts to install Claude Code hooks for automatic agent status detection.

Each prompt includes a one-click Install button. These prompts disappear once the components are installed.