Ferramentas

O Verboo Code expõe ferramentas especializadas para o agente executar tarefas. Cada ferramenta tem um schema de entrada validado, e algumas geram saídas progressivas (streaming). O agente decide qual ferramenta usar com base no contexto.

Shell e sistema operacional

Bash

Executa comandos shell. Suporta timeouts, modo background, streaming de progresso e detecção de sandbox.

Parâmetros:

Auto-background: Comandos que demoram mais de 2 segundos são colocados em background automaticamente. Comandos comuns de longa duração (npm install, cargo build, etc.) vão direto para background.

Parsing de sed: O Bash Tool detecta e valida edições sed -i para evitar danos acidentais a arquivos.

PowerShell

Mesma interface do Bash, mas executa via PowerShell no Windows.

Leitura e escrita de arquivos

Read

Lê arquivos do filesystem. Suporta offset e limit (número de linhas), leitura de imagens (PNG, JPG), PDFs (com seleção de páginas) e Jupyter notebooks.

Write

Cria ou sobrescreve arquivos.

Edit

Faz substituições exatas de strings em arquivos. Requer que a string a substituir seja única no arquivo.

Glob

Busca arquivos por padrão glob.

Grep

Busca texto em arquivos usando ripgrep (muito mais rápido que find + grep).

Web

WebFetch

Faz requisições HTTP e retorna o conteúdo como texto ou Markdown. Usa Firecrawl quando disponível para melhor extração de conteúdo de sites complexos.

WebSearch

Faz busca na web. Usa DuckDuckGo por padrão (gratuito). Configure FIRECRAWL_API_KEY para resultados melhores via Firecrawl.

Linguagem (LSP)

LSP

Integração com Language Server Protocol. Fornece diagnósticos (erros, warnings), definições de símbolos e referências sem executar o compilador.

Agentes

Agent

Spawna sub-agentes especializados. Cada agente tem acesso ao conjunto completo de ferramentas e pode trabalhar em paralelo com outros.

Isolamento via worktree: Quando isolation: "worktree", o agente recebe uma cópia isolada do repositório. O worktree é limpo automaticamente se o agente não fizer mudanças.

SendMessage

Envia uma mensagem a um sub-agente em execução (continua com contexto completo).

Tarefas

O sistema de tarefas permite rastrear e gerenciar trabalho estruturado.

TaskCreate

Cria uma nova tarefa com título, descrição e status.

TaskGet

Obtém detalhes de uma tarefa específica pelo ID.

TaskList

Lista todas as tarefas ativas, filtradas por status.

TaskUpdate

Atualiza o status, título ou descrição de uma tarefa existente.

Status disponíveis: pending, in_progress, completed, cancelled

TaskStop

Cancela uma tarefa em execução.

TaskOutput

Obtém o output atual de uma tarefa em background.

Planejamento

EnterPlanMode

Entra no modo de planejamento (read-only). Neste modo, o agente não pode executar ferramentas destrutivas — apenas ler arquivos, explorar o codebase e escrever no arquivo de plano. Ideal para planejar antes de implementar.

ExitPlanMode

Sai do modo de planejamento e retorna ao modo normal de execução.

Worktrees Git

EnterWorktree

Cria e entra em um git worktree temporário para trabalho isolado. Útil para tasks que precisam de isolamento completo do repositório principal.

ExitWorktree

Sai do worktree atual e limpa o diretório temporário.

Agendamento e remoto

ScheduleCron (CronCreate / CronDelete / CronList)

Gerencia tarefas cron para execução periódica.

CronCreate:

Cria um cron job com expressão, prompt e modelo especificados

CronDelete:

Remove um cron job pelo ID

CronList:

Lista todos os cron jobs ativos

RemoteTrigger

Dispara um agente remoto na infraestrutura da Verboo.

MCP

MCPTool

Executa ferramentas expostas por servidores MCP conectados. O schema de entrada é dinâmico (passthrough) e validado em runtime via AJV. Suporta saídas de texto, imagens e outros tipos de conteúdo.

O campo isMcp: true diferencia tools MCP de tools nativas no contexto de permissões e logging.

Interação com o usuário

AskUserQuestion

Faz uma pergunta ao usuário com opções pré-definidas. Essencial em plan mode para clarificar requisitos.

SkillTool

Invoca uma skill registrada pelo nome. Permite que o agente chame skills automaticamente com base no contexto.

Monitoramento

Monitor

Monitora um processo em background, recebendo cada linha de stdout como uma notificação. Ideal para acompanhar builds, testes ou servidores que estão rodando.

Limites e permissões

As permissões de cada ferramenta são configuradas em settings.json:

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "WebFetch(domain:github.com)",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

O usuário é consultado para qualquer ferramenta não coberta pelas regras de allow/deny.