Shift-return does not input newline since 1.0

Description

I cannot enter newlines with shift-return since Opencode 1.0

Worked fine before, without any custom mapping in Ghostty to ctrl-j or whatever. Also does not work in macOS Terminal app.

I have no custom Ghostty or Opencode keybinds that could be interfering.

OpenCode version

1.0.40

Steps to reproduce

opencode
type something{shift-return} (nothing happens)

Screenshot and/or share link

No response

Operating System

macOS

Terminal

Ghostty (with or without Tmux)

This issue might be a duplicate of existing issues. Please check:

shift+enter keybinding not working #1505: shift+enter keybinding not working - This appears to be the same exact issue with shift+enter not inserting newlines while ctrl+j works as an alternative. Issue shift+enter keybinding not working #1505 includes detailed technical analysis of the root cause.

Feel free to ignore if none of these address your specific case.

Workaround for now in Ghostty config:

keybind = shift+enter=text:\x1b[13;2u

In case you are facing an issue with Ghostty and Tmux, here is my workaround

Should be fixed in the latest version

I have tried every version of this, ctrl+enter, cmd+enter, shift+enter, \ then enter. None of them work for me in v1.0.55

ctrl + j works but that is incredibly awkward.

I'm on mac OS using the default terminal.

Default MacOS terminal does not send any modifiers for return/backspace, there is no way to capture that shift is pressed along with return. You need to use a modern terminal like Ghostty, Kitty or Alacritty.

I figured that might be the response, but that doesn't explain why \ +enter wouldn't work or why cmd+enter (used to) work in Claude Code. I guess I'll upgrade to a big boy terminal.

There are probably some more tricks we can implement, or use native OS key events as a workaround. None of that works currently though I am afraid. I'll look some more into it.

how does this look on 1.0.59?

No change on 1.0.61

I hope you don't mind I share some information.
This works only with the alt+enter:

"input_newline": "shift+enter,alt+enter"

I also noticed that the default cycling model only works with f2 and the reverse wouldn't with shift+f2. So far I can see cycling agents with tab and shift+tab is consistent with the default bindings. There might be something going on with handling the shift key.

Edit: my current version is v1.0.61

Default MacOS terminal does not send any modifiers for return/backspace, there is no way to capture that shift is pressed along with return. You need to use a modern terminal like Ghostty, Kitty or Alacritty.

I'm using (linux) alacritty+zellij, and see the same behavior, c-j works but not anything else. keybindings:

    "leader": "ctrl-x"
    "input_clear": "<leader>del",
    "input_paste": "ctrl+v",
    "input_submit": "<leader>enter",
    "input_newline": "shift+enter",

With those bindings, leader setting works for other actions, browsing subagents/tasks:

shift-enter: NA
enter: input_submit
ctrl-x enter: NA
ctrl-j: input_newline

Alacritty setting:

bindings = [
    # { key = "Key", mods = "Modifiers", action = "Action" },
    # { key = "Key", mods = "Modifiers", chars = "Characters to send" },
    # ...
    { key = "F",      mods = "Control|Shift", chars = "\u001b[70;5;2u"}
]

Zellij setting:

keybinds clear-defaults=true {
      unbind "Ctrl Shift f"
      unbind "Shift Enter"
      unbind "Shift Return"
....
}

The confusion is from input handling I guess. Line feed \n is usually enter, while \r is return, these are two different inputs. A keybinding like shift+linefeed would actually work, but effectively both would do the same. I'll go with the alias.

v1.0.109

The following result it the text being submitted (linux, alacritty, zellij):

"input_newline": "shift+return"

and

"input_newline": "shift+linefeed"

@kommander

The Alacritty workaround suggested here (#1505 (comment)), allowed me to input a newline with this keybinding:

    # borked: return, enter, linefeed
    "input_submit": "<leader>return",
    # Alacritty workaround: { key = "Return", mods = "Shift", chars = "\n" }
    "input_newline": "shift+return",

@kommander do you consider the Alacritty change a fix or a workaround?

If the default is still enter it's not fixed, no

I have the same issue with windows terminal.
But alacritty on windows works.

@vlabo

@vlabo see docs: https://opencode.ai/docs/keybinds/#shiftenter

Here's what worked for me on ghostty:

keybind = shift+enter=text:\x1b\r

I run into this issue frequently.

Opencode: 1.1.23
vscode integrated terminal (vscode remote ssh, host=macOS tahoe, guest=ubuntu server)

(I appreciate that workarounds may be possible but this should be fixed in opencode itself yeah?)

Update: According to my research shift+enter actually cannot usually be detected in the terminal, so for most people the answer would be 'it can't be done in your terminal'.

Possibly though, with the rise of ai coding tui's like opencode, popular terminals like vscode's integrated terminal should add a little fairy dust to make this work.

For anyone trying to find a solution in VSCode integrated terminal, I write this to my keybinding.json of VSCode (no modify opencode):

    {  // deal with VSCode integrated terminal sending Ctrl/Shift+Enter as Enter issue
        "key": "shift+enter",
        "command": "workbench.action.terminal.sendSequence",
        "args": { "text": "\u001b\n" }, // rebind shift+enter to alt+enter behavior
        "when": "terminalFocus"
    },
    {
        "key": "ctrl+enter",
        "command": "workbench.action.terminal.sendSequence",
        "args": { "text": "\u001b\n" }, // rebind ctrl+enter to alt+enter behavior
        "when": "terminalFocus"
    }

And be sure your terminal.integrated.sendKeybindingsToShell in VSCode settings.json is false (default value).

Env:
opencode 1.1.49
Vscode integrated terminal (by vscode remote ssh, ubuntu linux as server, windows as local machine).

Now your terminal (including opencode) will be as expected —— ctrl/shift+enter as newline, and single enter as send.

Still the same issue on Lubuntu 24.04 QTerminal.

To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Navigation Menu

Repository navigation

Shift-return does not input newline since 1.0 #4046

Description

OpenCode version

Steps to reproduce

Screenshot and/or share link

Operating System

Terminal

7 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Shift-return does not input newline since 1.0 #4046

Description

Description

OpenCode version

Steps to reproduce

Screenshot and/or share link

Operating System

Terminal

Activity

github-actions commented on Nov 7, 2025

markjaquith commented on Nov 7, 2025

anaetrezve commented on Nov 8, 2025

kommander commented on Nov 8, 2025

mattnico commented on Nov 10, 2025

kommander commented on Nov 10, 2025

mattnico commented on Nov 11, 2025

kommander commented on Nov 11, 2025

thdxr commented on Nov 12, 2025

mattnico commented on Nov 12, 2025

arsham commented on Nov 12, 2025

7 remaining items

taqtiqa-mark commented on Nov 25, 2025

taqtiqa-mark commented on Nov 25, 2025

taqtiqa-mark commented on Nov 25, 2025

kommander commented on Nov 25, 2025

vlabo commented on Jan 3, 2026

rekram1-node commented on Jan 4, 2026

alekscp commented on Jan 7, 2026

voltrevo commented on Jan 16, 2026

voltrevo commented on Jan 16, 2026

crd2333 commented on Feb 3, 2026

wbartussek commented on Mar 10, 2026

github-actions commented on Jul 3, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions