CLI
Registro de alterações da CLI
As funcionalidades, melhorias e correções mais recentes da CLI do Cherri Code. Execute agent --version para verificar a versão instalada e agent update para atualizar a instalação existente.
Sessões persistentes
- Mantenha agentes em execução depois de se desconectar. Inicie uma sessão persistente com
agent persist, desconecte-se com/detache reconecte-se depois comagent persist attach. Useagent persist list|stoppara gerenciar sessões ouagent persist --resumepara continuar um chat existente.
Self-hosted workers
- Espectadores acompanham o desktop ao vivo do agente. Workers iniciados com
--computer-use --share-desktopagora compartilham o desktop gerenciado que o agente usa, em vez de uma sessão separada. O Cherri Code limpa displays obsoletos pertencentes ao worker para que as sessões seguintes comecem limpas. - Desperte workers hibernados para mensagens de acompanhamento.
agent worker controllerpode despertar um worker hibernado e alocado por meio do hook--spawn, de modo que uma mensagem de acompanhamento retorne ao mesmo espaço de trabalho durante a janela de reconexão. Sua observação de fila agora usa eventos SSE para reduzir o polling e lidar com limites de taxa.
Steering e subagentes
- Oriente um turno em execução e depois o interrompa. Ao pressionar Enter enquanto o agente trabalha, sua mensagem na fila agora é enviada para a execução ativa em um ponto seguro para orientá-la, e o turno só é interrompido se você pressionar Enter novamente.
- Execuções de turno único aguardam os subagentes. Execuções headless e de turno único aguardam os subagentes delegados e incluem sua conclusão antes de sair, em vez de encerrar enquanto shells em segundo plano ou servidores de desenvolvimento ainda estão em execução.
- Leia a transcrição completa do subagente. Ao acessar um subagente, você vê sua transcrição completa e ordenada, incluindo o prompt, o raciocínio, as chamadas de ferramenta e a resposta final, em vez de apenas linhas de ferramentas.
- Escolha o modelo do subagente de exploração. Defina o subagente de exploração como padrão, desativado, herdando o modelo pai ou usando um modelo específico de
/config. - As mensagens de acompanhamento de tarefas em segundo plano voltaram. As mensagens de acompanhamento de conclusão para tarefas em segundo plano finalizadas voltam a ser enviadas em sessões interativas e headless.
Skills, modos personalizados e metas
- Skills persistentes e modos personalizados. Uma entrada de barra de skill é anexada uma vez ao pressionar Enter, e Option+Enter invoca uma skill baseada em modo como um modo personalizado persistente que permanece ativo até você sair dele.
- Skills gerenciadas podem incluir recursos em Markdown. A sincronização de skills gerenciadas agora materializa os arquivos Markdown aninhados de uma skill em
~/.cursor/skills-cursor, fazendo com que skills que referenciam recursos extras funcionem. - A descoberta de skills ignora diretórios ocultos. As varreduras de skills e subagentes não entram mais em diretórios ocultos iniciados por ponto, evitando carregamentos lentos em pastas grandes e aninhadas.
- Objetivos duráveis.
/goalacompanha um objetivo durável com uma linha de status ativa ou pausada, mantém o objetivo entre execuções ociosas e headless e o pausa com Ctrl+C. Esse recurso está sendo disponibilizado gradualmente e tem acesso restrito.
Modelos
- Auto permanece fixado no seletor. Auto fica fixado no topo da lista
/model, como na IDE. - Editar os parâmetros de um modelo o seleciona. Ajustar parâmetros em
/modelagora seleciona esse modelo, de modo que pressionar Esc mantém ativa a escolha atualizada. - Headless mantém variantes do Max Mode. Uma seleção
--modelem modo headless que exige o Max Mode agora o envia, portanto as variantes de contexto máximo não são mais limitadas.
MCP e plugins
- Login MCP simplificado para hosts conhecidos. O login em servidores como o Slack pelo pager
/mcpusa a autenticação padrão, evitando falhas no registro dinâmico de clientes. - Hooks de plugins instalados são executados. Hooks definidos por plugins instalados, incluindo os carregados com
--plugin-dir, agora são executados e atualizados quando os plugins são recarregados. - Segredos permanecem mascarados na configuração do plugin. Os formulários de configuração do plugin mascaram campos com nomes de credenciais e do tipo segredo, como tokens, chaves de API e senhas.
Terminal e renderização
- Prévias de imagens inline. Imagens anexadas e geradas são exibidas inline em terminais compatíveis, com alternativas em texto nos demais.
- Fórmulas LaTeX renderizadas como Unicode. Fórmulas em Markdown são renderizadas como Unicode compatível com terminais, em vez de TeX bruto.
- Saída e transcrições do shell mais limpas. Saídas longas do shell não recebem mais espaços de largura zero, para que caminhos e tokens copiados permaneçam intactos; a observação sobre o diretório de trabalho fica oculta quando um comando é executado no diretório atual; grupos ocultos de chamadas de ferramentas não deixam mais linhas em branco; e prévias de aprovação enfileiradas de "+N mais pendentes" são empilhadas sem espaços.
- Paleta de arquivos
@responsiva. A digitação permanece responsiva em repositórios grandes enquanto a paleta@calcula sugestões de arquivos. - Linha de status personalizada mais estável. Um comando
statusLinepersonalizado mantém sua limitação durante atualizações de streaming e só é reiniciado quando o comando ou o diretório de trabalho muda.
Aprovações e segurança
- Aprovações temporizadas para troca de modo. A aprovação de uma troca de modo agora usa a interface do pager, com uma contagem regressiva de 15 segundos, e é rejeitada automaticamente se ficar sem supervisão, como no IDE.
- Comandos Git reforçados. A configuração do Git controlada pelo repositório, incluindo fsmonitor, hooks, atributos e programas de diff externos, não é mais executada durante as operações Git do próprio agente.
- Acesso de leitura ao sandbox e Git via SSH. A política de sandbox passa a incluir um limite de acesso de leitura, e o Git via SSH em sandbox no macOS e no Linux é roteado pelo proxy SOCKS para que os remotos na lista de permissão funcionem e os negados apresentem um erro claro.
- Sudo usa sua entrada mais recente. O envio de uma senha sudo agora envia exatamente o que você digitou, em vez de um valor renderizado desatualizado.
Confiabilidade e inicialização
- Inicialização mais rápida. As gramáticas de destaque de sintaxe e o cliente do composer em segundo plano são carregados sob demanda, fora do caminho de inicialização, e uma lista lenta de plugins recorre a uma sessão sem plugins em vez de atrasar a inicialização.
- Sessões headless longas não travam mais. Uploads travados em sessões HTTP/1.1 headless de longa duração são detectados e tentados novamente, em vez de travarem silenciosamente.
- Retomada mais rápida em sistemas de arquivos de rede. O seletor de retomada examina as sessões em paralelo e mantém seu chat mais recente selecionado enquanto a lista completa de todos os espaços de trabalho é carregada.
Self-hosted workers
- Mais controle sobre workers auto-hospedados. Os workers podem entrar em um pool nomeado com
agent worker --pool <name>, são liberados por padrão após uma hora de inatividade (--idle-release-timeout 0os mantém em execução), iniciar em um diretório que não é Git com--worker-dir, bloquear o diretório de dados para evitar daemons duplicados e executar hooks de início e fim de sessão ao serem alocados e liberados.
Enterprise e instalação
- Lista de bloqueio de comandos do administrador aplicada na CLI. A lista de bloqueio de comandos de um administrador da equipe é aplicada à execução no shell local e atualizada a cada solicitação, com um interruptor de emergência. Controlado pelo administrador.
- Política de login via MDM. O login na CLI envia e aplica a política de login via MDM, incluindo listas de permissão de organização, equipe, e-mail e domínio, e relata bloqueios por aplicação de política. Controlado pelo administrador.
- A desinstalação no Windows pode remover seus dados. O desinstalador do Windows pode, opcionalmente, excluir dados de usuário do Cherri Code, incluindo a pasta
~/.cursor, que armazena as credenciais da CLI. - Script de instalação resiliente. O script de instalação usa wget ou python3 como alternativa quando o curl falha.
--trustfunciona em sessões interativas. Antes,--trustexigia o modo headless. Agora, usá-lo em uma sessão interativa marca o espaço de trabalho como confiável antecipadamente e ignora o diálogo de confiança, registrando a mesma decisão salva quando você a aceita no diálogo.- Erros claros em vez de travamentos no login. O login OAuth do MCP falha rapidamente com uma mensagem clara quando a porta de callback já está em uso, em vez de travar em "Escutando o callback OAuth". No macOS, falhas do keychain na inicialização agora explicam a causa e como corrigi-las, como desbloquear um keychain bloqueado ou sair e entrar novamente, em vez de exibir apenas um código de saída.
- O catálogo de modelos se mantém atualizado em sessões longas. A CLI consulta novamente o catálogo de modelos a cada 10 minutos em segundo plano, para que modelos recém-lançados apareçam em
/modele nos atalhos sem reiniciar. Se uma atualização falhar, a CLI mantém o catálogo atual e tenta novamente no próximo intervalo. - Renderização mais limpa. As linhas de ferramentas concluídas não desaparecem mais por um frame quando o agente passa para a próxima etapa, as tabelas markdown com emojis ou texto CJK mantêm as colunas alinhadas, digitar um caminho como
/tmpseguido de um espaço não deixa mais a paleta de barra travada em "Nenhuma correspondência", e as linhas de subagentes não exibem mais a dica para expandir com Ctrl+O (o atalho continua funcionando). - Corrigido o uso intenso de CPU pelo observador de branches. Quando o observador que mantém atualizada a branch git no rodapé do prompt não conseguia se conectar, geralmente após esgotar o limite de observação do inotify no Linux, ele repetia as tentativas em um loop apertado que ocupava um núcleo da CPU. Falhas de conexão agora aumentam exponencialmente o intervalo entre tentativas, e as trocas de branch ainda atualizam o rodapé imediatamente.
Plugins e MCP
- Gerencie marketplaces de plugins pelo terminal. Automatize o gerenciamento de marketplaces sem uma sessão interativa:
agent plugin marketplace add <git-url>registra um marketplace (fixe uma branch, tag ou commit com--git-ref),listexibe o nome, o escopo e a URL do Git de cada marketplace (--format jsonpara scripts),updatereindexa um marketplace a partir de seu repositório eremoveexclui um marketplace no escopo do usuário. - Um servidor para configurações MCP duplicadas. Quando o mesmo servidor MCP remoto é configurado em mais de um escopo, como no seu
mcp.jsonde usuário e no.cursor/mcp.jsonde um projeto, a CLI agora executa uma única instância em vez de duplicatas. Escolha qual configuração de escopo prevalece na nova guia Configurar escopo da visualização de detalhes/mcpde um servidor. A escolha é salva por projeto.
Uso e modelos
- Veja o uso e os gastos do plano em
/usage./usageagora mostra os medidores de uso incluído da sua conta, com detalhamentos de Auto e API, gastos sob demanda em relação ao seu limite, nome do plano e data de redefinição do ciclo de faturamento. Planos Enterprise compartilhados recebem um gráfico de gastos do ciclo de faturamento atual comparado ao período anterior de mesma duração, além de um link para o painel de uso. - Corrigido o Max Mode que permanecia ativado. Escolher uma variante que exige o Max Mode, como
/fastou uma opção com contexto de 1M, não deixa mais o Max Mode silenciosamente ativado para outros modelos e sessões futuras: ele é desativado quando sua seleção deixa de exigi-lo, enquanto uma escolha explícita de/max-modepermanece ativa. O indicador MAX também voltou à barra de prompt, após o resumo de parâmetros do modelo. - Corrigido o seletor
/modelvazio em conexões lentas. Se a consulta ao catálogo de modelos expirasse na inicialização,/modelpermanecia vazio durante toda a sessão. Abrir o seletor agora consulta o catálogo novamente, e um seletor aberto é preenchido assim que a lista chega.
Aprovações e confiança
- Aceite automaticamente pesquisas na Web. Uma nova permissão de Aceitar automaticamente pesquisas na Web permite que o agente execute pesquisas na Web sem pausar para pedir aprovação a cada vez. Ela vem desativada por padrão. Ative-a em Permissões no
/configou definaautoAcceptWebSearchemcli-config.json. Aplicável a execuções interativas, headless, de subagentes e do Agent Client Protocol. - Oriente o agente pelos prompts de aprovação do terminal. A opção de pular nas aprovações do terminal agora é rotulada como "Pular e dizer ao agente o que fazer em vez disso", e escolhê-la abre um campo de mensagem que é enviado ao agente como o motivo pelo qual o comando foi pulado. Enviar uma mensagem vazia apenas pula.
- A configuração de worktree respeita a confiança no espaço de trabalho. Os comandos de configuração de
.cursor/worktrees.jsonagora são executados somente depois que o espaço de trabalho é considerado confiável, pelo prompt de confiança, por uma decisão de confiança salva ou por--trustem execuções headless. Espaços de trabalho não confiáveis ignoram a configuração e exibem um aviso.
Confiabilidade
- Retomar chats está mais rápido. O seletor de retomada mostra imediatamente os chats do seu espaço de trabalho atual e carrega os de outros espaços de trabalho em segundo plano, e selecionar um chat não aguarda mais uma consulta ao catálogo de modelos quando o modelo armazenado já está em cache.
- Instabilidades de rede não interrompem mais execuções. Falhas de DNS e erros de rede inacessível, como os ocorridos durante uma transição de VPN, são tentados novamente com espera progressiva, como outros erros de transporte. Se a rede continuar indisponível, a CLI mostra uma dica prática sobre configuração de rede, VPN, DNS e proxy em vez de um erro de rede bruto.
- Subagentes sobrevivem a falhas transitórias. Um erro momentâneo de rede não encerra mais um subagente em execução com um erro terminal. As interações de subagentes são tentadas novamente com a mesma política das interações regulares, retomando do último ponto de verificação quando houver um.
- Atualizações não interrompem mais sessões em execução. A limpeza da atualização automática podia excluir a versão instalada a partir da qual uma sessão de longa duração foi iniciada, fazendo-a travar no meio de uma interação. Processos em execução agora marcam seu diretório de instalação como em uso para que a limpeza o ignore e, se os arquivos de instalação ainda desaparecerem, como após uma atualização do Homebrew, a CLI pede que você reinicie em vez de falhar com um erro de módulo.
- Correções em
/btw. Perguntas paralelas não falham mais com um erro interno de blob em sessões longas ou compactadas, e a paleta de comandos com barra não aparece mais sobre sua pergunta enquanto você a digita.
Modelos e habilidades
- Novas instalações começam no Auto. Novas instalações da CLI usam por padrão o roteamento automático de modelos. As opções existentes não mudam; alterne a qualquer momento com
/modelou--model. - Alterne modelos instantaneamente com comandos slash. Digite um atalho como
/opusou/composerpara ir direto para um modelo, sem precisar abrir um seletor; cada atalho de família lembra sua última escolha./fastativa ou desativa o Fast quando o modelo atual é compatível. Desative atalhos em Comandos slash de modelo, em/config. - Mantenha habilidades exclusivas do modelo fora dos comandos slash. Defina
user-invocable: falseno frontmatter doSKILL.mdde uma habilidade para ocultá-la do preenchimento automático de/e da resolução de/skill-namedigitado, mantendo-a disponível para o modelo.
Confiabilidade
- Corrigido o aumento de memória causado pelo estado de cancelamento por turno. Chats longos não acumulam mais listeners e controladores de aborto; cada turno os libera ao terminar.
- Sair retorna você ao shell rapidamente. A saída não espera mais que os servidores MCP ou outras tarefas em segundo plano sejam encerrados, e sair do prompt de confiança do espaço de trabalho não exibe mais brevemente "Confiando no espaço de trabalho…".
- Corrigida a corrupção de configuração ao executar vários agentes ao mesmo tempo. Processos simultâneos da CLI podiam intercalar gravações em
cli-config.jsone impedir inicializações posteriores. Agora, cada gravação é preparada em seu próprio arquivo temporário antes de uma renomeação atômica.
Sessões e subagentes
- Retome chats de qualquer diretório.
agent ls,agent --resumee/resumeabrem, por padrão, Todos os chats de todos os espaços de trabalho. Use Esquerda/Direita para alternar para Este espaço de trabalho; chats de outros diretórios exibem um rótulo de pasta, e retomar um deles carrega a conversa completa em vez de uma conversa vazia. - Subagentes mantêm seu contexto entre retomadas. Subagentes concluídos salvam checkpoints, portanto retomá-los restaura seu contexto anterior em vez de iniciá-los vazios. Subagentes em segundo plano incluem sua mensagem final na notificação de conclusão, e retomar um subagente indisponível falha com uma mensagem clara.
Login e MCP
- Faça login de outro dispositivo com um código QR. Durante
agent loginou a configuração inicial, pressioneqpara exibir um código QR da mesma URL de login e escaneie-o com um telefone para concluir a autenticação por SSH sem copiar um link longo. Terminais estreitos e sessões não interativas continuam exibindo apenas a URL. - Filtre servidores MCP e veja o login iniciar imediatamente. Digite para filtrar a lista de servidores em
/mcp. Selecionar Login mostra "Preparando login…" imediatamente, e as instruções de OAuth por SSH não usam maisssh -N, que falhava em alguns proxies. - Corrigidos bugs na lista de permissão e nas aprovações do MCP. As listas de permissão de rede da equipe agora aceitam origens HTTP(S) com portas explícitas, como servidores locais em portas não padrão. As aprovações pessoais de ferramentas MCP voltam a funcionar quando os controles de ferramentas do administrador da equipe estão vazios ou não definidos.
Entrada e terminal
- Prompts longos permanecem em até seis linhas visuais. A barra de prompt e o editor de mensagens na fila rolam para manter o cursor visível, em vez de crescer sem limite. Colagens grandes permanecem recolhidas em uma cápsula quando recuperadas do histórico, enquanto o agente recebe todo o conteúdo, e Trabalhando aparece imediatamente após o envio.
- Corrigido o estado do terminal após Ctrl+Z. Suspender a CLI restaura os modos de teclado do shell até você executar
fg. Backspace não engole mais as letras digitadas logo depois dele quando a interface trava brevemente, e a digitação continua responsiva enquanto o agente transmite a saída. - Corrigidos prompts sudo na fila. Cada solicitação sudo abre um novo prompt de senha em vez de ficar em "Autenticando…". Escape e Ctrl+C cancelam durante o envio, e a máscara usa
•em vez de*para evitar desalinhamento com ligaduras de fontes do terminal. - Os cartões do modo de depuração usam as cores do modo de depuração. O cartão de decisão das etapas de reprodução usa o destaque vermelho de depuração em vez do amarelo do modo de plano, para deixar claro qual modo está ativo.
Espaços de trabalho e comandos
- Inicie sessões com múltiplas raízes pela linha de comando. Repita
--add-dir <path>para adicionar diretórios na inicialização, inclusive com--workspace./add-diratualiza imediatamente habilidades slash e comandos personalizados; reinicie apenas se quiser que o agente descubra novas habilidades automaticamente. - Recarregar plugins atualiza comandos. Recarregar um plugin atualiza seus comandos slash e a paleta. Nomes longos de habilidades e comandos personalizados são resolvidos corretamente, e
/add-dirmantém a conclusão de diretórios aberta enquanto você navega. - Mensagens de acompanhamento na fila são enviadas no segundo Enter. Pressione Enter novamente em um prompt vazio para interromper o turno atual e enviar imediatamente a mensagem na fila, inclusive enquanto um hook
beforeSubmitPromptestiver em execução. - Corrigido o atraso na entrada durante execuções de agentes. Digitar e enfileirar mensagens de acompanhamento não renderiza mais toda a transcrição a cada tecla pressionada enquanto a saída é transmitida.
- Corrigida a redefinição das opções de modelo. Alterar Fast, o esforço de raciocínio ou o contexto em
/modelpreserva suas outras opções compatíveis e mantém o Max Mode sincronizado.
Nuvem e Auto-review
- Transferências para a nuvem preservam o contexto do modelo e do espaço de trabalho. Para repositórios Git com acesso ao Cloud Agents, as transferências preservam o modelo selecionado e o caminho do espaço de trabalho. O prompt mostra o status da transferência,
EscouCtrl-Ccancela, e os detalhes da falha permanecem visíveis. - O Auto-review considera instruções invocadas. Administradores podem controlar a disponibilidade. Quando o Auto-review está habilitado para sua conta e o modelo selecionado, o classificador pode inspecionar arquivos de habilidades invocadas e de comandos personalizados baseados em arquivo antes de decidir se uma chamada de ferramenta precisa de aprovação. Os limites rígidos de aprovação existentes permanecem inalterados.
Autenticação e MCP
- Execute o Cherri Code em sandboxes sem o Keychain do macOS. Defina
AGENT_CLI_CREDENTIAL_STORE=filepara armazenar credenciais sem criptografia em um arquivo acessível apenas ao proprietário. Use um armazenamento privado que persista entre execuções; builds Unix empacotadas também ignoram o carregamento de CAs do sistema nesse modo. - Corrigidos falsos erros de conexão do MCP. Servidores em funcionamento não aparecem mais como desconectados em
/mcpeagent mcp listquando suas ferramentas ou instruções estão disponíveis.
Confiabilidade e atualizações
- Atualizações do Windows suprimem a saída de progresso do PowerShell. Atualizações nativas não exibem mais a barra de progresso do PowerShell's sobre a CLI nem incorrem na sobrecarga de download associada.
- Corrigido o crescimento de memória em sessões longas da CLI. A CLI agora salva apenas novas entradas da transcrição em cada checkpoint, em vez de recarregar e regravar toda a conversa.
Auto-review
- Modo de execução Auto-review. O modo de execução Auto-review do Cherri Code chega à CLI: um meio-termo entre a lista de permissão e Run Everything que mantém o agente em andamento com menos solicitações de aprovação. Chamadas de shell, MCP e Fetch são verificadas em ordem: chamadas na lista de permissão são executadas imediatamente, chamadas que podem ser isoladas são executadas no sandbox, e as demais vão para um classificador que permite a chamada, tenta uma abordagem diferente ou pede sua aprovação. Ative-o com
--auto-review, em/configou com/auto-review, e oriente o classificador com instruçõesallow/blockempermissions.json.
Espaços de trabalho
- Espaços de trabalho nomeados com vários diretórios. Execute o agente em vários repositórios de uma vez: adicione diretórios durante a sessão com
/add-dir, salve o conjunto com/save-workspace, recarregue-o depois com/load-workspaceou inicie com escopo definido usando--workspace.
Comandos
/rewindvem ativado por padrão. A linha do tempo de desfazer por interação não precisa mais ser ativada em/config./vimem qualquer lugar do prompt. Acione a edição Vim em linha a partir de qualquer posição, não apenas em um prompt vazio./copymais completo. Escolha uma única etapa de uma resposta de várias etapas em um seletor por etapa, copie as respostas do agente junto com suas próprias mensagens e copie respostas longas sem travar o terminal./logsem máquinas compartilhadas. Os logs de depuração são gravados por usuário para que hosts com vários usuários não apresentem erros de permissão, e o caminho de/logspermanece na tela por mais tempo.
Experiência no terminal
- O histórico de prompts é por conversa. A seta para cima recupera o que você digitou nesta sessão, em vez de usar um único histórico compartilhado entre todos os chats.
- A lista de tarefas mostra tudo o que está em execução. Shells em primeiro plano e subagentes aparecem no paginador de tarefas junto com tarefas em segundo plano.
- Renderização mais estável. Diagramas Mermaid permanecem exibidos após o término de uma interação, visualizações longas da saída do shell são recortadas em vez de quebrar linha, e a tela é limpa uma vez por redimensionamento em vez de duas.
- Seu rascunho sobrevive ao seletor de retomada. Cancelar
/resumemantém o que você já havia digitado. - Edição de plano. Esc retorna ao modo normal do Vim enquanto você revisa um plano.
Confiabilidade
- Menor uso de memória em sessões longas. Corrigido um vazamento em que sinais de interrupção por interação retinham o estado da conversa.
- Sem falha quando falta o estado de aprovação. As sessões toleram armazenamentos de credenciais que ainda não registraram um modo de aprovação.
MCP e habilidades
- Servidores MCP fornecidos pelo Editor são confiáveis. Servidores MCP transmitidos pelo Agent Client Protocol (Zed e outros editores) são carregados em vez de serem descartados silenciosamente.
- Ferramentas MCP sobrevivem ao recarregamento de um plugin. A concessão do MCP é atualizada após o recarregamento de um plugin, para que suas ferramentas não fiquem mais travadas com erros de "Não conectado".
- Habilidades encontradas por links simbólicos. O menu de habilidades segue diretórios vinculados simbolicamente ao descobrir habilidades.
Instalação e atualizações
- Alternância de canal confiável. A alternância entre canais de lançamento é aplicada na primeira tentativa e busca imediatamente a compilação do canal de destino.
- Correções para Windows e shim. O inicializador do Windows reconhece diretórios de versão com carimbo de data e hora, e o shim
cursornão apresenta mais erros em shells que tratam variáveis não definidas como falhas.
Controles empresariais e de equipe
- Controle de equipe para Auto-review. Administradores controlam se o Auto-review está disponível para seus membros.
- Identidade estável de worker auto-hospedado.
worker startaguarda a conexão da ponte antes de informar que está pronto, e os workers mantêm um ID lógico estável com escopo por usuário autenticado, para que frotas em máquinas compartilhadas associem o worker certo à pessoa certa.
Experiência no Terminal
- Exibição de edições mais limpa. As edições de arquivos são renderizadas sem bordas (um cabeçalho
Editing/Editede o diff), com renderização de diff memoizada para que edições grandes não deixem a UI mais lenta. - Seletor de retomada mais rápido e completo. Os metadados da sessão são armazenados em cache para que
/resume(Ctrl+Y) abra rapidamente mesmo em sistemas de arquivos de rede, com colunas Criado em e Última atualização e ordenação confiável. - Status de trabalho fixado acima do prompt. O progresso, as contagens de tokens (com exibição opcional do tempo decorrido) e as dicas permanecem em um único local estável.
- Saídas longas do shell são truncadas no início. Você vê a saída mais recente de um comando em streaming, não a mais antiga.
- URLs quebradas continuam clicáveis. Links longos reemitem códigos de hiperlink em cada linha quebrada.
- O seletor de modelos mostra o estado do Max Mode, e o resumo do modelo no rodapé elimina rótulos redundantes.
Comandos
/forkCrie uma ramificação da conversa atual e continue por um caminho diferente (aliases/branch,/duplicate)./updateAtualize a CLI diretamente na sessão./contextVisualize o que está consumindo a janela de contexto, dividido por categoria./logsLogs de depuração são gravados para cada sessão;/logsmostra o caminho e o copia para a área de transferência.- Controles de tarefas em segundo plano. Navegação com as teclas de seta no visualizador de tarefas e atalho para encerrar.
Confiabilidade
- Pings de keepalive HTTP/2. Travamentos silenciosos da conexão durante o streaming são detectados em segundos e tentados novamente.
- Interrupções de transporte são repetidas automaticamente. Cancelamentos e interrupções no nível da rede não encerram mais o turno como se Ctrl+C tivesse sido pressionado.
- Correções de congelamentos. Eliminados congelamentos completos da UI causados por loops de feedback de layout, congelamento da entrada após a integração inicial na primeira execução e teclas ignoradas ou reordenadas durante a colagem.
- Primeira renderização mais rápida em redes lentas. Consultas às configurações da equipe não bloqueiam mais a inicialização interativa (cerca de 2 segundos em conexões de alta latência).
- Funciona em redes restritas. As configurações padrão dos recursos são aplicadas quando firewalls corporativos bloqueiam o serviço de configuração.
- Suporte a direnv. O shell do agente carrega
.envrcautomaticamente, em shells interativos e iniciados pelo agente. - Correções de arrastar e soltar e colar. Os caminhos de arquivos arrastados e soltos chegam intactos, e colar um arquivo de imagem copiado no macOS anexa a imagem propriamente dita.
Controles empresariais e de equipe
- Administradores podem desativar o modo headless. Uma configuração da equipe bloqueia o uso não interativo da CLI em toda a organização.
- Controles de "Run Everything". A execução automática foi renomeada de forma consistente em todo o produto; a execução automática controlada pelo administrador trata a lista de comandos permitidos como a base sempre disponível.
- Governança de extensões de usuário do MCP. As opções de administrador "Allow User Extension" para servidores MCP e ferramentas são aplicadas em tempo de execução.
- Servidores MCP gerenciados pela equipe. Servidores configurados centralmente são carregados de forma confiável, com seleção de grupos de servidores; a política de ferramentas MCP é desacoplada da configuração de execução automática do terminal.
- OAuth do MCP via SSH. A CLI mostra instruções de encaminhamento de porta ao autenticar um servidor MCP remoto em uma sessão SSH.
- Composer 2.5 é o modelo padrão para novas sessões de CLI.
/summarize. Renomeado de/compresspara corresponder ao IDE;/compacte/compresspermanecem como aliases e são executados diretamente.- Plugins locais via
~/.cursor/settings.json. Aponte a chaveenabled_pluginspara pastas de plugins locais; não é necessário usar o marketplace. - Workers com várias raízes. Workers self-hosted abrangem vários repositórios com flags
--worker-dirrepetíveis e mantêm uma identidade estável. - Reverter preserva imagens. Ao reverter para um turno anterior, os anexos de imagem desse turno são restaurados no prompt.
/pluginsmais rápido. Detalhes dos plugins carregam mais rápido, e os servidores MCP de cada plugin são vinculados ao gerenciamento em/mcp.- As ferramentas MCP são atualizadas durante a sessão. Fazer login, habilitar ou desabilitar um servidor em
/mcpatualiza imediatamente as ferramentas disponíveis do agente. - Diffs legíveis no modo claro. Os destaques de diff em nível de caractere são legíveis em temas claros do terminal.
- Hooks aceitam payloads via stdin. Evita limites de comprimento de argv e mantém os payloads fora das listagens de processos.
- Modo visual do Vim. Seleção visual com operadores de exclusão e alteração; o modo Vim ativo é exibido no rodapé.
- Ctrl+G abre seu prompt no
$EDITOR. Escreva prompts longos no seu editor de verdade e insira o resultado de volta na barra de prompt. - Gerenciamento de MCP reformulado.
/mcpabre uma visualização detalhada de cada servidor: navegue pelos esquemas das ferramentas, faça login, saia (limpa as credenciais OAuth armazenadas), ative e desative, tudo sem sair da sessão. - Execuções headless aguardam ferramentas MCP. Corrigida uma condição de corrida na inicialização em que servidores MCP stdio lentos não apareciam em execuções com
-p. - Regras e skills aninhadas.
.cursor/rulese.cursor/skillsem subdiretórios são detectados em todos os lugares, como na IDE. - Conversas longas são redesenhadas instantaneamente. Repinturas completas renderizam apenas os turnos recentes (
/full-conversationpara desativar isso), mantendo redimensionamentos e retomadas rápidos em sessões antigas. - Suporte a proxy para streams de agentes.
HTTPS_PROXYé respeitado na conexão de streaming, completando o suporte a proxy corporativo de ponta a ponta. - A execução automática persiste após retomar. Ao retomar uma conversa, Executar Tudo é recalculado com base na sua configuração e na política da equipe.
- Variantes de modelo funcionam em modo headless. Slugs de modelo rápidos ou de alto esforço passados para
--modelmantêm seus parâmetros no modo-p. - Teclas pressionadas antes da interface carregar são armazenadas em buffer e reproduzidas quando a UI é carregada; corrigida a entrada obsoleta via SSH e tmux.
- Detecção de foco do tmux. O cursor do prompt para de piscar em painéis sem foco (com
focus-events on). - Diffs problemáticos são renderizados com segurança. Linhas muito longas são limitadas antes do realce de sintaxe, para que arquivos minificados não travem a UI.
- Marketplaces de plugins. Adicione um marketplace por URL do Git (
/plugin marketplace add), navegue e gerencie marketplaces por escopo, veja de qual marketplace cada plugin veio e carregue diretórios locais de plugins com--plugin-dir. Plugins importados do Claude Code aparecem ao lado dos nativos. - Ctrl+L limpa a tela como em um shell: limpa a tela e o histórico de rolagem, mantendo a sessão em execução.
- Digitação fluida desde a primeira tecla. Corrigida uma pausa no loop de eventos (cerca de 1 segundo em repositórios grandes) que agrupava as primeiras teclas pressionadas; fechar paginadores não repinta mais a tela inteira.
- Skills em todos os lugares. As skills são carregadas nos modos interativo, sem interface gráfica e de integração com editor; invocações de
/skill-namefuncionam no modo de impressão-p. - Colagem de imagens da área de transferência no Linux. Cole imagens no Wayland e no X11.
- Preenchimento automático de
/model. Digite/model sonnete o seletor abre já filtrado, sem enviar o prompt. - O tema acompanha seu terminal. Alternar o terminal entre claro e escuro repinta a CLI automaticamente.
- Detecção de travamentos com novas tentativas persistentes. Fluxos travados são detectados e tentados novamente em vez de ficarem travados, e o backend pode recorrer ao transporte HTTP/1 em redes nas quais o HTTP/2 não funciona corretamente.
/mcpagrupado por escopo. Os servidores são organizados em Usuário / Projeto / Equipe, e os servidores com falha exibem o erro real.- Reforço da privacidade. A sumarização de conversas falha de forma segura para equipes sem armazenamento.
- Tokens delegados de worker. Contas de serviço da equipe podem gerar tokens de usuário de curta duração para que workers auto-hospedados sejam executados em nome de um membro específico da equipe.
- A interrupção mantém resultados parciais. Interromper uma interação preserva a saída dos comandos de shell em andamento, e as mensagens de acompanhamento movem as ferramentas em execução para o segundo plano em vez de encerrá-las.
/rewind: desfaça turnos do agente. Uma linha do tempo interativa restaura arquivos e o estado da conversa a qualquer turno anterior, com diffs de arquivos por turno, restauração apenas da conversa e aliases/undo//restore(ative em/config).- Notificações no desktop. Receba notificações quando um turno terminar ou o agente estiver aguardando sua ação (aprovações, perguntas, sudo) no iTerm2, Ghostty, Warp, Kitty e Terminal.app, com passagem por tmux/screen e silenciamento conforme o foco. As notificações de aprovação incluem o comando pendente.
/configinterativo. Um editor completo de configurações na CLI substitui a edição manual de JSON, incluindo uma página de versão e conta.- Linha de status personalizada. Aponte
statusLinepara seu próprio comando e exiba sua saída (com dados de uso de tokens em tempo real) no rodapé do prompt. - Perguntas paralelas com
/btw. Faça uma pergunta rápida em modo somente leitura durante um turno; a resposta é transmitida em uma sobreposição que pode ser fechada, com todo o contexto da conversa, e nunca altera seu histórico de conversa. - Inicialização mais leve. O carregamento de MCP saiu do caminho da primeira renderização, a configuração do servidor e o modelo ficam em cache entre execuções, o pacote de realce de sintaxe foi reduzido de 9,1 MB para 2,4 MB, e comandos de execução única ignoram totalmente a inicialização da UI.
- Pool de conexões HTTP/2 ativado por padrão. Maior throughput para chamadas de ferramenta e subagentes em paralelo.
- Movimentos de busca do Vim.
f/F/t/T/;/,com composição de operadores (df,,ct.). - Atalhos para colar imagens. Ctrl+V cola uma imagem da área de transferência; ao colar um arquivo de imagem copiado, a imagem em si é usada.
- Renderização de markdown e diffs. Espaçamento mais compacto, títulos estilizados, diffs unificados no estilo Git com linhas de contexto, diffs precisos para novos arquivos e uma correção para texto cinza sobre fundo escuro que ficava invisível em muitos temas, inclusive no modo escuro via SSH.
- Contexto no rodapé. O diretório de trabalho, a branch do Git e a PR aberta para sua branch, como link clicável, permanecem visíveis enquanto você digita.
- Guia de atalhos com
?,/copy,/rename. Descubra atalhos de entrada, copie mensagens anteriores e nomeie suas sessões. - Uma pergunta por vez. Perguntas para esclarecer dúvidas são apresentadas individualmente, com uma opção de resposta livre "Outra".
- Melhorias no modo headless.
--format jsonparastatus/about, o modo Plan funciona com-p, e os erros são registrados em transcrições para que scripts possam detectar execuções com falha. - Hooks são acionados de forma confiável. Eventos
afterAgentThought/afterAgentResponsesão emitidos na CLI, e respostas de hook no formato Claude Code são aceitas. - Servidores MCP globais aprovados automaticamente. Servidores de
~/.cursor/mcp.jsonsão carregados sem prompts por espaço de trabalho (servidores no nível do projeto ainda exigem aprovação), e as telas de aprovação de MCP ocultam segredos em URLs. - Instale plugins a partir de uma URL do Git. Cole uma URL de repositório na busca de plugins para instalar diretamente.
- Reforço da confiança e das aprovações. Worktrees herdam a confiança do espaço de trabalho, prompts de aprovação não podem ser ignorados por um Enter acidental, e a CLI oferece persistir "Executar Tudo" após uso repetido.
- Subagentes na CLI. Agentes em paralelo são executados localmente, com status em tempo real em sessões interativas, sem interface gráfica e no Editor, herdando suas credenciais, regras e política de aprovação. O modo Max e as configurações de chave personalizada são propagados aos subagentes.
- Run Everything tem seu próprio controle. A aprovação automática é controlada por
/auto-run(e--force/--yolo) separadamente do ciclo de modos com Shift+Tab, e os modos de aprovação configurados pela equipe são respeitados em execuções sem interface gráfica. - Plugins chegaram. Navegue pelo marketplace e instale ou desinstale plugins no escopo do usuário ou do projeto com
/plugin; skills, comandos slash, subagentes e servidores MCP de plugins são carregados na sessão. - Novas tentativas ativadas por padrão. Streams interrompidos ou travados são repetidos automaticamente em todos os modos, e erros de servidor classificados (como limites de taxa) exibem sua mensagem real.
- Suporte a
permissions.json. A CLI lê o mesmo arquivo de lista de permissões do terminal/MCP que a IDE. - Suporte a proxy corporativo para autenticação. O login e a validação de chave de API passam por
HTTPS_PROXY, permitindo o uso em redes no estilo Zscaler. - Tarefas em segundo plano. Pressionar Ctrl+B duas vezes envia um shell em execução para segundo plano; execuções sem interface gráfica aguardam a conclusão do trabalho em segundo plano (emitindo eventos para consumidores de
stream-json), e as notificações de conclusão são exibidas corretamente. - Melhorias no worker auto-hospedado. Não requer sudo, corrige desconexões por inatividade, inclui atualização automática de token, endpoint de métricas do Prometheus, suporte ao Windows, nomes personalizados e suporte a proxy.
- Skills de diretórios de outras ferramentas. As skills também são encontradas em
.claude/skills,.agents/skillse.codex/skills. - Correções de OAuth para MCP remoto. Servidores OAuth rigorosos (estado/escopos) funcionam com
/mcp login, e os placeholders${VAR}são expandidos em configurações MCP em qualquer lugar. --imageem qualquer lugar. Anexe imagens em qualquer sessão, não apenas no modo de impressão.- Integrações com editores. Seleção de modelo e modo pelo Agent Client Protocol (Zed, JetBrains), suporte a servidores MCP fornecidos pelo host, streaming mais completo com raciocínio e locais de arquivos, e comandos slash de skills.
- Chaveiro do macOS bloqueado detectado via SSH. Uma mensagem clara de "desbloqueie seu chaveiro" substitui falhas de credenciais pouco claras.
- Controles de administração. Listas de permissão e bloqueio de rede são aplicadas incondicionalmente (inclusive ao tráfego MCP), o sandbox desativado pelo administrador é respeitado pela execução automática, e a geração de imagens pede confirmação antes de ser executada.
- Claude Sonnet 4.6 no Bedrock. Adicionado à lista de modelos com chave própria.
- Payloads de hooks mais completos. Uso de tokens por turno e um ID de sessão estável.
- Git worktrees.
--worktree/-wexecuta o agente em um worktree isolado (com--worktree-basepara a branch base), mantendo as alterações do agente fora do seu checkout; o sandbox entende totalmente os layouts de worktree. - Travamento no modo sem interface gráfica corrigido. Execuções com
-pnão bloqueiam mais quando iniciadas com um pipe stdin aberto (Node, Python, executores de CI), e o failover de conexão em redes parcialmente inacessíveis caiu de cerca de 20 segundos para 8. --yolo. Execuções totalmente autônomas que aprovam automaticamente de forma consistente permissões de confiança, MCP e comandos.- AWS Bedrock com suas próprias credenciais.
agent bedrockconfigura chaves de acesso ou uma função IAM da equipe; funciona em sessões interativas, sem interface gráfica e no Editor. - Reconexão automática. Erros de transporte são repetidos com um indicador visível de "Reconectando…".
- UI de revisão.
/changes(Ctrl+R) unificado, com uma aba Sessão que mostra apenas as edições desta sessão,o/Opara abrir diffs no seu editor e uma alternância para o modo zen durante a revisão. - Uso de tokens para scripts. Totais por turno de tokens de entrada/saída/cache e um
request_idna saída destream-json; transcrições no modo sem interface gráfica gravam JSONL compatível com Claude Code. -H/--headerrepetível. Passe vários cabeçalhos no estilo curl.- Arquivos de política do sandbox.
~/.cursor/sandbox.jsone.cursor/sandbox.jsonsão respeitados (inclusive via SSH), o acesso à rede tem modos claros, e a CLI falha rapidamente com um motivo claro quando o sandbox está ativado, mas indisponível. - Melhorias no modo Plano. Um menu de plano persistente com Construir localmente / Construir na nuvem, e o conteúdo do plano é transferido corretamente para agentes em nuvem.
- Inicialização mais rápida, turnos mais ágeis. Inicialização paralelizada, verificações de atualização adiadas e renderização otimista de mensagens.
- Melhorias de renderização. Tabelas Markdown se ajustam à largura do seu terminal, blocos de reflexão renderizam Markdown, comandos de shell recebem realce de sintaxe e o Mermaid renderiza mais tipos de diagramas.
- Correções de entrada em vários terminais. Vim
r(substituir caractere), exclusão de palavras com Alt+Delete, nova linha com Ctrl+J no iTerm2, tecla Delete do Windows, suporte à área de transferência do Wayland e histórico de prompts local à sessão. - Controle corporativo de atribuição. A atribuição de commits/PRs desativada pelo administrador é aplicada na CLI, independentemente das configurações locais.
- Erros claros para capturas de tela bloqueadas. Falhas de permissão no macOS exibem um aviso e uma solução alternativa, em vez de falhar silenciosamente.
- Hooks. Hooks de início e fim de sessão, hooks de parada com loops de acompanhamento (padrões autônomos de "continuar"), pré-compactação e hooks de ciclo de vida de subagentes; os hooks de
settings.jsondo Claude Code são lidos e mesclados; administradores podem enviar hooks gerenciados pela equipe, com precedência enterprise > equipe > projeto > usuário. - Permissões e sandbox alinhados ao IDE. Um modelo de três modos (Executar Tudo / Executar Automaticamente no Sandbox / Perguntar Sempre), um menu interativo
/sandbox, um proxy de rede que nega tudo por padrão para comandos em sandbox e listas de permissão de rede de administradores de equipe aplicadas na CLI. sudofunciona. Comandos que precisam de sudo acionam uma solicitação de senha mascarada enviada por um soquete local restrito; o modelo nunca vê sua senha.- Modos Plan e Ask. Flags de inicialização
--mode plan|ask,/plan <prompt>, alternância de modo com Shift+Tab e UIs nativas para perguntas, mudanças de modo e revisão de planos, com planos salvos em disco. - Digitação responsiva durante o streaming. Entrada em buffer com renderização adiada da saída em streaming, e mensagens de acompanhamento enfileiradas são enviadas instantaneamente.
- Transfira para agentes em nuvem. Digite
¶ transferir a conversa ativa para um agente em nuvem e continuar trabalhando. --continue. Retome seu chat mais recente sem procurar um ID; as transcrições persistem em disco para ferramentas e hooks.- Aplicação de confiança sem interface. Execuções não interativas em espaços de trabalho não confiáveis falham com orientação, a menos que
--trust(ou--force) seja informado. - Gerenciamento de MCP.
/mcp listé um paginador interativo com status, login, ativação e navegação por ferramentas; login OAuth corrigido; a configuração do projeto substitui corretamente a do usuário; lista de permissão por ferramenta na solicitação de aprovação. - Skills, regras e comandos na CLI. Navegação por
/skillse invocação inline de/skill-name, skills integradas selecionadas e navegadores interativos de/rulese/commandscom edição inline. - Autocompletar de
/modele Modo Max. Busca aproximada de modelos com nomes amigáveis, além de/max-modecom um indicador no rodapé que persiste entre sessões. - Renderização de Markdown. Tabelas alinhadas, links clicáveis, linhas horizontais e diffs inline por palavra em revisões de arquivos.
- UI de subagentes. Renderização ao vivo para subagentes paralelos, com status por agente, atividade em streaming e contagens de tokens.
- Base para integração com editores. Retomada de sessão, modos de agente reais, renderização granular de ferramentas e comandos de barra personalizados pelo Agent Client Protocol (Zed e outros).
- Confiabilidade no Windows. Funciona sob políticas restritas de execução do PowerShell, detecta o Git Bash e corrige o login pelo navegador; suporte à área de transferência disponível no Windows e no Linux.
- Autenticação e atualizações. Tokens expirados solicitam novo login em vez de causar falhas, erros transitórios do servidor não desconectam mais você, atualizações automáticas paralelas não podem corromper uma instalação e
--disable-auto-updatedesativa atualizações em segundo plano. - Inicialização mais rápida. O cache de compilação e a inicialização sob demanda reduzem o tempo de inicialização a quente em cerca de 10%.