TUI

Usando a interface de usuário de terminal do OpenCode.

OpenCode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM.

Executar OpenCode inicia a TUI para o diretório atual.

opencode

Ou você pode iniciá-la para um diretório de trabalho específico.

opencode /path/to/project

Uma vez que você esteja na TUI, pode enviar uma mensagem.

Give me a quick summary of the codebase.

Referências de arquivos

Você pode referenciar arquivos em suas mensagens usando @. Isso faz uma busca difusa de arquivos no diretório de trabalho atual.

Dica: Você também pode usar @ para referenciar arquivos em suas mensagens.

How is auth handled in @packages/functions/src/api/index.ts?

O conteúdo do arquivo é adicionado automaticamente à conversa.

Comandos Bash

Comece uma mensagem com ! para executar um comando de shell.

!ls -la

A saída do comando é adicionada à conversa como resultado de ferramenta.

Comandos

Ao usar a TUI do OpenCode, você pode digitar / seguido de um nome de comando para executar ações rapidamente. Por exemplo:

/help

A maioria dos comandos também tem atalhos de teclado usando ctrl+x como tecla líder, onde ctrl+x é a tecla líder padrão. Saiba mais.

Aqui estão todos os comandos slash disponíveis:

connect

Adiciona um provedor ao OpenCode. Permite selecionar dos provedores disponíveis e adicionar suas chaves de API.

/connect

compact

Compacta a sessão atual. Alias: /summarize

/compact

Atalho: ctrl+x c

details

Alterna os detalhes de execução de ferramentas.

/details

Atalho: ctrl+x d

editor

Abre um editor externo para compor mensagens. Usa o editor configurado na sua variável de ambiente EDITOR. Saiba mais.

/editor

Atalho: ctrl+x e

exit

Sai do OpenCode. Aliases: /quit, /q

/exit

Atalho: ctrl+x q

export

Exporta a conversa atual para Markdown e abre no seu editor padrão. Usa o editor configurado na sua variável de ambiente EDITOR. Saiba mais.

/export

Atalho: ctrl+x x

help

Mostra o diálogo de ajuda.

/help

Atalho: ctrl+x h

init

Cria ou atualiza o arquivo AGENTS.md. Saiba mais.

/init

Atalho: ctrl+x i

models

Lista os modelos disponíveis.

/models

Atalho: ctrl+x m

new

Inicia uma nova sessão. Alias: /clear

/new

Atalho: ctrl+x n

redo

Refaz uma mensagem previamente desfeita. Disponível apenas após usar /undo.

Dica: Quaisquer alterações de arquivos também serão restauradas.

Internamente, isso usa Git para gerenciar as alterações de arquivos. Portanto, seu projeto precisa ser um repositório Git.

/redo

Atalho: ctrl+x r

sessions

Lista e alterna entre sessões. Aliases: /resume, /continue

/sessions

Atalho: ctrl+x l

share

Compartilha a sessão atual. Saiba mais.

/share

Atalho: ctrl+x s

themes

Lista os temas disponíveis.

/themes

Atalho: ctrl+x t

thinking

Alterna a visibilidade dos blocos de pensamento/raciocínio na conversa. Quando habilitado, você pode ver o processo de raciocínio do modelo para modelos que suportam pensamento estendido.

Nota: Este comando apenas controla se os blocos de pensamento são exibidos - não habilita ou desabilita as capacidades de raciocínio do modelo. Para alternar as capacidades de raciocínio reais, use ctrl+t para ciclar entre variantes do modelo.

/thinking

undo

Desfaz a última mensagem na conversa. Remove a mensagem de usuário mais recente, todas as respostas subsequentes e quaisquer alterações de arquivos.

Dica: Quaisquer alterações de arquivos feitas também serão revertidas.

Internamente, isso usa Git para gerenciar as alterações de arquivos. Portanto, seu projeto precisa ser um repositório Git.

/undo

Atalho: ctrl+x u

unshare

Deixa de compartilhar a sessão atual. Saiba mais.

/unshare

Configuração do editor

Tanto o comando /editor quanto /export usam o editor especificado na sua variável de ambiente EDITOR.

Linux/macOS

# Example for nano or vim
export EDITOR=nano
export EDITOR=vim
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

Para tornar permanente, adicione ao seu perfil de shell; ~/.bashrc, ~/.zshrc, etc.

Windows (CMD)

set EDITOR=notepad
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --wait

Para tornar permanente, use Propriedades do Sistema > Variáveis de Ambiente.

Windows (PowerShell)

$env:EDITOR = "notepad"
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"

Para tornar permanente, adicione ao seu perfil do PowerShell.

Opções populares de editor

As opções populares de editor incluem:

• code - Visual Studio Code
• cursor - Cursor
• windsurf - Windsurf
• nvim - Editor Neovim
• vim - Editor Vim
• nano - Editor Nano
• notepad - Bloco de Notas do Windows
• subl - Sublime Text

Nota: Alguns editores como VS Code precisam ser iniciados com a flag --wait.

Alguns editores precisam de argumentos de linha de comando para executar em modo bloqueante. A flag --wait faz o processo do editor bloquear até ser fechado.

Configuração

Você pode personalizar o comportamento da TUI através do seu arquivo de configuração do OpenCode.

Opções

• scroll_acceleration - Habilita aceleração de rolagem estilo macOS para rolagem suave e natural. Quando habilitado, a velocidade de rolagem aumenta com gestos de rolagem rápidos e permanece precisa para movimentos mais lentos. Esta configuração tem precedência sobre scroll_speed e a substitui quando habilitada.
• scroll_speed - Controla quão rápido a TUI rola quando comandos de rolagem são usados (mínimo: 1). Padrão é 3. Nota: Isso é ignorado se scroll_acceleration.enabled estiver definido como true.

Personalização

Você pode personalizar vários aspectos da visualização da TUI usando a paleta de comandos (ctrl+x h ou /help). Essas configurações persistem entre reinicializações.

Exibição do nome de usuário

Alterna se seu nome de usuário aparece nas mensagens do chat. Acesse através de:

• Paleta de comandos: Pesquise por "username" ou "hide username"
• A configuração persiste automaticamente e será lembrada entre sessões da TUI