Skip to content

[FEATURE]: Add tui.tips configuration option to disable input placeholder hints #10571

@jowitte

Description

@jowitte

Feature description

Add a tui.tips configuration option to opencode.json that allows users to disable the placeholder hints ("Ask anything: Ask a question, move files, explore your code...") in the input field.

Current behavior

The tips can only be toggled via keybind (<leader>h / Ctrl+X H). While this works and persists across restarts, it would be more convenient to configure this in opencode.json, especially for:

  • Users who prefer declarative configuration over runtime toggles
  • Sharing configurations across machines (opencode.json is typically version-controlled)
  • Corporate/team setups where consistent UX is desired

Proposed solution

Add a tips property to the tui configuration section:

{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "tips": false
  }
}

Alternatives considered

The current keybind approach works but requires manual action on each new installation/machine.

Additional context

The tui section already supports scroll_speed, scroll_acceleration, and diff_style. Adding tips would follow the same pattern for UI customization options.

Metadata

Metadata

Assignees

Labels

opentuiThis relates to changes in v1.0, now that opencode uses opentui

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions