Band Band

Web Interface

The Band web interface is a browser-based dashboard for managing workspaces, monitoring agent activity, and interacting with your codebase. It runs locally alongside the Band server and is also accessible remotely through a Cloudflare tunnel.

Desktop Layout

On larger screens, the dashboard uses a sidebar-based layout. The sidebar provides navigation between projects and workspaces, while the main area shows the selected workspace's content.

  • Sidebar — Lists all projects and their workspaces. Click to switch context.
  • Main panel — Displays agent chat, code viewer, file browser, or other tools.
  • Status bar — Shows connection status, active tasks, and tunnel state.

Mobile Layout

On smaller screens (phones and tablets), the interface adapts to a mobile-friendly layout. The sidebar collapses into a navigation menu, and content panels stack vertically. This makes it easy to monitor and manage agents from your phone, especially when combined with remote access.

Real-Time Agent Chat

The chat panel shows a live stream of agent activity as it happens. Messages include:

  • Agent responses — Text output from the AI agent.
  • Tool calls — File edits, terminal commands, and search operations.
  • File changes — Inline diffs showing what the agent modified.
  • Status updates — Task progress, completion, and error messages.

Chat is streamed in real time over WebSocket, so you see agent output as soon as it is generated. You can also send messages to the agent directly from the chat input.

Code Viewer

The built-in code viewer displays files from the workspace with syntax highlighting. You can browse files directly in the dashboard without switching to your editor.

  • Syntax highlighting for common languages.
  • Line numbers and code folding.
  • Direct links from agent tool calls to the relevant file and line.

File Browser

The file browser shows the workspace directory tree. Navigate through directories, open files in the code viewer, and see which files were recently modified by the agent.

Git Diff Viewer

The diff viewer shows all changes made in the current workspace compared to the base branch. This gives you a clear picture of what the agent has done and makes it easy to review before merging.

  • Side-by-side or unified diff view.
  • File-by-file change navigation.
  • Summary of added, modified, and deleted files.

File Search and Content Search

The dashboard includes two search modes:

  • File search — Find files by name using fuzzy matching. Type a partial filename to quickly navigate to the right file.
  • Content search — Search for text within files across the workspace. Results show matching lines with context, similar to grep or ripgrep output.