[Feature Request] Migrate Claude Code to Toad Terminal UI Framework

Resolved 💬 10 comments Opened Aug 27, 2025 by BeeegZee Closed Jan 15, 2026

Feature Request Summary

Replace Claude Code's current terminal interface with Will McGugan's Toad framework to resolve critical UX issues and provide a modern, responsive terminal experience.

Current Problems with Existing UI

Critical Performance Issues

  • View races/teleports up and down the buffer uncontrollably, requiring session termination
  • Scrolling becomes painfully slow after large sessions or compaction
  • UI jumps to buffer start automatically every ~15 seconds during work
  • Terminal "jumps" and "skips" with multiple terminals or certain shells (fish)

Text Input/Output Issues

  • Multi-line pastes get truncated or freeze the CLI entirely
  • Copied text gains unwanted formatting characters
  • Bracketed-paste mode corrupts text input
  • Text selection copies unwanted line numbers/prefixes

Accessibility Concerns

  • Current terminal-first UI favors Vim/Emacs/power-terminal users
  • Not friendly to developers using standard terminal environments

Proposed Solution: Toad Integration

Technical Benefits

  • Flicker-free updates: Partial region updates as small as single characters eliminate visual disruptions
  • Enhanced text interaction: Proper text selection and copying without formatting corruption
  • Architectural separation: Front-end (Python/Textual) separated from back-end for better maintainability
  • Performance optimization: Smooth scrolling, minimal startup overhead (~100ms)
  • Cross-platform compatibility: Works efficiently on low-power devices

User Experience Improvements

  • Stable viewport: Eliminates buffer racing and unwanted scrolling
  • Reliable paste operations: Proper handling of multi-line content
  • Clean text copying: No extra formatting or line number artifacts
  • Responsive interface: Consistent performance across different terminal environments

Advanced Features

  • Interactive UI elements (contextual menus, inline editing)
  • Real-time streaming of markdown responses
  • JSON-based communication protocol for extensibility
  • Potential for future multi-platform interfaces

Expected Impact

Immediate Benefits

  • Elimination of current critical UX bugs
  • Improved accessibility for all developer types
  • Reliable text input/output operations

Long-term Benefits

  • Modern, maintainable codebase architecture
  • Foundation for future UI enhancements
  • Better cross-platform compatibility

Technical Implementation Details

Toad Framework Advantages

  • Built with Textual for advanced terminal UI capabilities
  • Separates front-end presentation from back-end processing
  • Language-agnostic backend implementations possible
  • Minimal resource usage and fast startup times

Key Features to Implement

  1. Stable Buffer Management: Prevent unwanted scrolling and jumping
  2. Enhanced Text Operations: Proper multi-line paste, clean copy operations
  3. Responsive UI: Smooth scrolling and consistent performance
  4. Cross-Shell Compatibility: Works reliably with fish, zsh, bash, etc.

References

View original on GitHub ↗

This issue has 10 comments on GitHub. Read the full discussion on GitHub ↗