Skip to content

docs(tui): note transparent mode assumes a dark terminal - #4711

Draft
icn5381 wants to merge 1 commit into
bytedance:mainfrom
icn5381:docs/tui-transparent-dark-terminal-4631
Draft

docs(tui): note transparent mode assumes a dark terminal#4711
icn5381 wants to merge 1 commit into
bytedance:mainfrom
icn5381:docs/tui-transparent-dark-terminal-4631

Conversation

@icn5381

@icn5381 icn5381 commented Aug 6, 2026

Copy link
Copy Markdown

The transparent override keeps the truecolor foreground palette, which is calibrated for dark terminal backgrounds. State that assumption next to --tui-transparent / DEER_FLOW_TUI_TRANSPARENT so it is discoverable before the mode is flipped on; on a light-background terminal those foregrounds may render with low contrast.

Suggested in the #4631 review.

References #4631

Fixes #

Why

What changed

Surface area

  • Frontend UI — page / component / setting / interaction under frontend/
  • Backend API — endpoint / SSE event / request-response shape under backend/app
  • Agents / LangGraph — agent node, graph wiring, langgraph.json, or prompt change
  • Sandboxdocker/ or sandboxed execution
  • Skills — change under skills/
  • Dependencies — new/upgraded entry in backend/pyproject.toml or frontend/package.json (say what it buys us)
  • Default behavior change — changes existing behavior without the user opting in (default model, default setting, data shape)
  • Docs / tests / CI only — no runtime behavior change

Screenshots / Recording

Bug fix verification

Validation

AI assistance

Tool(s) used:

How you used it:

  • I've read and understand every line of this change and take responsibility for it — it's not unreviewed AI output.

The transparent override keeps the truecolor foreground palette, which is
calibrated for dark terminal backgrounds. State that assumption next to
--tui-transparent / DEER_FLOW_TUI_TRANSPARENT so it is discoverable before the
mode is flipped on; on a light-background terminal those foregrounds may render
with low contrast.

Suggested in the bytedance#4631 review.

References bytedance#4631
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant