← All docs

DOCS

  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
DOCS
  1. Getting Started
  2. Configuration
  3. Tools
  4. Sessions
  5. Compaction & Branch Summarization
  6. Subagents
  7. Extensions
  8. Themes
  9. Memory System
  10. Skills
  11. Code intelligence (LSP)
  12. Termux Support
  13. Environment variables
  14. Custom Providers
  15. JSON Event Stream Mode
  16. Keybindings
  17. Prompt Templates
  18. RPC Mode
  19. Session File Format
  20. Shell Aliases
  21. Terminal Setup
  22. tmux Setup
ON THIS PAGE
  1. Kitty, iTerm2
  2. Ghostty
  3. WezTerm
  4. VS Code (Integrated Terminal)
  5. Apple Terminal

Terminal Setup

Neo Code uses the Kitty keyboard protocol for reliable modifier key detection. Most modern terminals support this.

#Kitty, iTerm2

Work out of the box.

#Ghostty

Add to your Ghostty config:

keybind = alt+backspace=text:\x1b\x7f

#WezTerm

Create ~/.wezterm.lua:

local wezterm = require 'wezterm'
local config = wezterm.config_builder()
config.enable_kitty_keyboard = true
return config

#VS Code (Integrated Terminal)

Add to keybindings.json to enable Shift+Enter for multi-line input:

[
  {
    "key": "shift+enter",
    "command": "workbench.action.terminal.sendSequence",
    "args": { "text": "\u001b[13;2u" },
    "when": "terminalFocus"
  }
]

#Apple Terminal

Neo Code enables enhanced key reporting when available. If Terminal.app sends plain Return for Shift+Enter, a local macOS modifier fallback is used.

This fallback only works when Neo Code runs on the same Mac as Terminal.app.

ON THIS PAGE

  1. Kitty, iTerm2
  2. Ghostty
  3. WezTerm
  4. VS Code (Integrated Terminal)
  5. Apple Terminal
Previous← Shell AliasesNexttmux Setup →

Neo Code

Neosantara-first AI coding agent for your terminal.

Product

  • Docs
  • Pricing
  • GitHub

Neosantara

  • Dashboard
  • API

Legal

  • Terms
  • Privacy

2026 Neosantara. All rights reserved.