# Terminal client The Go terminal client lives in [`cli/internal/tui`](../cli/internal/tui/app.go). It uses Bubble Tea models and the daemon client. The [web client](web.md) is another client of the daemon. ## Application and screens [`AppModel`](../cli/internal/tui/app.go) owns navigation between chat, session selection, and other screens. `Update` routes messages to the relevant model and handles transitions such as opening the model picker, [webhooks](webhooks.md), and [Discord](discord.md) pages. [`listFrame`](../cli/internal/tui/frame.go) renders shared list-screen framing. [`pageStatus`](../cli/internal/tui/page.go) tracks loading and request generations for pages. Follow [Add or change a terminal screen](tui-contributing.md) for shared components, keyboard conventions, confirmation behavior, and stale-request handling. ## Chat and events [`ChatModel.Init`](../cli/internal/tui/chat_subscription.go) starts the stream subscription and status requests. The subscription delivers daemon events as Bubble Tea messages. Cancellation and stream termination are handled in the subscription code. Chat transcript state and rendering live in [`transcript_state.go`](../cli/internal/tui/transcript_state.go) and [`transcript.go`](../cli/internal/tui/transcript.go). [`chat_shell.go`](../cli/internal/tui/chat_shell.go) parses shell input, submits commands through the daemon client, and updates their output in chat. Shell output is external content, not an instruction to the model. ## Reasoning controls Chat headers and the model picker prefer the catalog's display name. The session's API ID remains unchanged. The chat loads names through the [session-bound model catalog](../cli/internal/daemon/models.go) when it opens or its model or provider changes. Late replies must match the chat generation, session, provider, and model before changing the displayed name. Missing names or failed reads fall back to the ID. The same read retains model and profile reasoning defaults so inherited chat headers show the effective level. Unknown levels display Provider default. Unsupported profile levels remain visible in the selectors with an unsupported warning and a model-default bypass. The [model picker](../cli/internal/tui/model_picker.go) separates the effective reasoning level from its source in the details pane. Left and Right choose a level, with the actual default annotated. Ctrl+X resets the staged choice to the profile/model default. When the profile has an override, Ctrl+T switches the staged choice between the profile and model default. Enter applies the choice only to this session. Escape cancels it. Ctrl+S separately asks to apply and save the selected model and reasoning for the named profile. Confirming changes that profile without changing the starting profile. The [chat selector](../cli/internal/tui/effort_selector.go), opened with `/effort`, uses a vertical list. The actual default level is annotated instead of appearing as a separate row. Up and Down preview levels, Ctrl+X resets to default, and Ctrl+T switches the default source when a profile override exists. Previewing does not save the choice. Enter applies it and Escape restores the composer. The list keeps the highlight visible in short terminals. [Models](models.md#reasoning-defaults) owns the saved choice and provider resolution contract. ## Moving a session `/cd` to another host's folder opens the [question box](../cli/internal/tui/cd_question.go). It asks the daemon's preflight, and [`cd_move.go`](../cli/internal/tui/cd_move.go) starts and follows the move when the user chooses yes. An unavailable preflight shows its reason under yes and offers only no. A target that can't take this daemon's data refuses in the preflight or when a move reaches staging. `cdRefusal` reads three codes for a person: - `transfer_target_older`: "The target daemon is older than this one and can't accept this session. Update albedo on _host_." - `transfer_extension_unavailable`: an extension this session uses failed to load there. It gives no update advice. - `transfer_unsupported`: the target may be older, or one of its extensions failed to load there. An older target can't say which. The target's own words, which name what it lacks, stay below in faint text for debugging. Other refusals show their reason as it came. The shot gallery's `cd` screen covers these states. The rules behind the codes are in [moves between versions](workspaces.md#moves-between-versions). ## Screens and tests Screen-specific models and rendering live beside the application model. For example, [`webhooks_page.go`](../cli/internal/tui/webhooks_page.go) and [`discord_page.go`](../cli/internal/tui/discord_page.go) implement their respective pages. Screenshot fixtures and tests live in the same package, including [`shot_chat_test.go`](../cli/internal/tui/shot_chat_test.go). The [Go client boundary](../docs/client-api.md) owns typed daemon operations and transport recovery. Follow [Change the HTTP API](../docs/contributing-api.md) when a screen needs a new public operation. ## Related pages - [All topics](README.md) - [Change guidance](contributing.md) - [Web client](web.md) - [Session attachment](sessions.md) - [Workspaces](workspaces.md)