feat(tui): add header visibility toggle

[hiromesh]

Add option to toggle session header visibility in TUI. Fixes #7536

The header shows session title, token usage, and cost at the top of the session view. Users can now hide it via command panel (ctrl+p).

Changes:

• Added header_visible config stored in KV
• Added "Hide header/Show header" command in Session category

How to test:

1. Run opencode and start a session
2. Press ctrl+p to open command palette
3. Search "header" or browse to Session category
4. Select "Hide header" to toggle visibility

[github-actions]

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

1. Open an issue describing the bug/feature (if one doesn't exist)
2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

No duplicate PRs found

[jasonish]

@hiromesh If you rebase, I'll test.

[hiromesh]

@hiromesh If you rebase, I'll test.

done

[jasonish]

Not sure if this is just an artifact of my local build, but I'm seeing:

But it does toggle it on and off.

[hiromesh]

Not sure if this is just an artifact of my local build, but I'm seeing:

But it does toggle it on and off.

Thanks for catching that! Indeed session.toggle.header was defined twice (lines 554-562 and 563-571),
which could cause the command palette to display incorrectly. Removed the duplicate definition.

[jasonish]

Yes, better now.

I do prefer having the menu option vs my config setting. Makes working on a shorter terminal much much better.

[hiromesh]

Yes, better now.

I do prefer having the menu option vs my config setting. Makes working on a shorter terminal much much better.

Thanks for the review! glad you find it useful.

[MSmaili]

I would love it if this PR were merged.

I’d like the header to be hidden most of the time, especially on small screens where it takes up a lot of space. In practice, you usually only need to check the context usage and occasionally the money spent.

One idea for the context usage, which I liked from other ai-tool (is done by kiro-cli)

They show on the side how much context has been used. Useful and takes up less space. IMO, space is important; fewer things lead to better/cleaner UI.

[hiromesh]

Yes, better now.

I do prefer having the menu option vs my config setting. Makes working on a shorter terminal much much better.

Hi @jasonish , any update on this pr? Let me know if you need anything else from me

[jasonish]

Yes, better now.
I do prefer having the menu option vs my config setting. Makes working on a shorter terminal much much better.

Hi @jasonish , any update on this pr? Let me know if you need anything else from me

It's up to the OpenCode team now. Not having this actually keeps me from using OpenCode as much as I might.

[jasonish]

Apparently, a more minimal cli/tui is in the works? https://x.com/thdxr/status/2020715330289778956. Which might mean this isn't really needed. But still a nice to have.

[hiromesh]

Apparently, a more minimal cli/tui is in the works? https://x.com/thdxr/status/2020715330289778956. Which might mean this isn't really needed. But still a nice to have.

That minimal TUI looks exciting! While that's in the works, this toggle still feels like a solid 'nice to have' for users who want to clear some vertical space right now.

Also, just an update: based on Ariane Emory's feedback on Discord, I’ve moved the toggle to the 'System' section in the command palette to keep it consistent with the other persistent menu items. Thanks again for the review!

[jasonish]

Also, just an update: based on Ariane Emory's feedback on Discord, I’ve moved the toggle to the 'System' section in the command palette to keep it consistent with the other persistent menu items. Thanks again for the review!

Sounds good. I was happy with just having to manually edit the config as its a set once and forget setting for me. Will try to test your change in the next day or so.

[hiromesh]

Sounds good. I was happy with just having to manually edit the config as its a set once and forget setting for me. Will try to test your change in the next day or so.

Thanks for testing, appreciate it!

[jasonish]

Fixed by #13244. It's too bad prior work was referenced.