Configuração do terminal

Configure seu terminal para aproveitar melhor a CLI do Cherri Code. Este guia aborda atalhos de teclado para entrada em várias linhas, modo Vim e sincronização de temas.

Início rápido

Se Shift+Enter não funcionar para inserir novas linhas no terminal, execute /setup-terminal para ver como configurar alternativas:

/setup-terminal

Este comando detecta seu terminal e fornece instruções para configurar Option+EnterAlt+Enter como uma alternativa para inserir novas linhas.

Opções universais

Estes métodos funcionam em todos os terminais, incluindo sessões do tmux, screen e SSH:

Suporte ao terminal

Suporte nativo a Shift+Enter

Estes terminais oferecem suporte a Shift+Enter para inserir novas linhas por padrão:

• iTerm2 (macOS)
• Ghostty
• Kitty
• Warp
• Zed (terminal integrado)

Requer /setup-terminal

Estes terminais precisam de /setup-terminal para configurar Option+EnterAlt+Enter para inserir novas linhas:

• Apple Terminal (macOS)
• Alacritty
• VS Code (terminal integrado)

Multiplexadores de terminal

tmux e screen interceptam Shift+Enter antes que ele chegue aos aplicativos. Use estas opções universais:

• Ctrl+J — Funciona de forma confiável em todas as sessões do multiplexador
• \+Enter — Também funciona em todos os casos

Modo Vim

Ative os atalhos de teclado do Vim para navegação e edição na área de entrada da CLI.

Alternar com o comando slash

/vim

Ativa ou desativa o modo Vim na sessão atual e salva a preferência.

Configure nas configurações

Adicione o seguinte ao seu ~/.cursor/cli-config.json:

{  "version": 1,  "editor": { "vimMode": true },  "permissions": { "allow": [], "deny": [] }}

Modos

O modo Vim usa edição modal:

• Modo normal — Navegue e execute comandos (padrão quando o modo Vim está habilitado)
• Modo de inserção — Digite texto normalmente

Pressione Esc para voltar ao modo normal a partir do modo de inserção.

Navegação

Edição

Entrando no modo de inserção

Contagens

Use um número antes dos comandos para repeti-los. Por exemplo, 3w avança 3 palavras, e 2dd exclui 2 linhas.

Tema do terminal

A CLI do Cherri Code detecta automaticamente o esquema de cores do terminal e ajusta sua aparência.

Detecção automática

A CLI consulta seu terminal para identificar a cor de fundo usando sequências de escape padrão. A maioria dos terminais modernos é compatível com isso:

• Terminais escuros → a CLI usa o tema escuro
• Terminais claros → a CLI usa o tema claro

Terminais com detecção automática

Estes terminais informam corretamente seu esquema de cores:

• iTerm2
• Ghostty
• Kitty
• Alacritty
• Apple Terminal
• Windows Terminal
• terminal integrado do VS Code

Forçar um tema

Se a detecção automática não funcionar, você pode substituí-la usando uma variável de ambiente:

# Forçar tema escuroexport COLORFGBG="15;0"# Forçar tema claroexport COLORFGBG="0;15"

Adicione isto ao perfil do seu shell (.bashrc, .zshrc etc.) para que a configuração seja permanente.

Solução de problemas com o tema

As cores parecem incorretas:

• Verifique se o terminal oferece suporte a 256 cores ou cores reais
• Verifique se TERM está configurado corretamente (por exemplo, xterm-256color)
• Tente definir COLORFGBG explicitamente

Usuários do tmux:

• Adicione o seguinte ao .tmux.conf para permitir a detecção de cores:

  set -g default-terminal "tmux-256color"
  set -ag terminal-overrides ",xterm-256color:RGB"
  

• Reinicie o tmux após fazer alterações

Configuração manual

Se /setup-terminal não funcionar no seu terminal, você poderá configurar manualmente os atalhos de teclado.

Option+Enter para inserir novas linhas

Option+EnterAlt+Enter envia uma sequência de escape especial que a CLI do Cherri Code reconhece como uma nova linha. Configure seu terminal para enviar \x1b\r (Escape seguido de retorno de carro) ao pressionar Option+EnterAlt+Enter.

iTerm2:

1. Abra Preferências → Perfis → Teclas → Mapeamentos de teclas
2. Clique em + para adicionar um novo mapeamento
3. Defina Atalho de teclado como Option+EnterAlt+Enter
4. Defina Ação como "Enviar sequência de escape"
5. Insira \r como sequência de escape

Alacritty:

Adicione ao seu alacritty.toml:

[keyboard]bindings = [  { key = "Return", mods = "Alt", chars = "\u001b\r" }]

Kitty:

Adicione ao seu kitty.conf:

map alt+enter send_text all \x1b\r

Shift+Enter

O suporte a Shift+Enter depende de o terminal reconhecer corretamente a tecla modificadora. A maioria dos terminais modernos faz isso automaticamente, mas alguns podem exigir configuração.

Terminal do VS Code:

O terminal integrado do VS Code pode não transmitir Shift+Enter corretamente. Adicione o seguinte ao seu keybindings.json:

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

Solução de problemas

Atalhos de teclado não funcionam:

• Verifique se o terminal detecta as teclas corretamente usando cat ou showkey
• Verifique se um multiplexador de terminal (tmux/screen) está interceptando as teclas
• Use Ctrl+J como alternativa confiável

Usuários de tmux:

• Shift+Enter e Option+EnterAlt+Enter não funcionam no tmux
• Use Ctrl+J ou \+Enter
• Essas opções universais funcionam em qualquer lugar, inclusive em sessões tmux aninhadas

Sessões SSH:

• Os recursos do terminal remoto dependem do emulador de terminal local
• Ctrl+J funciona de forma confiável via SSH
• \+Enter é outra opção confiável

Resumo