Skip to content

feat: option to hide the managed agentboard tmux session from the UI #89

@Danielalnajjar

Description

@Danielalnajjar

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions