[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
- Stable Buffer Management: Prevent unwanted scrolling and jumping
- Enhanced Text Operations: Proper multi-line paste, clean copy operations
- Responsive UI: Smooth scrolling and consistent performance
- Cross-Shell Compatibility: Works reliably with fish, zsh, bash, etc.
References
- Toad announcement: https://willmcgugan.github.io/announcing-toad/
- Toad in its end-of-July state https://www.youtube.com/watch?v=EKsCS54xduo
- Textual framework: https://github.com/Textualize/textual
This issue has 10 comments on GitHub. Read the full discussion on GitHub ↗