Bugbot

O Bugbot revisa pull requests e identifica bugs, problemas de segurança e problemas de qualidade do código.

Configure o Bugbot em Automações.

Como funciona

O Bugbot analisa diffs de PR e deixa comentários com explicações e sugestões de correção. Ele é executado automaticamente a cada atualização de PR ou manualmente quando acionado.

• Executa revisões automáticas a cada atualização de PR
• Acionamento manual ao comentar cursor review ou bugbot run em qualquer PR
• Usa comentários existentes do PR como contexto: lê comentários vinculados ao PR (no nível superior e inline) para evitar sugestões duplicadas e aproveitar feedback anterior
• Os links Fix in Cherri Code abrem issues diretamente no Cherri Code
• Os links Fix in Web abrem issues diretamente em cursor.com/agents

Configuração

Conecte seus repositórios pelo dashboard do Cherri Code para começar a usar o Bugbot.

• GitHub (incluindo o GitHub Enterprise Server): Consulte a página de integração com o GitHub
• GitLab (incluindo o GitLab Self-Hosted): Consulte a página de integração com o GitLab
• Bitbucket (incluindo o Bitbucket Data Center): Consulte a página de integração com o Bitbucket
• Azure DevOps (Azure DevOps Services): Consulte a página de integração com o Azure DevOps

Após conectá-los, abra o Bugbot em Automações para ativá-lo em repositórios específicos.

Status das verificações de CI

O Bugbot publica um status para cada execução de revisão. No GitHub, ele aparece como uma verificação chamada Cherri Code Bugbot. No Bitbucket, aparece como um status de build com a chave cursor-bugbot. No Azure DevOps, aparece como um status com o contexto cursor-bugbot/review. O status pode ter as seguintes conclusões:

• success: o Bugbot não encontrou issues e não há comentários não resolvidos do Bugbot de execuções anteriores.
• neutral: o Bugbot encontrou issues, a execução foi cancelada por um commit mais recente ou ocorreu um erro interno no Bugbot. Esta é a conclusão padrão quando o Bugbot relata achados.
• failure: o Bugbot encontrou issues e a verificação está configurada para falhar em caso de issues não resolvidas.

Se você usa proteção de branch, exija a verificação ou o status de build do Bugbot para garantir que ele seja executado antes do merge. Exigir apenas o status não bloqueia merges com achados porque, por padrão, eles recebem neutral. Se o comportamento de falhar em issues não resolvidas estiver disponível para sua organização, habilite-o para que achados não resolvidos gerem um status de falha. O Bugbot não emite a conclusão skipped.

Quando o Bugbot Autofix está habilitado, o GitHub também pode mostrar uma verificação separada, Cherri Code Bugbot Autofix. Essa verificação usa apenas success ou neutral.

Configuração

Analytics

Abra o Bugbot em Automações para ver a atividade e os resultados das revisões.

API

Equipes corporativas podem usar a Bugbot API para acionar revisões e acessar análises por revisão. Crie uma chave de API em dashboard do Cherri Code → API Keys e autentique-se com Autenticação Básica.

curl --request POST \  --url https://api.cursor.com/bugbot/review \  -u YOUR_API_KEY: \  --header 'Content-Type: application/json' \  --data '{    "prUrl": "https://github.com/your-org/your-repo/pull/42"  }'

curl --request POST \  --url https://api.cursor.com/bugbot/review \  -u YOUR_API_KEY: \  --header 'Content-Type: application/json' \  --data '{    "prUrl": "https://github.com/your-org/your-repo/pull/42",    "dryRun": true  }'

{  "outcome": "success",  "message": "Bugbot review queued",  "request_id": "6e0d261c-86a2-4383-89f0-9162c1c10662",  "dry_run": false}

{  "outcome": "error",  "message": "Bugbot is disabled for this repository"}

curl --get https://api.cursor.com/analytics/team/bugbot-reviews \  -u YOUR_API_KEY: \  --data-urlencode 'startDate=2026-06-01' \  --data-urlencode 'endDate=2026-06-29' \  --data-urlencode 'repo=github.com/your-org/your-repo' \  --data-urlencode 'prNumber=42' \  --data-urlencode 'page=1' \  --data-urlencode 'pageSize=100'

curl --get https://api.cursor.com/analytics/team/bugbot-reviews \  -u YOUR_API_KEY: \  --data-urlencode 'dryRun=true' \  --data-urlencode 'repo=github.com/your-org/your-repo' \  --data-urlencode 'prNumber=42'

{  "data": [    {      "request_id": "6e0d261c-86a2-4383-89f0-9162c1c10662",      "timestamp": "2026-06-29T19:42:18.000Z",      "repo": "github.com/your-org/your-repo",      "repo_node_id": "R_kgDOABCDEF",      "pr_number": 42,      "commit_sha": "9f3c2a1b7d8e4f5061728394a5b6c7d8e9f0a1b2",      "bugs_found": 2,      "cost_cents": 42.5,      "dry_run": false,      "publication_status": "posted",      "bugs": [        {          "comment_id": "2147483999",          "resolution_status": "resolved",          "severity": "high"        },        {          "comment_id": "2147484000",          "resolution_status": "unresolved",          "severity": "medium"        }      ]    }  ],  "pagination": {    "page": 1,    "pageSize": 100,    "totalItems": 1,    "totalPages": 1,    "hasNextPage": false,    "hasPreviousPage": false  },  "params": {    "metric": "bugbot-reviews",    "teamId": 12345,    "startDate": "2026-06-01",    "endDate": "2026-06-29",    "repo": "github.com/your-org/your-repo",    "prNumber": 42,    "page": 1,    "pageSize": 100  }}

{  "data": [    {      "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",      "timestamp": "2026-06-29T20:15:03.000Z",      "repo": "github.com/your-org/your-repo",      "repo_node_id": "R_kgDOABCDEF",      "pr_number": 42,      "commit_sha": "9f3c2a1b7d8e4f5061728394a5b6c7d8e9f0a1b2",      "bugs_found": 1,      "cost_cents": null,      "dry_run": true,      "publication_status": "dry_run",      "bugs": [        {          "comment_id": null,          "resolution_status": null,          "severity": "medium",          "title": "Unbounded retry loop",          "description": "retry() recurses without a ceiling.",          "locations": [            { "file": "src/net.ts", "start_line": 5, "end_line": 9 }          ]        }      ]    }  ],  "pagination": {    "page": 1,    "pageSize": 100,    "totalItems": 1,    "totalPages": 1,    "hasNextPage": false,    "hasPreviousPage": false  },  "params": {    "metric": "bugbot-reviews",    "teamId": 12345,    "startDate": "2026-06-01",    "endDate": "2026-06-29",    "repo": "github.com/your-org/your-repo",    "prNumber": 42,    "dryRun": true,    "page": 1,    "pageSize": 100  }}

Acione e recupere uma revisão

1. Chame POST /bugbot/review com a URL do pull request. Passe "dryRun": true para analisar sem publicar no SCM.
2. Salve o request_id retornado.
3. Consulte periodicamente GET /analytics/team/bugbot-reviews, filtrando por repo e prNumber. Use dryRun=true se tiver acionado uma revisão em modo dry-run.
4. Encontre o item cujo request_id corresponda ao da resposta do acionamento.

O Analytics pode levar alguns instantes para ficar disponível após uma revisão ser enfileirada.

Revisões incrementais

Por padrão, o Bugbot revisa apenas as alterações desde a revisão anterior do Bugbot. Desative a Revisão incremental em Bugbot Automações para revisar todo o diff da pull request a cada push.

Resumos de PR

O Bugbot escreve um resumo de cada pull request que revisa. A opção Post PR Summary em Bugbot Automações controla onde o resumo é publicado:

• Na descrição (padrão): o Bugbot adiciona o resumo à descrição do pull request e o atualiza a cada revisão.
• As Comment: o Bugbot publica o resumo como um comentário e atualiza esse comentário a cada revisão.
• Off: o Bugbot não publica nenhum resumo.

Ative ou desative os resumos dos seus próprios PRs com a configuração pessoal PR Summaries. Escolha On, Off ou Use Installation Default.

Níveis de esforço

Os níveis de esforço controlam quanto tempo o Bugbot dedica ao raciocínio durante uma revisão. Níveis de esforço mais altos podem identificar mais bugs, mas cada revisão pode levar mais tempo e consumir mais recursos de uso.

Escolha um dos seguintes níveis de esforço:

• Baixo: Otimiza o custo, com qualidade próxima à do Padrão. As revisões são mais baratas e demoram mais.
• Padrão: Otimiza a eficiência e a velocidade. As revisões são mais baratas, mas o Bugbot pode identificar menos bugs.
• Alto: Dedica mais tempo ao raciocínio. As revisões são mais caras e demoram mais, mas o Bugbot pode identificar mais bugs.
• Inteligente: Permite descrever quando o Bugbot deve usar os níveis Baixo, Padrão ou Alto. O Cherri Code define dinamicamente os níveis de esforço com base nas suas instruções.

Regras

Oriente as revisões usando Regras da equipe, regras do repositório e arquivos .cursor/BUGBOT.md do projeto.

Regras da equipe

Os admins da equipe podem criar regras no Bugbot Automations que se aplicam a todos os repositórios da equipe. Essas regras ficam disponíveis para todos os repositórios habilitados, facilitando a aplicação de padrões em toda a organização.

Limites das regras

Cada regra é truncada em 30.000 caracteres quando incluída em uma revisão. O conjunto de regras que o Bugbot inclui em uma revisão é limitado a 100.000 caracteres. Se você exceder esse limite total, algumas regras poderão ser omitidas. As regras obrigatórias da equipe têm prioridade sobre as regras não obrigatórias.

Veja quais regras foram usadas em uma revisão

Comente bugbot run verbose=true ou cursor review verbose=true em uma pull request. O Bugbot publica uma tabela com todas as regras incluídas nessa execução e sinaliza as que foram truncadas ou omitidas.

Regras do repositório

Regras do projeto

Crie arquivos .cursor/BUGBOT.md para fornecer contexto específico do projeto às revisões. O Bugbot sempre inclui o arquivo .cursor/BUGBOT.md na raiz e quaisquer arquivos adicionais encontrados ao percorrer os diretórios acima dos arquivos alterados.

project/  .cursor/BUGBOT.md          # Sempre incluído (regras de todo o projeto)  backend/    .cursor/BUGBOT.md        # Incluído ao revisar arquivos do backend    api/      .cursor/BUGBOT.md      # Incluído ao revisar arquivos da API  frontend/    .cursor/BUGBOT.md        # Incluído ao revisar arquivos do frontend

Regras aprendidas

Em regras de repositório do Bugbot, ative o aprendizado para suas organizações e repositórios.

As regras são geradas automaticamente com base na atividade da sua equipe no GitHub nesse repositório ou preenchidas manualmente a partir do histórico do repositório.

Você também pode ensinar novas regras ao Bugbot inline comentando @cursor remember [fact] em qualquer PR. O Bugbot salva o fato como uma regra aprendida e a aplica em revisões futuras.

O Cherri Code ativa ou desativa regras automaticamente à medida que aprende mais sobre a atividade da sua equipe ao longo do tempo.

Regras manuais

Em regras de repositório do Bugbot, você pode criar regras manuais para repositórios individuais. Assim como as regras aprendidas, as regras manuais só se aplicam quando o aprendizado está habilitado para a organização e para o repositório.

Analytics da regra

As Analytics de uma regra do Bugbot mostram seu desempenho em PRs reais:

Exemplos

Se algum arquivo alterado contiver o padrão de string /\beval\s*\(|\bexec\s*\(/i, então:- Adicione um Bug bloqueador com o título "Execução dinâmica perigosa" e o corpo:  "Foi encontrado uso de eval/exec. Substitua por alternativas seguras ou justifique-o com um comentário detalhado e testes."- Atribua o Bug ao autor da PR.- Aplique o rótulo "security".

Se a PR modificar arquivos de dependências (package.json, pnpm-lock.yaml, yarn.lock, requirements.txt, go.mod, Cargo.toml), então:- Execute a Verificação de Licenças integrada.- Se alguma dependência nova ou atualizada tiver uma licença em {GPL-2.0, GPL-3.0, AGPL-3.0}, então:  - Adicione um Bug bloqueador com o título "Licença não permitida detectada"  - Inclua no corpo do Bug os nomes, as versões e as licenças dos pacotes infratores  - Aplique os rótulos "compliance" e "security"

Para arquivos correspondentes a **/*.{js,jsx,ts,tsx} em projetos React:Se um arquivo alterado contiver /componentWillMount\s*\(/, então:- Adicione um Bug bloqueador com o título "Método obsoleto do ciclo de vida do React"- Corpo: "Substitua componentWillMount por constructor ou useEffect. Consulte a documentação do React."- Sugira um trecho de autofix que migre efeitos colaterais para useEffect.

Se a PR modificar arquivos em {server/**, api/**, backend/**} e não houver alterações em {**/*.test.*, **/__tests__/**, tests/**}, então:- Adicione um Bug bloqueador com o título "Testes ausentes para alterações de backend"- Corpo: "Esta PR modifica código de backend, mas não inclui testes correspondentes. Adicione ou atualize os testes."- Aplique o rótulo "quality"

Se algum arquivo alterado contiver /(?:^|\s)(TODO|FIXME)(?:\s*:|\s+)/, então:- Adicione um Bug não bloqueador com o título "Comentário TODO/FIXME encontrado"- Corpo: "Substitua TODO/FIXME por uma referência a uma issue rastreada, por exemplo, `TODO(#1234): ...`, ou remova-o."- Se o TODO já fizer referência a um padrão de issue /#\d+|[A-Z]+-\d+/, marque o Bug como resolvido automaticamente.

Execute no seu agente

Use as skills /review-bugbot ou /review para executar o Bugbot no seu agente antes de enviar o código.

Qual diff é revisado: Por padrão, /review-bugbot revisa as alterações da sua branch: todas as alterações em relação à branch base, incluindo alterações com e sem commit. Peça para revisar apenas as alterações sem commit quando quiser um feedback mais específico.

Em relação a qual branch: /review-bugbot compara com sua branch base padrão. Quando sua branch base não for a padrão (como main), informe ao agente com qual branch comparar ou deixe que ele deduza pelo contexto.

Sincronize com sua pull request

As revisões do /review-bugbot permanecem sincronizadas com o Bugbot no SCM conectado (GitHub, GitLab ou Bitbucket).

Nos bastidores, o /review-bugbot armazena o ID do patch do diff revisado. Quando o Bugbot no seu SCM detecta um diff com o mesmo ID de patch, ele pula a revisão e deixa um comentário informando que aquele diff já foi revisado.

Um caso de uso comum: execute /review-bugbot, abra uma pull request com o mesmo diff, e o Bugbot reconhecerá a revisão e pulará a revisão remota da PR.

Autofix

O Bugbot Autofix cria automaticamente um agente em nuvem para corrigir bugs encontrados em revisões de PR.

Como funciona

Quando o Bugbot encontra bugs durante uma revisão de PR, ele pode automaticamente:

1. Criar um agente em nuvem para analisar e corrigir as issues relatadas
2. Enviar as correções para a branch existente ou para uma nova branch, dependendo das suas configurações
3. Publicar um comentário na PR original com os resultados

Configuração

Configure o comportamento do autofix em Bugbot Automações.

Os modos de autofix disponíveis dependem do seu provedor de repositório:

As configurações da instalação oferecem apenas os modos aos quais seu provider oferece suporte. Se sua configuração pessoal escolher um modo sem suporte no seu provider, o Bugbot ignora a execução do autofix nesse PR.

Requisitos

O Autofix requer:

• preços de uso sob demanda habilitados
• armazenamento habilitado (exceto no Privacy Mode legado)

Faturamento

O Autofix usa créditos do agente em nuvem e é cobrado de acordo com as tarifas do seu plano. O faturamento do agente em nuvem segue o seu plano de preços.

Suporte a MCP

O Bugbot é integrado aos seus servidores MCP, permitindo que suas ferramentas de IA interajam diretamente com ele. Use o servidor MCP para fornecer ferramentas adicionais que orientem o processo de revisão do Bugbot.

Para começar:

1. Consulte a documentação do MCP para ver as instruções de configuração do servidor MCP.
2. Adicione as ferramentas ao Bugbot em Automações.

API de configuração de administração

Os administradores da equipe podem usar a API de administração do Bugbot para gerenciar repositórios e controlar quais usuários podem usar o Bugbot. Use-a para automatizar o gerenciamento de repositórios, habilitar o Bugbot em vários repositórios ou integrar o provisionamento de usuários a ferramentas internas.

Autenticação

Todos os endpoints exigem uma chave da API de administração da equipe, enviada como token Bearer:

Authorization: Bearer $API_KEY

Para criar uma chave de API:

1. Acesse as chaves de API no dashboard do Cherri Code
2. Clique em Nova chave de API
3. Salve a chave de API

Todos os endpoints têm um limite de 60 solicitações por minuto por equipe.

Ativar ou desativar repositórios

Use o endpoint /bugbot/repo/update para ativar ou desativar o Bugbot em um repositório:

curl -X POST https://api.cursor.com/bugbot/repo/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "repoUrl": "https://github.com/your-org/your-repo",    "enabled": true,    "manualTriggerOnly": false  }'

Parâmetros:

• repoUrl (string, obrigatório): URL completa do repositório
• enabled (boolean, obrigatório): true para habilitar o Bugbot e false para desabilitá-lo
• manualTriggerOnly (boolean, opcional): Quando true, o Bugbot não será executado automaticamente em atualizações de PR neste repositório. Acionamentos manuais, como comentar cursor review ou bugbot run, continuam funcionando.

Listar repositórios

Use o endpoint /bugbot/repos para listar todos os repositórios com as configurações do Bugbot da sua equipe:

curl https://api.cursor.com/bugbot/repos \  -H "Authorization: Bearer $API_KEY"

A resposta inclui o status de habilitação, a configuração somente manual e os timestamps de cada repositório.

Gerenciar o acesso de usuários

Use o endpoint /bugbot/user/update para controlar quais usuários do GitHub, GitLab ou Bitbucket podem usar as licenças do Bugbot da sua equipe. Empresas usam esse endpoint para integrar o provisionamento do Bugbot às ferramentas internas de solicitação de acesso.

Pré-requisitos

Antes de chamar este endpoint, habilite o modo de lista de permissão ou de lista de bloqueio nas configurações do Bugbot da sua equipe:

• Modo de lista de permissão ("Only..."): apenas os usuários da lista podem usar o Bugbot
• Modo de lista de bloqueio ("Everyone but..."): todos os usuários podem usar o Bugbot, exceto os da lista

Se nenhum dos modos estiver habilitado, a API retorna um erro.

Adicionar ou remover um usuário

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "username": "octocat",    "allow": true  }'

Parâmetros:

• username (string, obrigatório): O nome de usuário do GitHub, GitLab ou Bitbucket (não diferencia maiúsculas de minúsculas)
• allow (boolean, obrigatório): Indica se o acesso deve ser concedido ou revogado

O comportamento de allow depende do modo ativo:

Resposta:

{  "outcome": "success",  "message": "Updated team-level allowlist for @octocat",  "updatedTeamSettings": true,  "updatedInstallations": 0}

Exemplo: provisionamento de usuários por meio de uma ferramenta interna

Conecte esta API a um portal interno de solicitação de acesso. Quando um funcionário solicita acesso ao Bugbot, o portal chama a API para adicioná-lo. Quando ele sai da empresa ou perde o acesso, o portal chama a API para removê-lo.

Conceder acesso:

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"username": "employee-scm-username", "allow": true}'

Revogar acesso:

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"username": "employee-scm-username", "allow": false}'

Preço

O Bugbot usa faturamento por uso.

Faturamento

Solução de problemas

Se o Bugbot não estiver funcionando:

1. Habilite o modo detalhado comentando cursor review verbose=true ou bugbot run verbose=true para acessar logs detalhados, verificar quais regras do Bugbot foram carregadas e obter um ID de solicitação
2. Verifique as permissões para confirmar que o Bugbot tem acesso ao repositório
3. Verifique a instalação para confirmar que a integração com seu provedor de repositório está instalada e habilitada

Inclua o ID de solicitação do modo detalhado ao relatar issues.

Perguntas frequentes

Relacionado

• Ajuda do Bugbot