-
Notifications
You must be signed in to change notification settings - Fork 32
Description
Problem
The managed agentboard tmux session (configured via TMUX_SESSION, default agentboard) always appears in the session list. For users who only use agentboard to monitor external/discovered sessions, this empty shell session is noise — it's not an agent session, just agentboard's internal tmux session with a default zsh window.
Current behavior
In SessionManager.listWindows() (line 109) and sessionRefreshWorker.ts listAllWindows() (line 215), the managed session's windows are unconditionally included with source: 'managed'. There is no config option to suppress them.
DISCOVER_PREFIXES only controls external session discovery and has no effect on managed session visibility. AGENTBOARD_EXCLUDE_PROJECTS only filters inactive agent sessions, not the active session list.
Proposed solution
A new environment variable, e.g. AGENTBOARD_HIDE_MANAGED_SESSION=true, that filters out the managed session's windows before they reach the registry/frontend.
Minimal change in sessionRefreshWorker.ts around line 215:
if (sessionName === managedSession) {
if (config.hideManagedSession) continue
source = 'managed'
}And the equivalent guard in SessionManager.listWindows() around line 109.
Use case
Users running agentboard purely as a dashboard for agent sessions spawned by other tools (e.g. worktree managers, Claude Code, Codex). The managed session adds no value in the UI and takes up a slot in the session list.