[FEATURE]: TUI setting to show tool calls expanded by default #51308

Activity

1. github-actions

   assigned

   simonklee

   on Sep 25, 2026
2. github-actions commented on Sep 25, 2026

   

   github-actionsBot

   on Sep 25, 2026 – with GitHub Actions

   Contributor

   More actions

   ---

   This issue might be a duplicate of existing issues. Please check:

   • tui: no setting to always expand tool call arguments and output in the session transcript #50220: Direct request for a TUI setting to always expand tool-call arguments and output by default.
   • [FEATURE]: Document tool-call visibility toggles in the opencode2 (V2) TUI and add a keybind + config default for hiding tool details #45872: Related V2 TUI request for configurable default tool-detail visibility.
   • [FEATURE] TUI: configurable reasoning bubbles and tool output collapsing #51229: Related request for configurable tool-output collapsing in the TUI.
3. opencodejr commented on Oct 28, 2026

   

   opencodejrBot

   on Oct 28, 2026

   More actions

   Thanks for the request and for checking the source! To restate it: you'd like a TUI setting, e.g. under session in cli.json, that shows tool calls (shell, MCP and other tools) expanded by default. That way you can see what ran without clicking each row.

   You're right that the TUI doesn't offer this today: standalone tool calls always start collapsed, and session.verbosity: "high" only opens exploration and instruction groups. This also can't be done as a plugin yet, because TUI plugins can't change how tool rows are rendered or whether they start expanded. Maintainers will consider it.

   Related issues:

   • [FEATURE] TUI: configurable reasoning bubbles and tool output collapsing #51229: configurable tool display (expand/collapse/hidden)
   • [FEATURE]: Explicit setting to keep shell output and error/failed output collapsed #55089: the opposite request, a setting to keep shell and error output collapsed
   • [FEATURE]: Document tool-call visibility toggles in the opencode2 (V2) TUI and add a keybind + config default for hiding tool details #45872: earlier request for a config default for tool details in v2 (closed; tool display was moved to session.verbosity / session.grouping)
   • [UX]: web/desktop: user shell commands entered with ! are rendered collapsed like agent tool calls; output should be visible by default #58062: shell output visible by default in web/desktop
4. Epslion404 commented on Nov 10, 2026

   

   Epslion404

   on Nov 10, 2026

   Last edited by Epslion404

   More actions

   Same class of request, but for the nested child calls of execute (Code Mode) — those aren't covered by the standalone-tool case in this issue, and they're a separate component.

   execute streams its children through metadata.toolCalls and renders one ExecuteCallView per child, so a single collapsed execute row can hide dozens of ssh.run / read calls.

   Verified against dev today (running opencode 2.2.5):

   • packages/tui/src/routes/session/index.tsx
     • Execute (L3410) → executeCalls(props.metadata.toolCalls) → ExecuteCallView per child.
     • ExecuteCallView (L3357): const [expanded, setExpanded] = createSignal(false) (L3360) — local signal, nothing reads config for it.
     • The only way to toggle is onMouseUp → setExpanded((value) => !value) (L3376–3379). No command or keybind exists for it (checked the full command list: only session.toggle.thinking, session.toggle.exploration_grouping, session.verbosity.cycle, session.background touch tool display).
     • Collapsed text is executeCallSummary(props.call()) → packages/tui/src/util/tool-display.ts:35 = tool + primitiveInputSummary(input). Expanded text drops the summary entirely and shows the bare tool name plus an indented key: value block.
   • session.verbosity: "high" does not affect these rows. It only feeds the group default:
     groupExpanded(id, kind) ?? (verbosity === "high" && (kind === "exploration" || kind === "instructions")).
     Reproduced: Medium → High leaves every execute child row collapsed, because these rows aren't part of an exploration/instruction group.

   Smallest change that fits the existing conventions:

   1. Add a key next to session.verbosity in packages/tui/src/config/index.tsx (struct at L152–186):
      tool_expansion: Schema.optional(Schema.Literals(["auto", "always"])), described as "Start tool call rows expanded instead of collapsed", default auto = today's behavior.
   2. Read it where the row component can already reach it: the session route calls useConfig() and derives its display defaults at L244–249 (config.session?.thinking, config.session?.verbosity). Same pattern, no new plumbing.
   3. Use it as the initial value only: createSignal(config.session?.tool_expansion === "always"). The per-row click toggle stays authoritative, so users can still collapse an individual row.

   The same one-line seam exists in the other two collapsed-by-default tool rows, if you'd rather have one setting cover all tool calls: GenericTool (L2742) and ShellDisplay (L3026). TurnTokenUsage (L1749) is a token table, not a tool row — probably out of scope.

   Environment: opencode 2.2.5, Windows 11 (26100), Windows Terminal.