Guia de funcionalidades do Cursor 3.11: Bate-papo lateral sem interromper a janela principal, Cmd+K para voltar a conversas anteriores

Esta publicação vai ajudar-te a começar de uma só vez com as 3 novas funcionalidades do Cursor 3.11: usar o chat no painel lateral para fazer perguntas sem interromper o Agent principal; pesquisar em milhares de conversas antigas no teu computador com Cmd+K; e, depois, usar Hooks para intervir e monitorizar sub-Agents nos pontos-chave. Inclui um exemplo completo e executável de hooks.json e um exemplo de uma armadilha que a versão em cloud pode fazer-te cair.
（Antecedentes: A SpaceXAI, do grupo de Musk, lançou oficialmente o modelo mais forte “Grok 4.5”! Em parceria com o Cursor, vai atacar em força os agentes de codificação de IA, com integração perfeita com o Office ）
（Extra de contexto: Cursor Mobile: lançado—uma app dedicada para te ajudar a comandar a escrita de código por IA no telemóvel e a supervisionar a produção ）

Índice

Toggle

• Estrutura deste artigo
• Chat no painel lateral para fazer o Agent principal não parar, abrindo outro chat que herda o context
• Usar Cmd+K para procurar em milhares de conversas antigas no local e Cmd+F para encontrar esta conversa atual
  • Pesquisar todas as conversas antigas; no Agents Window, premir Cmd+K
  • Pesquisar esta conversa atual; premir Cmd+F
• Cloud Agent Hooks: deixas entrar em acção nos nós importantes, monitorizas e controlas os sub-Agents
  • Como escrever e onde colocar hooks.json
  • Para bloquear uma ação específica, só dois nós a reconhecem
  • Armadilhas do Cloud Agent
• Como ligar as três funcionalidades
• Apêndice: recursos adicionais
• Perguntas frequentes

O Agent principal está a correr uma grande reestruturação. De repente, queres confirmar se uma determinada função é chamada noutro sítio; antes, só tinhas a opção de pará-la, mudar de tarefa e interromper aquilo que estava a correr. As três funcionalidades adicionadas pelo Cursor 3.11 (lançado em 10 de Julho de 2026)—chat no painel lateral, pesquisa de conversas e Cloud Agent Hooks—têm tudo a ver com resolver “não quero interromper a linha principal”.

Este artigo assume que já estás a usar os Agents do Cursor e vai ensinar-te a pôr as três novidades em prática de uma só vez, com um exemplo de hooks.json e uma armadilha de cloud para teres cuidado.

Estrutura deste artigo

• Chat lateral: o Agent principal não para; abre-se um chat à parte que herda o context para fazer follow-up
• Pesquisa de conversas: usar Cmd+K para procurar em milhares de conversas antigas no local e Cmd+F para esta conversa
• Cloud Agent Hooks: intervir em nós como submissão de prompts, respostas e início de sub-Agents
• Como encadear as três funcionalidades e as armadilhas dos hooks em cloud

Mantém o Agent principal em execução com o chat lateral e abre um chat que herda o context

O chat lateral (side chat) resolve um cenário muito específico: o Agent principal está a correr uma tarefa longa e tu queres desviar para fazer uma pergunta, mas sem interrompê-la.

Há três maneiras de abrir um chat lateral; escolhe a que for mais conveniente:

2. Comando: escreve /side ou /btw na caixa de chat
3. Botões: prime no botão + no topo do painel do chat

O chat lateral que abres herda directamente o context da conversa principal (contexto). Portanto, não tens de colar de novo o contexto—ele já sabe no que vocês estavam a mexer.

A parte mais fácil de confundir é que, por predefinição, o chat lateral só faz três coisas: leitura, pesquisa e resposta. Não vai mexer no teu code. A sua função é permitir que faças follow-up, consultes informação, explores outra rota, ou faças um sanity-check (verificação rápida) a uma decisão antes de avançar. Enquanto isso, o Agent principal na linha principal continua a correr sem ser afectado. Se quiseres que ele realmente mude algo, tens de dizer isso explicitamente dentro da conversa.

Cada chat lateral é uma conversa completa e preservada a longo prazo com um Agent—não é “pergunta e acabou”. Podes voltar mais tarde e continuar a perguntar. Quando encontrares uma conclusão útil, usa @ para trazer essa conversa lateral de volta para a conversa principal; o context liga-se de novo à linha principal.

Pelo que tenho visto, o melhor uso do chat lateral não é perguntar “o que é isto”, mas sim: “o Agent principal vai mudar isto assim, mas desconfio que pode mexer em X. Podes confirmar se X é usado noutros sítios?” A linha principal continua, tu verificas ao lado; as duas linhas não se bloqueiam.

Usa Cmd+K para pesquisar milhares de conversas antigas localmente e Cmd+F para procurar dentro desta conversa

Antes, para encontrar “como é que na conversa do Agent da semana passada ele resolveu aquele bug”, era preciso confiar no nome da conversa ou no número do PR e ir à caça devagar—era doloroso. O 3.11 colocou a pesquisa “dentro” e com dois níveis.

Pesquisar em todas as conversas antigas; no Agents Window, premir Cmd+K

No Agents Window (janela das conversas do Agent), premir Cmd+K para abrir o painel de comandos e pesquisar directamente pelo conteúdo das conversas do Agent (transcript), não apenas pelo nome e pelo número do PR. O Cursor cria um índice de pesquisa local no teu computador; mesmo que tenhas acumulado milhares de conversas, a pesquisa continua rápida.

Como o índice é construído localmente, o conteúdo não é enviado para a cloud para permitir a pesquisa. Para quem se preocupa com privacidade, isto dá mais confiança.

Pesquisar apenas nesta conversa; premir Cmd+F

Se apenas queres encontrar um trecho dentro desta longa conversa que estás a ver, usa Cmd+F. Ele mostra um match counter (contagem de ocorrências), podes saltar entre os trechos correspondentes; enquanto vais rolando o transcript, também podes continuar a pesquisar.

Aqui atenção: após fazeres upgrade, o índice pode demorar um bocado a ficar pronto. Se descobrires que as conversas antigas “não aparecem” de repente, ou que o chat history parece vazio, espera um pouco pelo fim da indexação—normalmente não é que os dados tenham desaparecido.

Cloud Agent Hooks: intervenções em nós-chave para monitorizar e controlar sub-Agents

Hooks (ganchos) são a actualização mais “recheada” para programadores nesta versão. Permitem-te anexar o teu script aos nós-chave de uma conversa do Agent; quando o Agent chega a esse nó, o teu script é activado automaticamente.

Os novos nós desta versão 3.11 cobrem vários momentos-chave ao longo de uma ronda de conversa do Agent:

• beforeSubmitPrompt: tu envias o prompt, mas antes do pedido ser enviado para o backend
• afterAgentResponse: depois de o Agent terminar uma resposta
• afterAgentThought: depois de uma fase de pensamento (thinking) acabar
• subagentStart: antes de criar um sub Agent (ferramenta Task)
• subagentStop: o sub Agent termina de correr
• stop: no fim do ciclo inteiro do Agent; quando a tarefa pára

Com esses nós, consegues fazer três coisas: monitorizar todo o processo de execução, controlar os sub-Agents antes e depois de arrancarem, e montar um ciclo de auto-correção (self-correcting). Por exemplo: depois de o Agent dar uma resposta, corre-se automaticamente um teste; se falhar, devolve-se o erro para ele próprio corrigir.

Como escrever hooks.json e onde o colocar

A configuração dos Hooks fica em hooks.json e a version é sempre 1. Existem três locais onde o podes colocar; desde que exista, será executado:

• Nível do projecto: /.cursor/hooks.json
• Nível global do utilizador: ~/.cursor/hooks.json
• Nível da empresa: /etc/cursor/hooks.json

Um exemplo mínimo e funcional: faz duas coisas—sempre que o Agent alterar um ficheiro, corre um script de auditoria; e quando a tarefa parar, escreve um registo:

{
  "version": 1,
  "hooks": {
    "afterFileEdit": [
      { "command": "./hooks/audit.sh" }
    ],
    "stop": [
      { "command": "./hooks/on-stop.sh" }
    ]
  }
}

Os caminhos dentro de command são relativos ao local onde hooks.json está. O teu script recebe um JSON via stdin (standard input). Esse JSON inclui campos básicos como conversation_id, generation_id, model e hook_event_name, além de campos relacionados com o nó em questão: por exemplo, beforeSubmitPrompt traz prompt; afterAgentResponse traz o texto da resposta.

Um script que não faz nada, apenas confirma que consegue receber dados, pode ser assim:

#!/bin/bash
cat > /dev/null   # ler e descartar stdin
exit 0            # reportar sucesso

Para bloquear uma acção, apenas dois nós reconhecem

Há aqui uma armadilha fácil de cair: nem todos os hooks conseguem bloquear acções. Apenas estes dois nós—beforeShellExecution (antes de executar comandos shell) e beforeMCPExecution (antes de chamar ferramentas MCP)—vão olhar para o JSON devolvido no stdout (standard output) para decidir se deixa passar ou não:

{
  "continue": true,
  "permission": "allow",
  "userMessage": "Mensagem para mostrar a ti",
  "agentMessage": "Mensagem para mostrar ao AI"
}

permission define allow para deixar passar, deny para bloquear; ask para te pedir confirmação. Em outros nós, como afterAgentResponse, mesmo que envies permission, ele ignora. Esses nós só observam, registam e disparam outras acções—não conseguem bloquear.

Armadilhas do Cloud Agent

Se usares Hooks com Cloud Agent (cloud agent), há um nó que fica imediatamente inválido: beforeSubmitPrompt. A razão é prática: este hook está preso ao ciclo de vida da session desde o início, mas a máquina virtual (VM) em cloud só é criada depois de a session arrancar. Naquele instante inicial, a máquina ainda não existe—portanto, não há nada que possa executar o hook por ti.

Pelo que tenho visto: se for para usar cloud, escolhe nós que ficam “antes e depois da execução de ferramentas”, como beforeShellExecution, afterFileEdit, subagentStart, subagentStop e stop. Esses são mais estáveis; evita prender ao “início da session”.

Como encadear as três funcionalidades

As três funcionalidades podem ser explicadas separadamente, mas o que deves fazer é experimentar tu próprio o “encaixe” entre elas. Um cenário real:

O Agent principal está a fazer uma reestruturação que envolve vários ficheiros. Queres abrir um chat lateral (/side) para verificar “em quantos sítios este interface a ser alterado está a ser usado”; a linha principal não pára. Depois de encontrares riscos, usa @ para levar a conclusão do chat lateral de volta para a conversa principal, para que o Agent trate todas essas partes em conjunto. Ao mesmo tempo, no teu hooks.json tens um nó stop: quando a reestruturação termina, ele executa testes automaticamente. Depois, usas Cmd+F para voltar e, nesta conversa longa, encontrares quais funções o Agent disse que tinha mexido.

No fim, não houve interrupções, e fizeste tudo o que querias.

Apêndice: recursos adicionais

• Changelog oficial do Cursor: descrições completas das actualizações de cada versão; na 3.11 estão aqui a parte do chat lateral e da pesquisa de conversas
• Documentação oficial do Cursor Hooks: referências completas para todos os nós de hook, campos stdin/stdout e formato de configuração
• Documentos do Cursor Subagents: em conjunto com os nós subagentStart/subagentStop, podes primeiro ver esta página

Perguntas frequentes

Q1. O chat lateral vai alterar o meu code?
A: Por predefinição, não. Ele só faz leitura, pesquisa e resposta. O objectivo é ajudar-te a confirmar e a fazer follow-up. Se quiseres que altere coisas, tens de dizer isso explicitamente na conversa.

Q2. Se desligar o chat lateral, ele desaparece?
A: Não. Cada chat lateral é uma conversa completa com o Agent, preservada a longo prazo; podes visitar mais tarde, continuar a fazer perguntas, e também podes usar @ para o trazer de volta para a conversa principal.

Q3. A pesquisa das conversas do Cmd+K pesquisa cloud ou pesquisa local?
A: Pesquisa local. O Cursor cria um índice de pesquisa no teu computador; o conteúdo não é enviado para a cloud só para a pesquisa, e assim consegue aguentar até milhares de conversas com rapidez.

Q4. Acabei de actualizar e não consigo pesquisar conversas antigas, ou o chat history está vazio?
A: Na maioria das vezes é porque o índice local ainda está a ser construído; espera que acabe. Normalmente não é porque os dados se perderam.

Q5. Qual é a diferença entre Hooks em Cloud Agent e local?
A: A maior diferença é que beforeSubmitPrompt não corre na cloud, porque no início da session a VM em cloud ainda não foi criada. Se prenderes os hooks a nós antes/depois da execução de ferramentas—como beforeShellExecution, afterFileEdit e subagentStart—na cloud fica mais estável.

Q6. Onde devo colocar hooks.json para ter efeito?
A: No .cursor/hooks.json do projecto, no ~/.cursor/hooks.json do utilizador, e no /etc/cursor/hooks.json da empresa. Desde que existam, os três locais serão executados.

Q7. Quero que o hook bloqueie directamente um comando perigoso. Dá para fazer?
A: Dá, mas apenas nos nós beforeShellExecution e beforeMCPExecution. Eles só aceitam o permission que devolves no stdout; se for deny, bloqueia. Os restantes nós só conseguem observar e disparar acções—não conseguem bloquear.