Hmbown/DeepSeek-TUI

DEC 2026 synchronized-output wrap + `CODEWHALE_TUI_DEBUG=1`

Open

#2,085 opened on May 25, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Rust (29,199 stars) (2,435 forks)batch import
autonomous-readydocumentationenhancementgood first issuerust

Description

Shape. Wrap ratatui's Backend::flush with DEC 2026 BSU/ESU sequences (\x1b[?2026h / \x1b[?2026l) to eliminate tearing on iTerm2 + ghostty. Add CODEWHALE_TUI_DEBUG=1 that logs per-frame render diffs to ~/.deepseek/logs/tui-render.log. ~70 lines total. Wins independent of any other work in this slate.

Existing issues this resolves on PR merge

Partially addresses:

  • Partially addresses #1556
  • Partially addresses #1812
  • Partially addresses #1927

When opening a PR for this issue, the PR body must include the Closes #N lines for every issue above that this PR fully resolves, so they auto-close on merge.

Slate item 12/18. Tracking doc: .private/issue-slate.md (maintainer-only).

Contributor guide

Tech stack
rust
Domain
cliperformance
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Rustratatuiterminal escape sequences
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
The main task is to modify the ratatui Backend flush to wrap it with DEC 2026 BSU/ESU escape sequences. Look for the backend implementation in the TUI codebase, likely in src/tui.rs or a similar file. Add an environment variable check for CODEWHALE TUI DEBUG in the main entry point; if set, initialize a file logger writing to ~/.deepseek/logs/tui render.log with per frame render diffs. Keep the changes localized to around 70 lines.