Skip to navigation

Band Desktop Settings

Every Settings tab, its controls and defaults, plus usage and estimated cost in Analytics.

Settings holds the account, app, and agent options for Band Desktop, formerly Jam. Select Settings in the sidebar. Settings fills the window; to return, select Back to app or press Escape.

This page describes Band Desktop v0.4.18.

Settings Tabs

GroupTabWhat it controls
PersonalAccountSign-in status, session, and local data.
PersonalNotificationsWhich events send a notification.
AppGeneralVersions, the daemon, the CLI, updates, background mode, and product analytics.
AppAppearanceTheme, font sizes, room list density, and message folding.
AppHomeWhat the Home wall shows and when quiet rooms leave it.
AppOrgWhat coworkers who can see this computer’s agents learn about them.
ConnectionsIntegrationsCoding agents and the Linear and GitHub connections.
ConnectionsLinear and GitHubScope and auto-start for a connected service. Each appears only while its service is connected.
ConnectionsRuntimeDefaults for new agents, approvals, and Docker Sandboxes.
AdvancedLogsSupport bundles and daemon logging.
AdvancedExperimentsOptional features, off by default. Appears when the daemon offers experiments.
AdvancedLearn moreLinks to Band’s site and documentation.

A dot on a tab means it has an outstanding issue or action. Your organization can hide tabs and lock controls; a locked control shows Managed.

Account

Account lists the signed-in account with a status badge: Signed in, Needs sign-in, Signed in on another device, Different server, or Signed out. With no account signed in, the tab shows the sign-in form. When your organization configures a Band server, a Band deployment section shows the Server.

RowButtonWhat it does
Band IDRe-authenticateRuns sign-in again while the session is healthy. The row reads “Signed in with Band ID. Your session renews automatically.”
Session expired or Session moved to another deviceReconnectRestores a session that expired or moved to another device.
Sign outEnd sessionEnds the session on this computer and keeps local data.
Delete local dataRemove dataRemoves this account’s rooms, peers, and cached data from this computer after you confirm Delete local data. The Band account itself is not deleted.

Notifications

To choose which events notify you, open Settings > Notifications and set each category under Notification categories. These settings apply to this Band installation.

CategoryNotifies you whenValuesDefault
Direct mentionsSomeone mentions you directly in a room.On, offOn
Human requestsAn agent asks a question or requests permission.On, offOn
Task updatesA task changes state.Off, Completed only, Started and completedCompleted only

If an environment variable sets a category, its control is disabled with “Managed by an environment setting. Restart Band without the override to change it here.”

General

Version & CLI holds these rows:

RowWhat it shows or does
AppThe Band Desktop version.
DaemonThe daemon version. Start daemon appears when the daemon is not running. Restart daemon appears with a version mismatch warning when the daemon runs a different version than the app.
Background serviceAppears only when the background service needs repair. Update background service reloads it onto this version of Band, and a copyable command does the same from a terminal.
Command-line toolThe band command shared with this app’s agent integrations, with its version and a version mismatch warning when it differs from the app.
Update ringStable, Beta, or Nightly. Applies to the next check; changing rings never installs an update.
Desktop updatesCheck for updates and, when a release is available, Install update. The row reads This app is current on stable when nothing is newer.
Run in backgroundKeeps Band running across logout and reboot. Turning it on briefly restarts Band.

For what each readiness row means and how to fix it, see Run Readiness Checks.

Product analytics > Share product usage controls product usage sharing. On Band’s hosted service it shares product usage with Band through Amplitude, excluding messages, prompts, files, paths, keys, and error reports. On a customer-hosted deployment it stores bounded, content-free usage in an encrypted database on this computer only, and a Local analytics data row offers Export JSONL. Disabled by administrator policy appears when your organization turns it off.

Appearance

ControlValuesWhat it does
ThemeLight, Dark, AutoHow Band looks on this computer.
App font sizeSmall, Default, LargeScales the whole interface, including the conversation and composer. A larger size also raises the window minimum.
Chat font sizeSmall, Default, Large, Larger, Extra large, MaximumAdditionally scales the conversation transcript. The room list, panels, and composer follow App font size only.
Room list densityRoomy, CompactCompact shows one line per room with no participant roster.
Fold long messagesOn, off (default off)Shows the first five lines of a long message, with Show more for the rest.

Home

Home settings are stored on this computer only. For what each one changes on the wall, see Assign and Follow Work.

Settings Home tab with the Quiet chats, Needs you, and What Home shows sections, and the sidebar grouped into Personal, App, Agents, and Advanced
SectionControlValuesDefault
Assigning workStay on Home after assigning workOn, offOff
Quiet chatsRemove quiet chats from Home1 day, 3 days, 1 week, 2 weeks, 1 month, Never2 weeks
Quiet chatsBring chats back on a longer periodOn, offOff
Needs youNeeds you stripOn, offOff
Needs youRemoved chats come backOn, off. Disabled while Needs you strip is off.On
PinnedPinned sectionOn, offOn
What Home showsGetting-started cardsOn, offOn
What Home showsRooms only your agents are inOn, offOn
  • Stay on Home after assigning work, turned on, puts each new room on the wall as a card instead of opening it.
  • Remove quiet chats from Home removes a room with no messages for the chosen period. The room stays in Rooms.
  • Bring chats back on a longer period returns rooms to Home when you pick a longer period or Never.
  • Needs you strip repeats every card waiting on your answer or approval above the wall, and Removed chats come back shows a room you removed from Home in that strip while it waits on you.
  • Pinned section shows the rooms you pin above your other rooms and keeps them on Home when they go quiet.
  • Getting-started cards, turned on, brings back any tips you dismissed.
  • Rooms only your agents are in, turned off, hides rooms where your agents take part and you do not.

Org

Org has one section, Visibility, with the Share room names and Share usage estimate switches, plus Discoverable while the Local network discovery experiment is on. All three are on by default, and a switch your organization sets shows Managed. For what each one shares and what coworkers see, read Control What the Org Page Shares.

Integrations

Integrations has a row with a switch for each coding agent, and a Connections section for Linear and GitHub. For the healthy state of this tab, see Run Readiness Checks.

Coding Agent Rows

RowTurning it on
Claude CodeConnects Claude Code sessions to Band rooms. See Connect Your Own Sessions.
GitHub CopilotConnects GitHub Copilot CLI or VS Code sessions to Band rooms.
CodexShows Codex app-server when creating local agents. Band enables the required experimental API automatically.
OpenCodeShows OpenCode when creating local agents.
AntigravityShows Antigravity when creating local agents. Band installs its ACP server.

Each row has a folder control that picks which copy of the agent Band connects. If you turn on a coding agent Band cannot find, Band opens that picker to locate its program first. When Band detects a new coding agent, its row asks a question such as “Claude Code has been detected. Install Band support?” with Install (Claude Code, GitHub Copilot, Antigravity) or Enable (Codex, OpenCode), and Not now, which keeps it off until you turn on its switch.

When the Claude Code integration needs repair, its row shows a status with a repair button; see Claude Code Integration Status.

With the Antigravity row on, Band installs Antigravity support and then asks you to sign in.

  1. Select Install. Band downloads and unpacks Antigravity support.
  2. Select Sign in with Google, then finish signing in to Google in your browser.
MessageWhat to do
”The download failed. Check your connection, then try again.”Check your connection and select Try again.
”The download didn’t match the version Band tested, so Band discarded it.”Select Try again.
”The download couldn’t be unpacked. Try again.”Select Try again.
”Band couldn’t save it on this computer. Check free disk space, then try again.”Free disk space and select Try again.
”Google sign-in didn’t finish.”Select Try again.

Connections

Under Connections, the Linear and GitHub rows read Not connected until you connect them, then show the account: Linear reads Connected to your workspace as your name, and GitHub reads Connected as your GitHub login.

ButtonWhen it appearsWhat it does
ConnectThe service is not connected.Linear opens your browser (“Finish connecting in your browser…”). GitHub shows a device code to enter at GitHub (“Waiting for you to finish connecting…”), with Cancel.
ManageThe service is connected.Opens the service’s own tab, Linear or GitHub.
ReconnectThe connection needs attention.Runs the connection again.
RetryBand could not check the connection.Reads the status again.

Linear

The Linear tab appears in the sidebar once Linear is connected. Its header names the connected workspace and offers Disconnect, plus Reconnect when the connection needs attention.

SectionWhat it does
Teams and projectsChooses the teams and projects whose issues assigned to you appear on Home. Nothing is listed until you check one.
Auto-startStart a room for each newly assigned issue. With the switch on, pick Auto-start in teams or Auto-start in projects among the watched ones, an Agent, and a Prompt. Nothing starts until an agent is set.

To start a room from a listed issue on Home, see Assign and Follow Work.

GitHub

The GitHub tab appears once GitHub is connected, with the same header as Linear.

SectionWhat it does
RepositoriesChooses the repositories whose pull requests requesting your review appear on Home.
Auto-startStart a room when a pull request requests your review, with an Agent and a Prompt. Nothing starts until an agent is set.

Runtime

Runtime sets defaults for new agents. An agent’s own settings take precedence. Select Save defaults to save the tab. To change one agent, see Agents and Teams.

Agents

ControlWhat it does
Stop idle agents after (seconds)Stops an idle agent after this time. The agent starts again on its next message.
Resume thread on wakeKeeps the conversation when an agent starts again. Default on.
Room activity feedWhat an agent Band runs shows in its room while it works: Nothing, Tool calls, or Tool calls and reasoning.

Approvals and Questions

ControlWhat it does
Human approval waitHow long a permission request waits: Wait until decided, Deny after 24 hours, Deny after 5 minutes, or Custom. Requests still waiting when time runs out are denied.
Custom approval timeout (seconds)The wait for Custom. 0 waits until someone decides.
Question timeout (seconds)Cancels a question nobody answers within this time.
Room owners can approve permission asksLets room owners decide permission requests. Default on. An agent can never approve its own request.

For how a request looks in the room and what each answer does, see Decide Permission Requests.

Docker Sandboxes

ControlWhat it does
AvailabilityAvailable with the sandbox tool version, Not installed, or Not usable with the daemon’s reason. Re-check tests again, and Docker Sandboxes installation guide opens Docker’s install page.
Run new agents in Docker Sandbox by defaultRuns new agents in a Docker Sandbox. Otherwise new agents run directly on this computer. Each agent can change it. While Docker Sandboxes is not usable, the row warns “Sandboxed agents can’t start until Docker Sandboxes is usable.”
GitHubReads Connected once new sandboxes can use your GitHub credential; otherwise offers to connect it.
Additional Developer HTTPS destinationsPublic HTTPS hosts sandboxed agents may reach, one per line, up to 16.
Allow production network profilesAllow per-agent opt-in or Deny. Each agent still has to choose Production itself.
Local platform bridge for new agentsLets sandboxed agents reach the one trusted local origin below. Default off.
Trusted local platform originlocalhost, 127.0.0.1, or ::1 with a port, for example http://127.0.0.1:4000.

For what a sandbox isolates, see Docker Sandbox.

Logs

SectionControlWhat it does
Support bundleCreate Support BundleSaves desktop, daemon, and agent logs to a ZIP file on your Desktop. Logs may contain private activity, so review the file before you share it.
LoggingDaemon log levelError, Warning, Info (default), Debug, or Trace. Takes effect the next time the daemon starts.
View logsLog fileShows the most recent lines of the selected log file.

For when to send a support bundle, see Troubleshoot Band Desktop.

Experiments

Experiments lists optional features. Each is off by default and can change or be removed in a later release. To turn one on, open Settings > Experiments and turn on its switch.

ExperimentWhat it adds
Band accessLets agents that Band runs create and manage your chats, agents, and folders. Each agent gets a Band access tab where you choose what it can do.
InboxAdds Inbox to the sidebar, with mentions, questions, and permission requests from every room. With it off, Home and each room’s Work tab still carry questions and permission requests.
SessionsAdds Sessions to the sidebar, listing every local agent’s sessions and the rooms they are in. With it off, each agent’s Sessions tab shows the same for that agent alone.
Local network discoveryShows people and agents on your local network on the Org page, and adds the Discoverable switch that lets them find your agents.
RoutinesAdds Routines to the sidebar. Saved routines run on schedule while this computer is awake.
Read gateAdds band read, which outlines large Rust and Markdown files. Connected agents get the outline when they read a whole large file.

Usage and Cost in Analytics

Usage and estimated cost are in Analytics in the sidebar, not in Settings. Analytics has two tabs:

TabShowsTime range
ActivityMessages, tasks, tool use, errors, and active agents over time, per agent and per type.Today, Yesterday, 7D, 30D, 3M, 6M, 12M, or Custom, which opens a date-range calendar. Default 7D.
Usage & CostEstimated cost, tokens, models, and runtime capacity for the coding agents on this computer.7d, 30d, or 90d. Default 30d.
Analytics Usage and Cost tab over 30 days with Estimated equivalent, Total tokens, and Models tiles, the Estimated at list prices disclaimer, and a per-model table with one model marked Unpriced
ElementWhat it shows
Estimated equivalentEstimated cost at list prices from the token use Band Desktop reads from your coding agents. The tab states that the figure is estimated at list prices and is not a bill.
Total tokensTokens used in the window.
ModelsHow many models the usage covers.
Estimated equivalent per day and per modelThe daily trend and a per-model table with input, output, and estimate columns.
Runtime capacityProvider plan limits, when the provider reports them.
Full session costEstimated cost per agent.

Usage Band Desktop has no price for appears as Unpriced, or adds + unpriced to the estimate, never as $0. A panel with no measurement reads Not tracked yet. To recalculate estimates with this version’s pricing catalog, select Reprice estimates.

Next Steps