[FEATURE]: Small screen compatibility #2343

Open
opened 2026-02-16 17:35:13 -05:00 by yindo · 4 comments
Owner

Originally created by @tnglemongrass on GitHub (Oct 29, 2025).

Feature hasn't been suggested before.

  • I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

As a developer I would like to use OpenCode from inside the VSCode build-in terminal, in order to avoid excessive context switching. VSCode is essential part of my workflow, to review the changes made by the ai.

Current Behavior (available terminal height of 10 lines):

  • On Welcome screen:
    • From top to bottom, only the big OpenCode logo and two of the help lines /new, /help are visible.
    • The user input is not visible.
    • I can still type my request blindly, press enter, and it works (it's just a visual bug).
  • On Chat screen:
    • header has an empty padding line above
    • chat output is not visible at all
    • The user input occupies three lines, plus one more for model info, plus another one as empty spacer below
    • footer is not visible (good)

Expected Behavior:

  • User input field should be visible on Welcome screen.
  • Chat output should be visible on Chat screen.
  • The Ui may collapse gracefully, hiding less important elements, or replacing them by smaller variants.

Notes:

  • Small height is much more important than small width.
  • Request is about usage on a 14 inch notebook which has 1280x800 effective pixels.
  • Increasing terminal height would cut into the actual VsCode diff view.
  • 'Typical' terminal applications like bash, vim or tmux work are perfectly useable under the same conditions.
Originally created by @tnglemongrass on GitHub (Oct 29, 2025). ### Feature hasn't been suggested before. - [x] I have verified this feature I'm about to request hasn't been suggested before. ### Describe the enhancement you want to request As a developer I would like to use OpenCode from inside the VSCode build-in terminal, in order to avoid excessive context switching. VSCode is essential part of my workflow, to review the changes made by the ai. Current Behavior (available terminal height of 10 lines): - On Welcome screen: - From top to bottom, only the big OpenCode logo and two of the help lines /new, /help are visible. - The user input is not visible. - I can still type my request blindly, press enter, and it works (it's just a visual bug). - On Chat screen: - header has an empty padding line above - chat output is not visible at all - The user input occupies three lines, plus one more for model info, plus another one as empty spacer below - footer is not visible (good) Expected Behavior: - User input field should be visible on Welcome screen. - Chat output should be visible on Chat screen. - The Ui may collapse gracefully, hiding less important elements, or replacing them by smaller variants. Notes: - Small height is much more important than small width. - Request is about usage on a 14 inch notebook which has 1280x800 effective pixels. - Increasing terminal height would cut into the actual VsCode diff view. - 'Typical' terminal applications like bash, vim or tmux work are perfectly useable under the same conditions.
yindo added the discussion label 2026-02-16 17:35:13 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Oct 29, 2025):

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

  • #2428: Similar terminal width rendering issues when using opencode in tmux vertical panes with constrained space
  • #3271: Cursor positioning problems when terminal is resized to certain dimensions, affecting usability in small terminal windows
  • #445: Layout issues when running opencode in embedded terminal environments (neovim), showing similar problems with constrained vertical space
  • #532: TUI usability problems in IDE terminals (IntelliJ), indicating broader compatibility issues with integrated terminal environments
  • #1107: Request for more efficient vertical space usage by reducing blank lines and headers - directly related to small screen optimization
  • #2750: Request for compact UI mode and customization options for better accessibility and space efficiency

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Oct 29, 2025): This issue might be a duplicate of existing issues. Please check: - #2428: Similar terminal width rendering issues when using opencode in tmux vertical panes with constrained space - #3271: Cursor positioning problems when terminal is resized to certain dimensions, affecting usability in small terminal windows - #445: Layout issues when running opencode in embedded terminal environments (neovim), showing similar problems with constrained vertical space - #532: TUI usability problems in IDE terminals (IntelliJ), indicating broader compatibility issues with integrated terminal environments - #1107: Request for more efficient vertical space usage by reducing blank lines and headers - directly related to small screen optimization - #2750: Request for compact UI mode and customization options for better accessibility and space efficiency Feel free to ignore if none of these address your specific case.
Author
Owner

@rekram1-node commented on GitHub (Oct 29, 2025):

we are currently rewriting the tui and it may better address some of this, feel free to try it (still a wip): bun x opencode-ai@opentui

@rekram1-node commented on GitHub (Oct 29, 2025): we are currently rewriting the tui and it may better address some of this, feel free to try it (still a wip): `bun x opencode-ai@opentui`
Author
Owner

@tnglemongrass commented on GitHub (Oct 29, 2025):

Thanks, will try it!

@tnglemongrass commented on GitHub (Oct 29, 2025): Thanks, will try it!
Author
Owner

@ratacat commented on GitHub (Feb 1, 2026):

Just a note: the suggested bun x opencode-ai@opentui tag no longer resolves ("Package opencode-ai with tag opentui not found").

Adding another use case here: when using OpenCode in a small/split terminal window, both the header bar and input bar take up a disproportionate amount of vertical space. A config option like tui.compact_mode: true or granular tui.header_height / tui.input_height settings would be very helpful for constrained environments.

Currently the only TUI config options are scroll-related (scroll_speed, scroll_acceleration, diff_style) - nothing for layout/sizing.

@ratacat commented on GitHub (Feb 1, 2026): Just a note: the suggested `bun x opencode-ai@opentui` tag no longer resolves ("Package opencode-ai with tag opentui not found"). Adding another use case here: when using OpenCode in a small/split terminal window, both the **header bar** and **input bar** take up a disproportionate amount of vertical space. A config option like `tui.compact_mode: true` or granular `tui.header_height` / `tui.input_height` settings would be very helpful for constrained environments. Currently the only TUI config options are scroll-related (`scroll_speed`, `scroll_acceleration`, `diff_style`) - nothing for layout/sizing.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#2343