[DOCS] Channels docs omit connection persistence across agent view, `/bg`, `/tui`, and update transitions

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/channels
https://code.claude.com/docs/en/channels-reference
https://code.claude.com/docs/en/agent-view

Section/Topic

Channel connection lifecycle and persistence across UI/session transitions.

Current Documentation

The channels docs explain how to start channels and receive events while a session is open, but do not document expected persistence across agent view, backgrounding, /tui, or update transitions.

The agent view docs explain that several launch/configuration flags carry through to a backgrounded session, but do not mention --channels or channel connection persistence.

What's Wrong or Missing?

Claude Code v2.1.187 fixed channel connections dropping after navigating to the agents view and back, and after /bg, /tui, or /update.

The docs do not state whether channel connections are expected to remain connected across these transitions, nor how users should reason about channel lifecycle during backgrounding, returning to TUI, or updating/relaunching Claude Code.

Suggested Improvement

Add a short lifecycle section to the Channels docs:

Channel connections remain active across common session transitions such as opening the agents view and returning, backgrounding with /bg, returning to the terminal UI with /tui, and updating/relaunching with /update. If a channel disconnects during these transitions, reconnect it or upgrade to Claude Code v2.1.187 or later.

Also mention --channels in the agent-view section that describes which session options persist after backgrounding.

Impact

Medium - Makes feature difficult to understand

Additional Context

v2.1.187 changelog context: Fixed channel connections dropping after navigating to the agents view and back, and after /bg, /tui, or /update.

Duplicate search found no direct duplicate for channel connections dropping across agent view, /bg, /tui, or update.