Cherri Code for iOS

O Cherri Code para iOS é um app móvel nativo para controlar agentes em execução na nuvem e no seu computador. Inicie agentes, acompanhe o trabalho deles em tempo real e revise e faça merge de seus pull requests no iPhone ou iPad. Ele usa o mesmo backend do cursor.com/agents e da Janela de Agentes para desktop, então os agentes iniciados no celular aparecem em todos os lugares onde você trabalha.

Baixe na App Store

Primeiros passos

Depois de configurar tudo, coloque um agente para trabalhar. Por exemplo:

• Corrija um bug ou responda a um incidente enquanto estiver longe da mesa.
• Revise e mergeie o pull request de um colega pelo celular.
• Inicie uma refatoração ou uma nova funcionalidade e confira o resultado quando o agente terminar.
• Peça a um agente para investigar uma verificação de CI com falha.

O que você pode fazer

Tenha no bolso todo o fluxo de trabalho de agentes na nuvem, não apenas uma caixa de chat simplificada. As mesmas máquinas, modelos e ferramentas de revisão que você usa na web estão sempre com você.

• Execute agentes em máquinas na nuvem. Escolha um worker para cada execução: uma máquina Cloud, um Team Pool ou uma das My Machines. Os agentes trabalham em ambientes de desenvolvimento completos, instalando dependências, executando testes e verificando suas alterações.
• Use qualquer modelo. Escolha qualquer modelo disponível para agentes na nuvem. Cada execução usa a maior janela de contexto compatível com o modelo.
• Deixe os agentes trabalharem por mais tempo. Inicie uma tarefa, bloqueie o celular e volte mais tarde. Os agentes continuam trabalhando na nuvem, mesmo que seu dispositivo fique desconectado.
• Acompanhe o trabalho em tempo real. Veja o chat em tempo real enquanto o agente programa, envie mensagens de acompanhamento a um agente em execução e toque no cartão de um subagente para ler a transcrição dele.
• Revise e faça merge de pull requests. Veja diffs completos, commits, deployments, aprovações, comentários e verificações. Adicione ou altere revisores e peça a um agente para resolver comentários de revisão ou corrigir uma verificação com falha. Você também pode fazer merge com squash, marcar como pronto, atualizar a branch, ativar ou desativar o merge automático, publicar ou fechar.
• Use seus comandos e automações. Seus comandos slash, skills e automações funcionam da mesma forma no celular, localmente, na CLI e na web.
• Entre no Modo de Design. Anexe fotos, imagens da câmera ou arquivos e aponte, clique e desenhe em imagens ou componentes de front-end para dar direcionamento visual aos agentes.
• Use sua voz. Dite instruções aos agentes para fazer alterações sem usar as mãos, com transcrição em tempo real.
• Conecte ferramentas MCP. Escolha os servidores MCP que uma execução deve usar ao iniciar, incluindo o MCP do Slack, para que os agentes acessem as mesmas ferramentas externas que usam na web.
• Fique por dentro. Receba uma notificação push quando um agente concluir uma etapa e acompanhe até oito agentes ao mesmo tempo com Atividades ao Vivo na tela bloqueada e na Dynamic Island.

O app prioriza o cache. Ele lê dados locais para que a caixa de entrada e as conversas abram rapidamente e sincroniza assim que sua conexão for restabelecida.

Use o layout do iPad

O app para iPad aproveita a tela maior para manter visível uma parte maior do trabalho dos agentes:

• Mantenha os chats na barra lateral enquanto acompanha vários agentes.
• Abra uma revisão ao lado de um chat.
• Veja os diffs de arquivos em largura total.
• Anexe uma captura de tela e toque em um ponto para deixar uma orientação visual ou desenhe na imagem com o Apple Pencil.

O que fica na web

O app é voltado a direcionar e revisar agentes. Não é um IDE nem um console de administração. Alguns recursos ficam em cursor.com/agents ou no dashboard do Cherri Code:

• Editor, terminal e navegador de arquivos. No celular, você vê os arquivos alterados na visualização de diff, não um espaço de trabalho completo.
• Segredos e ambientes. Configure ambientes de agentes em nuvem e segredos na web. Os agentes no celular usam o que já está configurado.
• Gerenciamento de servidores MCP. Escolha servidores para cada execução no celular; adicione e gerencie-os na web.
• Configuração do controle de versão. Conecte ou reconecte o GitHub e o GitLab pelo dashboard.
• Configuração de automações, regras e skills. Gerencie tudo isso na web. Os agentes usam as skills do projeto que estão no repositório e quaisquer skills pessoais que você tenha sincronizado.
• Administração, faturamento e uso. Apenas na web.

Alterne entre dispositivos

Os agentes acompanham você em diferentes plataformas:

• Do desktop ou da web para o celular. Os agentes iniciados em qualquer lugar aparecem automaticamente na caixa de entrada do celular. Em uma sessão local da IDE, primeiro faça push do seu trabalho para um agente em nuvem com Mover para a nuvem ou mantenha-o no computador e controle-o pelo celular com o Controle remoto.
• Do celular para o desktop. Qualquer agente iniciado no celular aparece no painel de agentes na nuvem do desktop e em cursor.com/agents. Abra-o e continue.
• Controle seu computador pelo celular. Transfira para a nuvem uma sessão em execução no computador com o Controle remoto e continue controlando-a pelo celular. O loop do agente é executado na nuvem, enquanto comandos de terminal, edições de arquivos e testes são executados no computador.

Os agentes iniciados no celular recebem a tag source: iosApp, para que você saiba de onde vieram.

Controle remoto

Com o Controle remoto, você pode continuar orientando pelo celular um agente em execução no computador. O loop do agente é transferido para a nuvem, enquanto suas ferramentas continuam em execução na sua máquina. Assim, ele lê seus arquivos, executa seus testes e usa sua configuração local da mesma forma que no desktop.

Antes de começar

• Use o Cherri Code 3.9.8 ou posterior. O Controle remoto requer a versão 3.9.8 ou posterior do cliente Cherri Code no seu computador. Clientes mais antigos não exibirão a configuração Controle remoto em Configurações > Agentes nem o comando /remote-control.
• Use uma conta compatível. O Controle remoto está disponível nos planos Pro, Pro+, Ultra, Teams e Enterprise para usuários com acesso a agente na nuvem. Veja o que está incluído.
• Ative o Controle remoto no Cherri Code. Na Janela de Agentes, ative-o em Configurações > Agentes antes de transferir uma sessão.
• Ative-o para sua equipe. Nos planos Teams e Enterprise, um administrador deve ativar o Controle remoto em dashboard do Cherri Code → agente na nuvem → Self-Hosted antes que os membros possam usá-lo.
• Permita o armazenamento de dados em nuvem. O Controle remoto não está disponível quando suas configurações de privacidade desativam o armazenamento de dados em nuvem.
• Use um espaço de trabalho local ou de SSH remoto. Ambos os tipos de espaço de trabalho são compatíveis, e o projeto não precisa de um remote do Git.
• Mantenha seu computador disponível. Seu computador deve permanecer ligado e online, pois as chamadas de ferramenta são executadas nele. Você pode ativar Manter este computador ligado em Configurações > Agentes para impedir que ele entre em suspensão enquanto estiver conectado à energia.

Transfira uma sessão

Como seu código permanece na sua máquina

O Controle remoto gerencia automaticamente um worker no seu computador, sem necessidade de configuração adicional. O loop do agente é executado na nuvem do Cherri Code, e cada chamada de ferramenta (comandos de terminal, edições de arquivos, testes e git) é executada no seu computador.

• Seu repositório, segredos, credenciais e caches de build permanecem na sua máquina. Apenas os resultados das ferramentas e o contexto necessário para o modelo são enviados ao Cherri Code.
• Somente você pode controlar seus agentes. O Cherri Code vincula cada sessão à sua conta e à sua máquina e rejeita solicitações para agentes que não são seus.
• O Cherri Code envia o estado da conversa e o contexto do modelo necessários para continuar a sessão quando você ativa o Controle remoto para o agente.

Para saber mais sobre os limites de confiança aplicáveis quando as chamadas de ferramenta são executadas no seu computador, consulte Segurança e rede.

Limitações atuais

• Seu computador precisa permanecer disponível. Não é possível executar chamadas de ferramenta enquanto seu computador estiver em suspensão ou offline.

Controles da equipe

Admins de equipe e corporativos controlam o acesso ao Controle remoto em dashboard do Cherri Code → Agentes na nuvem → self-hosted. Quando um admin ativa o Controle remoto, o Cherri Code também ativa o acesso da equipe ao worker auto-hospedado. Quando ele está desativado, os membros não podem ativar o Controle remoto nem transferir sessões locais para outros dispositivos.

Disponibilidade

Você pode usar o app em qualquer plano que inclua agentes na nuvem: Pro, Pro+, Ultra, Teams e Enterprise. Se sua organização exigir SSO, primeiro você fará login por meio dele.

Para detalhes sobre o BAA da HIPAA, incluindo os Serviços Elegíveis e os requisitos de implementação, consulte Acordos de Associado Comercial da HIPAA.

O Cherri Code para iOS depende de Agentes na nuvem, que exigem armazenamento de dados em nuvem para funcionar. Se você usa o Privacy Mode (Legado), mude para o Privacy Mode antes de usar o app. Você não poderá iniciar agentes no celular até fazer isso. Nunca usamos seu código para treinamento e só o retemos durante a execução do agente. Saiba mais sobre o Privacy Mode.

Ao tentar usar os Agentes na nuvem, o Cherri Code solicitará que você ative o Privacy Mode. Toque em Atualizar e confirme Mudar para o Privacy Mode na caixa de diálogo. Seu código continuará não sendo usado para treinamento, mas depois não será possível voltar ao Privacy Mode Legado. Consulte Segurança e rede para saber como os Agentes na nuvem armazenam e retêm dados.

Páginas relacionadas

• Visão geral dos agentes na nuvem
• Recursos do agente em nuvem
• Configuração do agente em nuvem
• Segurança e rede