> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Referência completa de todas as tools disponíveis

# Referência de Tools

Todas as tools que o Claude pode usar durante a conversa. O usuário não invoca diretamente — a IA decide quando usar baseado no contexto.

## Código e terminal

<AccordionGroup>
  <Accordion title="exec" icon="terminal">
    Executa um comando no terminal.

    **Parâmetros:**

    * `command` — comando a executar
    * `environment` — `sandbox` (cloud) ou nome do daemon (local)

    Se nenhum ambiente é especificado, usa o daemon padrão do usuário. Se não tem daemon conectado, usa sandbox automaticamente.
  </Accordion>

  <Accordion title="read" icon="eye">
    Lê o conteúdo de um arquivo.

    **Parâmetros:**

    * `file_path` — caminho do arquivo
  </Accordion>

  <Accordion title="write" icon="pen">
    Escreve/cria um arquivo.

    **Parâmetros:**

    * `file_path` — caminho do arquivo
    * `content` — conteúdo a escrever
  </Accordion>

  <Accordion title="edit" icon="pencil">
    Edita um arquivo existente.

    **Parâmetros:**

    * `file_path` — caminho do arquivo
    * `old_string` — texto a substituir
    * `new_string` — texto novo
  </Accordion>

  <Accordion title="glob" icon="folder-tree">
    Busca arquivos por padrão.

    **Parâmetros:**

    * `pattern` — glob pattern (ex: `*.ts`, `src/**/*.tsx`)
    * `path` — diretório base
  </Accordion>

  <Accordion title="grep" icon="magnifying-glass">
    Busca texto dentro de arquivos.

    **Parâmetros:**

    * `pattern` — regex ou texto
    * `path` — diretório base
    * `include` — filtro de arquivos
  </Accordion>
</AccordionGroup>

## Conta

<AccordionGroup>
  <Accordion title="account_info" icon="user">
    Mostra informações da conta: email, número de sessões, se tem tokens próprios do Claude.
  </Accordion>

  <Accordion title="send_token" icon="key">
    Envia o token de recuperação da conta (`b0_tok_*`) para o chat.
  </Accordion>

  <Accordion title="link_account" icon="link">
    Vincula o chat Telegram a uma conta existente usando o token de recuperação.
  </Accordion>

  <Accordion title="setup_oauth" icon="plug">
    Gera um link para conectar sua própria conta Claude via OAuth.
  </Accordion>

  <Accordion title="new_session" icon="rotate">
    Cria uma nova sessão limpa, descartando o histórico atual.
  </Accordion>

  <Accordion title="daemon_status" icon="wifi">
    Mostra quais daemons (ambientes locais) estão conectados via WebSocket.
  </Accordion>
</AccordionGroup>

## Configurações

<AccordionGroup>
  <Accordion title="get_settings" icon="gear">
    Mostra as configurações atuais do usuário.
  </Accordion>

  <Accordion title="set_settings" icon="sliders">
    Altera configurações: `tool_verbosity`, `reactions_enabled`, `model`, `small_model`, `daemon.default`.
  </Accordion>
</AccordionGroup>

## Meta Ads

<AccordionGroup>
  <Accordion title="meta_ads_connect" icon="plug">
    Conecta uma conta Meta Ads. Recebe o access token, valida, troca por long-lived (60 dias), e salva.
  </Accordion>

  <Accordion title="meta_ads_disconnect" icon="plug-circle-xmark">
    Desconecta a conta Meta Ads e remove as credenciais.
  </Accordion>

  <Accordion title="meta_ads_accounts" icon="building">
    Lista todas as contas de anúncio vinculadas.
  </Accordion>

  <Accordion title="meta_ads_campaigns" icon="bullhorn">
    Lista campanhas com filtro por status (ativa, pausada, arquivada).
  </Accordion>

  <Accordion title="meta_ads_adsets" icon="layer-group">
    Lista conjuntos de anúncio com targeting e budget.
  </Accordion>

  <Accordion title="meta_ads_ads" icon="ad">
    Lista anúncios individuais com status e creative.
  </Accordion>

  <Accordion title="meta_ads_insights" icon="chart-line">
    Métricas de performance: gasto, impressões, cliques, CPC, CTR, alcance, conversões.

    **Parâmetros:**

    * `account_id` — conta de anúncio
    * `date_preset` — período (today, yesterday, last\_7d, last\_30d, this\_month, last\_month)
    * `time_range` — range customizado (since/until)
    * `breakdown` — age, gender, country, device, platform
    * `level` — account, campaign, adset, ad
    * `campaign_id` / `adset_id` / `ad_id` — filtro específico
  </Accordion>
</AccordionGroup>

## Ambientes

<AccordionGroup>
  <Accordion title="environments" icon="server">
    Gerencia ambientes sandbox persistentes por usuário.

    **Parâmetros:**

    * `action` — `list`, `create`, `archive` ou `info`
    * `name` — nome do ambiente (para create/archive/info)

    Cada usuário pode ter até 3 ambientes ativos. O ambiente `default` não pode ser arquivado.
  </Accordion>
</AccordionGroup>

## Admin

<Warning>
  Disponíveis apenas para usuários com role `admin`.
</Warning>

<AccordionGroup>
  <Accordion title="list_pending" icon="clock">
    Lista usuários aguardando aprovação.
  </Accordion>

  <Accordion title="approve_user" icon="check">
    Aprova um usuário por email ou Telegram chat ID.
  </Accordion>

  <Accordion title="pre_register" icon="user-plus">
    Pre-cadastra um email. Quando o usuário fizer signup com esse email, é aprovado automaticamente.
  </Accordion>

  <Accordion title="block_user" icon="ban">
    Bloqueia um usuário, impedindo acesso ao bot.
  </Accordion>
</AccordionGroup>