A TextBox input mode for the terminal app cmux
Version 0.63.2-tb13 (Updated 2026/4/10)
Warning
On macOS 14 (Sonoma) / macOS 15 (Sequoia), versions prior to 0.62.2-tb7 have a bug where text typed in the TextBox is not displayed. Please select "Check for updates" from the "?" button in the bottom-left corner to update to the latest version.
English | 日本語はこちら
If you're not used to terminals, typing in one can sometimes feel awkward. Line breaks, selection, cut & paste — things you do without thinking — just don't work the way you expect. With this TextBox-enabled terminal, just type what you want. The standard terminal input is still there too, of course.
Two input modes sounds complicated? Don't worry — careful interaction design blends the boundary between them, so it all feels natural.💪
|
When the TextBox is empty, arrow keys, Tab, and Backspace pass through to the terminal.
Ctrl+key combinations (Ctrl+C, Ctrl+D, Ctrl+Z, etc.) and Escape are always forwarded regardless of content. |
|
|
Toggle the TextBox with a shortcut — focus moves smoothly between the input bar and terminal, so you can start typing right away.
You can choose "Toggle Display" or "Toggle Focus" in Settings. |
|
| The TextBox uses your OS-native text input. Arrow keys, selection, copy & paste — the same operations you're used to, just working. |
|
| Launch an agent, edit prompts, reply to questions, call "/" or "@" commands, interrupt a task — all without leaving the TextBox. Works with other terminal agents too, of course. |
|
| Send on Return or Shift+Return? What should ESC do? Customize it to fit your workflow. |
|
- Drag & drop paths — Drop files or folders into the TextBox to insert their path (planned)
- Tab completion in TextBox — For now, tab completion requires using the terminal input directly
Open the .dmg and drag cmux to your Applications folder.
git clone --recurse-submodules https://github.com/alumican/cmux-tb.git
cd cmux
./scripts/setup.sh
./scripts/reload.sh --tag textbox| Shortcut | Action |
|---|---|
| ⌘ ⌥ T (Cmd + Option + T) | Show/Hide TextBox (configurable) |
| Return | Send text to terminal (swappable with Shift+Return) |
| ⇧ Return (Shift + Return) | Insert newline (swappable with Return) |
| ESC | Focus terminal or send ESC key (configurable) |
All standard cmux shortcuts continue to work. See the cmux README for the full list.
| Setting | Default | Description |
|---|---|---|
| Enable Mode | On | Enable TextBox input |
| Send on Return | On | Return sends text, Shift+Return inserts newline (swap when off) |
| Escape Key | Send ESC Key | Action when pressing ESC (Focus Terminal / Send ESC Key) |
| Keyboard Shortcut (⌘⌥T) | Toggle Focus | Toggle Focus: switch focus between TextBox and terminal. Toggle Display: show/hide TextBox |
Same as cmux — AGPL-3.0-or-later.