---
title: tmux-shift-enter-fix
type: plan
permalink: dotfiles/plans/tmux-shift-enter-fix
tags:
- tmux
- terminal
- keybindings
---

# tmux Shift+Enter Fix

## Goal
Inside tmux, pressing Shift+Enter should insert a literal newline instead of submitting the command line.

## Decision
- [decision] Preserve tmux extended-keys support and apply the smallest possible fix at the tmux layer.
- [decision] Use `bind-key -n S-Enter send-keys "\n"` in `~/.tmux.conf` instead of disabling `extended-keys` or adding shell-specific bindings.

## Tasks
- [ ] Add a tmux root-table binding for `S-Enter`
- [ ] Verify tmux loads the config and exposes the expected binding
- [ ] Check documentation coverage for this config tweak

## Acceptance criteria
- `~/.tmux.conf` contains an explicit `S-Enter` binding that sends a newline.
- Existing `extended-keys` settings remain enabled.
- After sourcing the config, tmux shows the `S-Enter` root binding.

## Workstream
- Single workstream in the main repo working tree.

## Findings tracker
- None.

## Relations
- related_to [[knowledge]]