cc-viewer 1.6.182 → 1.6.183

package/concepts/pt-BR/Tool-EnterWorktree.md

@@ -1,56 +1,44 @@
 # EnterWorktree
 
-## Definição
+Cria um worktree Git isolado em uma nova branch, ou coloca a sessão em um worktree existente do repositório atual, para que trabalho paralelo ou experimental possa prosseguir sem tocar no checkout principal.
 
-Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+## Quando usar
 
-## Parâmetros
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | No | A name for the worktree. If not provided, a random name is generated. |
-
-## Casos de uso
+- O usuário diz explicitamente "worktree" — por exemplo "start a worktree", "create a worktree" ou "work in a worktree".
+- Instruções do projeto em `CLAUDE.md` ou memória persistente direcionam você a usar um worktree para a tarefa atual.
+- Você quer continuar uma tarefa que foi previamente configurada como worktree (passe `path` para reentrar nele).
+- Múltiplas branches experimentais precisam coexistir em disco sem constantes trocas de checkout.
+- Uma tarefa de longa duração deve ser isolada de edições não relacionadas na árvore de trabalho principal.
 
-**Adequado para:**
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
-
-**Não adequado para:**
-- The user asks to create/switch branches — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-
-## Observações
-
-- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
-- Must not already be in a worktree
-
-## Texto original
-
-<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+## Parâmetros
 
-## When to Use
+- `name` (string, opcional): Um nome para um novo diretório de worktree. Cada segmento separado por `/` pode conter apenas letras, dígitos, pontos, underscores e hífens; a string completa é limitada a 64 caracteres. Se omitido e `path` também for omitido, um nome aleatório é gerado. Mutuamente exclusivo com `path`.
+- `path` (string, opcional): O caminho do sistema de arquivos de um worktree existente do repositório atual para entrar. Deve aparecer em `git worktree list` para este repo; caminhos que não são worktrees registrados do repo atual são rejeitados. Mutuamente exclusivo com `name`.
 
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+## Exemplos
 
-## When NOT to Use
+### Exemplo 1: Criar um novo worktree com um nome descritivo
 
-- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-- Never use this tool unless the user explicitly mentions "worktree"
+```
+EnterWorktree(name="feat/okta-sso")
+```
 
-## Requirements
+Cria `.claude/worktrees/feat/okta-sso` em uma nova branch baseada em `HEAD`, depois muda o diretório de trabalho da sessão para ele. Todas as edições de arquivo e comandos de shell subsequentes operam dentro desse worktree até você sair.
 
-- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
-- Must not already be in a worktree
+### Exemplo 2: Reentrar em um worktree existente
 
-## Behavior
+```
+EnterWorktree(path="/Users/me/repo/.claude/worktrees/feat/okta-sso")
+```
 
-- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
-- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
-- Switches the session's working directory to the new worktree
-- On session exit, the user will be prompted to keep or remove the worktree
+Retoma o trabalho em um worktree previamente criado. Como você entrou nele via `path`, `ExitWorktree` não o excluirá automaticamente — sair com `action: "keep"` simplesmente retorna ao diretório original.
 
-## Parameters
+## Observações
 
-- `name` (optional): A name for the worktree. If not provided, a random name is generated.
-</textarea>
+- Não chame `EnterWorktree` a menos que o usuário tenha pedido explicitamente ou as instruções do projeto exijam. Trocas de branch ordinárias ou pedidos de correção de bug devem usar comandos Git normais, não worktrees.
+- Quando invocado dentro de um repositório Git, a ferramenta cria um worktree sob `.claude/worktrees/` e registra uma nova branch baseada em `HEAD`. Fora de um repositório Git, ela delega para hooks `WorktreeCreate` / `WorktreeRemove` configurados em `settings.json` para isolamento agnóstico a VCS.
+- Apenas uma sessão de worktree está ativa por vez. A ferramenta se recusa a rodar se você já está dentro de uma sessão de worktree; saia primeiro com `ExitWorktree`.
+- Use `ExitWorktree` para sair durante a sessão. Se a sessão terminar enquanto ainda estiver em um worktree recém-criado, o usuário é questionado se quer mantê-lo ou removê-lo.
+- Worktrees entrados via `path` são considerados externos — `ExitWorktree` com `action: "remove"` não os excluirá. Isso é uma proteção para preservar worktrees que o usuário gerencia manualmente.
+- Um novo worktree herda o conteúdo da branch atual, mas tem um diretório de trabalho e index independentes. Mudanças staged e unstaged no checkout principal não são visíveis dentro do worktree.
+- Dica de nomenclatura: prefixe com o tipo de trabalho (`feat/`, `fix/`, `spike/`) para que múltiplos worktrees concorrentes sejam fáceis de distinguir em `git worktree list`.

package/concepts/pt-BR/Tool-ExitPlanMode.md

@@ -1,62 +1,42 @@
 # ExitPlanMode
 
-## Definição
+Submete o plano de implementação que foi elaborado durante o modo de plano para aprovação do usuário e — se aprovado — transiciona a sessão para fora do modo de plano para que as edições possam começar.
 
-Sai do modo de planejamento e submete o plano para aprovação do usuário. O conteúdo do plano é lido do arquivo de plano previamente escrito.
+## Quando usar
 
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `allowedPrompts` | array | Não | Lista de descrições de permissões necessárias para o plano de implementação |
-
-Cada elemento do array `allowedPrompts`:
-
-| Campo | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `tool` | enum | Sim | Ferramenta aplicável, atualmente suporta apenas `Bash` |
-| `prompt` | string | Sim | Descrição semântica da operação (ex: "run tests", "install dependencies") |
-
-## Cenários de Uso
+- Um plano escrito durante `EnterPlanMode` está completo e pronto para revisão.
+- A tarefa é focada em implementação (mudanças de código ou configuração), não pura pesquisa, então um plano explícito é apropriado.
+- Toda a leitura e análise pré-requisitos foi feita; nenhuma investigação adicional é necessária antes de o usuário decidir.
+- O assistente enumerou caminhos de arquivos, funções e passos concretos — não apenas objetivos.
+- O usuário pediu para ver o plano, ou o workflow de modo de plano está prestes a passar para ferramentas de edição.
 
-**Adequado para:**
-- No modo de planejamento, quando o plano está completo e pronto para submissão à aprovação do usuário
-- Usado apenas para tarefas de implementação que requerem escrita de código
-
-**Não adequado para:**
-- Tarefas puramente de pesquisa/exploração — não é necessário sair do modo de planejamento
-- Querer perguntar ao usuário "o plano está ok?" — esta é exatamente a função desta ferramenta, não use AskUserQuestion para isso
-
-## Observações
+## Parâmetros
 
-- Esta ferramenta não aceita o conteúdo do plano como parâmetro — ela lê do arquivo de plano previamente escrito
-- O usuário verá o conteúdo do arquivo de plano para aprovação
-- Não use AskUserQuestion para perguntar "o plano está ok?" antes de chamar esta ferramenta, isso é redundante
-- Não mencione "plano" nas perguntas, pois o usuário não pode ver o conteúdo do plano antes do ExitPlanMode
+- `allowedPrompts` (array, opcional): Prompts que o usuário pode digitar na tela de aprovação para aprovar automaticamente ou alterar o plano. Cada elemento especifica uma permissão com escopo (por exemplo, um nome de operação e a ferramenta à qual se aplica). Deixe sem definir para usar o fluxo padrão de aprovação.
 
-## Texto original
+## Exemplos
 
-<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+### Exemplo 1: Submissão padrão
 
-## How This Tool Works
-- You should have already written your plan to the plan file specified in the plan mode system message
-- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
-- This tool simply signals that you're done planning and ready for the user to review and approve
-- The user will see the contents of your plan file when they review it
+Depois de investigar uma refatoração de autenticação dentro do modo de plano e gravar o arquivo de plano no disco, o assistente chama `ExitPlanMode` sem argumentos. O harness lê o plano de sua localização canônica, exibe-o ao usuário e aguarda aprovação ou rejeição.
 
-## When to Use This Tool
-IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+### Exemplo 2: Ações rápidas pré-aprovadas
 
-## Before Using This Tool
-Ensure your plan is complete and unambiguous:
-- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
-- Once your plan is finalized, use THIS tool to request approval
+```
+ExitPlanMode(allowedPrompts=[
+  {"tool": "Bash", "prompt": "run tests"},
+  {"tool": "Bash", "prompt": "install dependencies"}
+])
+```
 
-**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+Permite que o usuário conceda permissão antecipadamente para comandos de acompanhamento rotineiros, para que o assistente não precise pausar para cada prompt de permissão durante a implementação.
 
-## Examples
+## Observações
 
-1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
-2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
-3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
-</textarea>
+- `ExitPlanMode` só faz sentido para trabalho em estilo de implementação. Se o pedido do usuário é uma tarefa de pesquisa ou explicação sem mudanças de arquivo, responda diretamente em vez disso — não roteie através do modo de plano apenas para sair dele.
+- O plano já deve estar gravado no disco antes de chamar esta ferramenta. `ExitPlanMode` não aceita o corpo do plano como parâmetro; ele lê do caminho que o harness espera.
+- Se o usuário rejeitar o plano, você retorna ao modo de plano. Revise com base no feedback e submeta novamente; não comece a editar arquivos enquanto o plano não for aprovado.
+- A aprovação concede permissão para sair do modo de plano e usar ferramentas que mutam estado (`Edit`, `Write`, `Bash` e assim por diante) para o escopo descrito no plano. Expandir o escopo depois exige um novo plano ou consentimento explícito do usuário.
+- Não use `AskUserQuestion` para perguntar "este plano parece bom?" antes de chamar esta ferramenta — solicitar aprovação do plano é exatamente o que `ExitPlanMode` faz, e o usuário não pode ver o plano até que ele seja submetido.
+- Mantenha o plano mínimo e acionável. Um revisor deve ser capaz de passar os olhos em menos de um minuto e entender exatamente o que mudará.
+- Se você perceber no meio da implementação que o plano estava errado, pare e reporte ao usuário em vez de desviar silenciosamente. Reentrar no modo de plano é um próximo passo válido.

package/concepts/pt-BR/Tool-ExitWorktree.md

@@ -0,0 +1,41 @@
+# ExitWorktree
+
+Encerra uma sessão de worktree criada anteriormente por `EnterWorktree` e retorna a sessão ao diretório de trabalho original. Esta ferramenta atua exclusivamente sobre worktrees criados por `EnterWorktree` na sessão atual; se nenhuma sessão desse tipo estiver ativa, a chamada não produz efeito.
+
+## Quando usar
+
+- O trabalho em um worktree isolado foi concluído e você deseja retornar ao diretório de trabalho principal.
+- Uma tarefa em um worktree de branch de funcionalidade foi finalizada e, após o merge, você quer limpar o branch e o diretório.
+- Você deseja preservar o worktree para uso posterior e simplesmente retornar ao diretório original sem excluir nada.
+- Você deseja abandonar um branch experimental ou temporário sem deixar artefatos no disco.
+- Você precisa iniciar uma nova sessão de `EnterWorktree`, o que exige primeiro encerrar a atual.
+
+## Parâmetros
+
+- `action` (string, obrigatório): `"keep"` mantém o diretório do worktree e o branch no disco para que você possa retornar a eles mais tarde; `"remove"` exclui tanto o diretório quanto o branch, realizando uma saída limpa.
+- `discard_changes` (booleano, opcional, padrão `false`): Relevante apenas quando `action` é `"remove"`. Se o worktree contiver arquivos não confirmados ou commits ausentes no branch original, a ferramenta recusará a remoção, a menos que `discard_changes` seja definido como `true`. A resposta de erro lista as alterações específicas para que você possa confirmar com o usuário antes de invocar novamente.
+
+## Exemplos
+
+### Exemplo 1: saída limpa após merge das alterações
+
+Após concluir o trabalho em um worktree e fazer o merge do branch no main, chame `ExitWorktree` com `action: "remove"` para excluir o diretório do worktree e o branch e retornar ao diretório de trabalho original.
+
+```
+ExitWorktree(action: "remove")
+```
+
+### Exemplo 2: descartar um worktree temporário com código experimental não confirmado
+
+Se um worktree contiver alterações experimentais não confirmadas que devem ser totalmente descartadas, tente primeiro `action: "remove"`. A ferramenta recusará e listará as alterações não confirmadas. Após confirmar com o usuário que as alterações podem ser descartadas, invoque novamente com `discard_changes: true`.
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## Observações
+
+- Esta ferramenta atua exclusivamente sobre worktrees criados por `EnterWorktree` na sessão atual. Ela não afetará worktrees criados com `git worktree add`, worktrees de sessões anteriores nem o diretório de trabalho comum se `EnterWorktree` nunca tiver sido chamado — nesses casos a chamada não produz efeito.
+- `action: "remove"` é recusado se o worktree tiver alterações não confirmadas ou commits não presentes no branch original, a menos que `discard_changes: true` seja fornecido explicitamente. Confirme sempre com o usuário antes de definir `discard_changes: true`, pois os dados não podem ser recuperados.
+- Se uma sessão tmux estiver vinculada ao worktree: no `remove` ela é encerrada; no `keep` continua em execução e seu nome é retornado para que o usuário possa reconectar-se mais tarde.
+- Após a conclusão de `ExitWorktree`, `EnterWorktree` pode ser chamado novamente para iniciar uma nova sessão de worktree.

package/concepts/pt-BR/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## Definição
+Faz correspondência de nomes de arquivo contra um padrão glob e retorna os caminhos ordenados pelo horário de modificação mais recente primeiro. Otimizado para localizar arquivos rapidamente em codebases de qualquer tamanho sem recorrer ao `find`.
 
-Ferramenta rápida de correspondência de padrões de nomes de arquivo, suporta bases de código de qualquer tamanho. Retorna caminhos de arquivos correspondentes ordenados por data de modificação.
+## Quando usar
 
-## Parâmetros
+- Enumerar todo arquivo de uma extensão específica (por exemplo, todos os arquivos `*.ts` sob `src`)
+- Descobrir arquivos de configuração ou fixtures por convenção de nomenclatura (`**/jest.config.*`, `**/*.test.tsx`)
+- Reduzir a superfície de busca antes de rodar um `Grep` mais focado
+- Verificar se um arquivo já existe em um padrão conhecido antes de chamar `Write`
+- Encontrar arquivos modificados recentemente confiando na ordenação por horário de modificação
 
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `pattern` | string | Sim | Padrão glob (ex: `**/*.js`, `src/**/*.ts`) |
-| `path` | string | Não | Diretório de busca, padrão é o diretório de trabalho atual. Não passe "undefined" ou "null" |
+## Parâmetros
 
-## Cenários de Uso
+- `pattern` (string, obrigatório): A expressão glob a corresponder. Suporta `*` para wildcards de segmento único, `**` para correspondências recursivas e `{a,b}` para alternativas, por exemplo `src/**/*.{ts,tsx}`.
+- `path` (string, opcional): Diretório em que rodar a busca. Deve ser um caminho de diretório válido quando fornecido. Omita o campo completamente para buscar no diretório de trabalho atual. Não passe as strings `"undefined"` ou `"null"`.
 
-**Adequado para:**
-- Buscar arquivos por padrão de nome
-- Encontrar todos os arquivos de um tipo específico (ex: todos os arquivos `.tsx`)
-- Localizar arquivos ao buscar definições de classes específicas (ex: `class Foo`)
-- Pode iniciar múltiplas chamadas Glob em paralelo em uma única mensagem
+## Exemplos
 
-**Não adequado para:**
-- Buscar conteúdo de arquivo — deve usar Grep
-- Exploração aberta que requer múltiplas rodadas de busca — deve usar Task (tipo Explore)
+### Exemplo 1: Todo arquivo fonte TypeScript
+Chame `Glob` com `pattern: "src/**/*.ts"`. O resultado é uma lista ordenada por mtime, então os arquivos editados mais recentemente aparecem primeiro, o que é útil para focar em pontos quentes.
 
-## Observações
+### Exemplo 2: Localizar um candidato a definição de classe
+Quando você suspeita que uma classe vive em um arquivo cujo nome você não sabe, busque com `pattern: "**/*UserService*"` para restringir os candidatos, depois siga com `Read` ou `Grep`.
 
-- Suporta sintaxe glob padrão: `*` corresponde a um nível, `**` corresponde a múltiplos níveis, `{}` corresponde a múltiplas opções
-- Resultados ordenados por data de modificação
-- Mais recomendado que o comando `find` do Bash
+### Exemplo 3: Descoberta paralela antes de uma tarefa maior
+Em uma única mensagem, dispare múltiplas chamadas `Glob` (por exemplo, uma para `**/*.test.ts` e uma para `**/fixtures/**`) para que ambas rodem em paralelo e seus resultados possam ser correlacionados.
 
-## Texto original
+## Observações
 
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>
+- Os resultados são ordenados por horário de modificação do arquivo (mais novo primeiro), não alfabeticamente. Ordene a jusante se precisar de ordenação estável.
+- Os padrões são avaliados pela ferramenta, não pelo shell; você não precisa colocá-los entre aspas ou escapá-los como faria na linha de comando.
+- Para exploração aberta que exige várias rodadas de busca e raciocínio, delegue para um `Agent` com o tipo de agente Explore em vez de encadear muitas chamadas `Glob`.
+- Prefira `Glob` em vez de invocações `Bash` de `find` ou `ls` para descoberta de nomes de arquivo; ele lida com permissões de forma consistente e retorna saída estruturada.
+- Quando procurar conteúdo dentro de arquivos em vez de nomes de arquivo, use `Grep`.

package/concepts/pt-BR/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Definição
+Busca conteúdo de arquivos usando o motor ripgrep. Oferece suporte completo a expressões regulares, filtragem por tipo de arquivo e três modos de saída para que você possa equilibrar precisão com concisão.
 
-Ferramenta poderosa de busca de conteúdo baseada em ripgrep. Suporta expressões regulares, filtragem por tipo de arquivo e múltiplos modos de saída.
+## Quando usar
+
+- Localizar todos os pontos de chamada de uma função ou toda referência a um identificador
+- Verificar se uma string ou mensagem de erro aparece em algum lugar no codebase
+- Contar ocorrências de um padrão para avaliar o impacto antes de refatorar
+- Restringir uma busca a um tipo de arquivo (`type: "ts"`) ou glob (`glob: "**/*.tsx"`)
+- Extrair correspondências entre linhas, como definições de struct multilinha ou blocos JSX com `multiline: true`
 
 ## Parâmetros
 
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `pattern` | string | Sim | Padrão de busca com expressão regular |
-| `path` | string | Não | Caminho de busca (arquivo ou diretório), padrão é o diretório de trabalho atual |
-| `glob` | string | Não | Filtro de nome de arquivo (ex: `*.js`, `*.{ts,tsx}`) |
-| `type` | string | Não | Filtro de tipo de arquivo (ex: `js`, `py`, `rust`), mais eficiente que glob |
-| `output_mode` | enum | Não | Modo de saída: `files_with_matches` (padrão), `content`, `count` |
-| `-i` | boolean | Não | Busca sem distinção de maiúsculas/minúsculas |
-| `-n` | boolean | Não | Exibir números de linha (apenas modo content), padrão true |
-| `-A` | number | Não | Número de linhas a exibir após a correspondência |
-| `-B` | number | Não | Número de linhas a exibir antes da correspondência |
-| `-C` / `context` | number | Não | Número de linhas a exibir antes e depois da correspondência |
-| `head_limit` | number | Não | Limitar número de entradas na saída, padrão 0 (ilimitado) |
-| `offset` | number | Não | Pular os primeiros N resultados |
-| `multiline` | boolean | Não | Ativar modo de correspondência multilinha, padrão false |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Buscar strings ou padrões específicos na base de código
-- Encontrar locais de uso de funções/variáveis
-- Filtrar resultados de busca por tipo de arquivo
-- Contar número de correspondências
-
-**Não adequado para:**
-- Buscar arquivos por nome — deve usar Glob
-- Exploração aberta que requer múltiplas rodadas de busca — deve usar Task (tipo Explore)
+- `pattern` (string, obrigatório): A expressão regular a buscar. Usa sintaxe do ripgrep, portanto chaves literais precisam de escape (por exemplo `interface\{\}` para encontrar `interface{}`).
+- `path` (string, opcional): Arquivo ou diretório a buscar. O padrão é o diretório de trabalho atual.
+- `glob` (string, opcional): Filtro de nome de arquivo como `*.js` ou `*.{ts,tsx}`.
+- `type` (string, opcional): Atalho por tipo de arquivo como `js`, `py`, `rust`, `go`. Mais eficiente que `glob` para linguagens padrão.
+- `output_mode` (enum, opcional): `files_with_matches` (padrão, retorna apenas caminhos), `content` (retorna linhas que correspondem) ou `count` (retorna contagens de correspondências).
+- `-i` (boolean, opcional): Correspondência sem diferenciação de maiúsculas e minúsculas.
+- `-n` (boolean, opcional): Inclui números de linha no modo `content`. O padrão é `true`.
+- `-A` (number, opcional): Linhas de contexto a mostrar após cada correspondência (requer modo `content`).
+- `-B` (number, opcional): Linhas de contexto antes de cada correspondência (requer modo `content`).
+- `-C` / `context` (number, opcional): Linhas de contexto em ambos os lados de cada correspondência.
+- `multiline` (boolean, opcional): Permite que padrões atravessem newlines (`.` corresponde a `\n`). O padrão é `false`.
+- `head_limit` (number, opcional): Limita linhas, caminhos de arquivo ou entradas de contagem retornadas. O padrão é 250; passe `0` para ilimitado (use com moderação).
+- `offset` (number, opcional): Pula os primeiros N resultados antes de aplicar `head_limit`. O padrão é `0`.
+
+## Exemplos
+
+### Exemplo 1: Encontrar todos os pontos de chamada de uma função
+Defina `pattern: "registerHandler\\("`, `output_mode: "content"` e `-C: 2` para ver as linhas ao redor de cada chamada.
+
+### Exemplo 2: Contar correspondências em um tipo
+Defina `pattern: "TODO"`, `type: "py"` e `output_mode: "count"` para ver totais de TODO por arquivo em fontes Python.
+
+### Exemplo 3: Correspondência multilinha em struct
+Use `pattern: "struct Config \\{[\\s\\S]*?version"` com `multiline: true` para capturar um campo declarado várias linhas dentro de uma struct Go.
 
 ## Observações
 
-- Usa sintaxe ripgrep (não grep), caracteres especiais como chaves precisam ser escapados
-- O modo `files_with_matches` retorna apenas caminhos de arquivo, é o mais eficiente
-- O modo `content` retorna o conteúdo das linhas correspondentes, suporta linhas de contexto
-- Correspondência multilinha requer `multiline: true`
-- Sempre prefira usar a ferramenta Grep em vez dos comandos `grep` ou `rg` no Bash
-
-## Texto original
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- Sempre prefira `Grep` a rodar `grep` ou `rg` via `Bash`; a ferramenta é otimizada para permissões corretas e saída estruturada.
+- O modo de saída padrão é `files_with_matches`, que é o mais barato. Mude para `content` apenas quando precisar ver as próprias linhas.
+- Flags de contexto (`-A`, `-B`, `-C`) são ignoradas a menos que `output_mode` seja `content`.
+- Conjuntos grandes de resultados queimam tokens de contexto. Use `head_limit`, `offset` ou filtros `glob`/`type` mais apertados para manter o foco.
+- Para descoberta de nomes de arquivo, use `Glob`; para investigações abertas em várias rodadas, dispare um `Agent` com o agente Explore.

package/concepts/pt-BR/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Inicia um monitor em segundo plano que transmite eventos de um script de longa duração. Cada linha da saída padrão torna-se uma notificação — continue trabalhando enquanto os eventos chegam no chat.
+
+## Quando usar
+
+- Acompanhar erros, avisos ou assinaturas de falha em um arquivo de log enquanto um deploy está em execução
+- Consultar uma API remota, um PR ou um pipeline de CI a cada 30 segundos para detectar novos eventos de status
+- Observar mudanças em um diretório do sistema de arquivos ou na saída de compilação em tempo real
+- Aguardar uma condição específica ao longo de muitas iterações (por exemplo, um marco de etapa de treinamento ou o esvaziamento de uma fila)
+- **Não** para um simples "aguardar até concluir" — use `Bash` com `run_in_background` para isso; ele emite uma notificação de conclusão quando o processo termina
+
+## Parâmetros
+
+- `command` (string, obrigatório): O comando de shell ou script a ser executado. Cada linha gravada na saída padrão torna-se um evento de notificação separado. O monitor termina quando o processo encerra.
+- `description` (string, obrigatório): Um rótulo curto e legível exibido em cada notificação. Seja específico — "erros em deploy.log" é melhor que "observando logs". Este rótulo identifica qual monitor foi acionado.
+- `timeout_ms` (número, padrão `300000`, máx `3600000`): Prazo de encerramento forçado em milissegundos. Após essa duração o processo é encerrado. Ignorado quando `persistent: true`.
+- `persistent` (booleano, padrão `false`): Quando `true`, o monitor é executado durante toda a sessão sem limite de tempo. Pare-o explicitamente com `TaskStop`.
+
+## Exemplos
+
+### Exemplo 1: Acompanhar um arquivo de log em busca de erros e falhas
+
+Este exemplo cobre todos os estados terminais: marcador de sucesso, traceback, palavras-chave de erro comuns, encerramento por OOM e saída inesperada do processo.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+Use `grep --line-buffered` em cada pipe. Sem ele, o sistema operacional armazena a saída em blocos de 4 KB e os eventos podem ser atrasados por minutos. O padrão de alternância cobre tanto o caminho de sucesso (`deployed`) quanto os caminhos de falha (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`). Um monitor que observa apenas o marcador de sucesso permanece silencioso durante uma falha — o silêncio é idêntico a "ainda em execução".
+
+### Exemplo 2: Consultar uma API remota a cada 30 segundos
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` impede que uma falha de rede transitória encerre o loop. Intervalos de consulta de 30 segundos ou mais são apropriados para APIs remotas para evitar limites de taxa. Ajuste o padrão grep para capturar tanto respostas de sucesso quanto de erro, de modo que erros do lado da API não sejam mascarados pelo silêncio.
+
+## Observações
+
+- **Sempre use `grep --line-buffered` em pipes.** Sem ele, o buffer do pipe atrasa os eventos por minutos porque o sistema operacional acumula a saída até encher um bloco de 4 KB. `--line-buffered` força um flush após cada linha.
+- **O filtro deve cobrir tanto as assinaturas de sucesso quanto as de falha.** Um monitor que observa apenas o marcador de sucesso permanece silencioso em caso de falha, travamento ou saída inesperada. Amplie a alternância: inclua `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` e marcadores similares de estado terminal ao lado da palavra-chave de sucesso.
+- **Intervalos de consulta: 30 segundos ou mais para APIs remotas.** Consultas frequentes a serviços externos arriscam erros de limite de taxa ou bloqueios. Para verificações locais de sistema de arquivos ou processos, 0,5–1 segundo é apropriado.
+- **Use `persistent: true` para monitores durante toda a sessão.** O `timeout_ms` padrão de 300.000 ms (5 minutos) encerra o processo. Para monitores que devem ser executados até serem parados explicitamente, defina `persistent: true` e chame `TaskStop` quando concluído.
+- **Parada automática em caso de flood de eventos.** Cada linha da saída padrão é uma mensagem de conversa. Se o filtro for muito amplo e produzir eventos demais, o monitor é parado automaticamente. Reinicie com um padrão `grep` mais restrito. Linhas que chegam dentro de 200 ms são agrupadas em uma única notificação.

package/concepts/pt-BR/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Definição
+Modifica uma única célula em um notebook Jupyter (`.ipynb`). Suporta substituir a fonte de uma célula, inserir uma nova célula ou excluir uma célula existente preservando o restante da estrutura do notebook.
 
-Substitui, insere ou exclui células específicas em um Jupyter notebook (arquivo .ipynb).
+## Quando usar
+
+- Corrigir ou atualizar uma célula de código em um notebook de análise sem reescrever o arquivo inteiro
+- Trocar uma célula markdown para melhorar a narrativa ou adicionar documentação
+- Inserir uma nova célula de código ou markdown em uma posição conhecida em um notebook existente
+- Remover uma célula obsoleta ou quebrada para que células a jusante não dependam mais dela
+- Preparar um notebook reproduzível iterando em uma célula de cada vez
 
 ## Parâmetros
 
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `notebook_path` | string | Sim | Caminho absoluto do arquivo notebook |
-| `new_source` | string | Sim | Novo conteúdo da célula |
-| `cell_id` | string | Não | ID da célula a editar. No modo de inserção, a nova célula é inserida após este ID |
-| `cell_type` | enum | Não | Tipo de célula: `code` ou `markdown`. Obrigatório no modo de inserção |
-| `edit_mode` | enum | Não | Modo de edição: `replace` (padrão), `insert`, `delete` |
+- `notebook_path` (string, obrigatório): Caminho absoluto para o arquivo `.ipynb`. Caminhos relativos são rejeitados.
+- `new_source` (string, obrigatório): A nova fonte da célula. Para `replace` e `insert` torna-se o corpo da célula; para `delete` é ignorado, mas ainda exigido pelo schema.
+- `cell_id` (string, opcional): ID da célula alvo. Nos modos `replace` e `delete`, a ferramenta age sobre essa célula. No modo `insert`, a nova célula é inserida imediatamente após a célula com este ID; omita para inserir no topo do notebook.
+- `cell_type` (enum, opcional): Ou `code` ou `markdown`. Obrigatório quando `edit_mode` é `insert`. Quando omitido durante `replace`, o tipo da célula existente é preservado.
+- `edit_mode` (enum, opcional): `replace` (padrão), `insert` ou `delete`.
 
-## Cenários de Uso
+## Exemplos
 
-**Adequado para:**
-- Modificar células de código ou markdown em Jupyter notebooks
-- Adicionar novas células ao notebook
-- Excluir células do notebook
+### Exemplo 1: Substituir uma célula de código com bug
+Chame `NotebookEdit` com `notebook_path` definido como o caminho absoluto, `cell_id` definido como o ID da célula alvo e `new_source` contendo o código Python corrigido. Deixe `edit_mode` no padrão `replace`.
 
-## Observações
+### Exemplo 2: Inserir uma explicação em markdown
+Para adicionar uma célula markdown logo após uma célula `setup` existente, defina `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` como o ID da célula setup e coloque a narrativa em `new_source`.
 
-- `cell_number` é indexado a partir de 0
-- O modo `insert` insere uma nova célula na posição especificada
-- O modo `delete` exclui a célula na posição especificada
-- O caminho deve ser absoluto
+### Exemplo 3: Excluir uma célula obsoleta
+Defina `edit_mode: "delete"` e forneça o `cell_id` da célula a remover. Forneça qualquer string para `new_source`; ela não é aplicada.
 
-## Texto original
+## Observações
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Sempre passe um caminho absoluto. `NotebookEdit` não resolve caminhos relativos contra o diretório de trabalho.
+- A ferramenta reescreve apenas a célula alvo; contagens de execução, outputs e metadados de células não relacionadas permanecem intocados.
+- Inserir sem um `cell_id` coloca a nova célula no início do notebook.
+- `cell_type` é obrigatório para inserts. Para replaces, omita a menos que você queira explicitamente converter uma célula de código em markdown ou vice-versa.
+- Para inspecionar células e pegar seus IDs, use a ferramenta `Read` no notebook primeiro; ela retorna as células com seu conteúdo e outputs.
+- Use o `Edit` regular para arquivos fonte comuns; `NotebookEdit` é específico para JSON de `.ipynb` e entende sua estrutura de células.

package/concepts/pt-BR/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Envia uma notificação na área de trabalho a partir da sessão atual do Claude Code. Se o Remote Control estiver conectado, a notificação também é enviada ao telefone do usuário, trazendo sua atenção de volta à sessão — independentemente do que estiver fazendo.
+
+## Quando usar
+
+- Uma tarefa de longa duração foi concluída enquanto o usuário provavelmente estava longe do terminal
+- Uma compilação, execução de testes ou implantação foi concluída e o resultado está pronto para revisão
+- Foi atingido um ponto de decisão que requer a participação do usuário antes de continuar
+- Surgiu um erro ou bloqueio que não pode ser resolvido de forma autônoma
+- O usuário solicitou explicitamente ser notificado quando uma tarefa ou condição específica for atendida
+
+## Quando não usar
+
+Não envie uma notificação para atualizações de progresso rotineiras durante uma tarefa, nem para confirmar que respondeu algo que o usuário claramente acabou de perguntar e está aguardando. Não notifique quando uma tarefa curta é concluída — se o usuário acabou de enviá-la e está esperando, a notificação não agrega valor e corrói a confiança nas notificações futuras. Incline-se fortemente para não enviar.
+
+## Parâmetros
+
+- `message` (string, obrigatório): o corpo da notificação. Mantenha abaixo de 200 caracteres; sistemas operacionais móveis truncam strings mais longas. Comece com o que o usuário agiria: "build failed: 2 auth tests" é mais útil do que "task complete".
+- `status` (string, obrigatório): sempre definido como `"proactive"`. Este é um marcador fixo e não muda.
+
+## Exemplos
+
+### Exemplo 1: notificar ao concluir uma análise longa
+
+Uma auditoria de dependências em todo o repositório foi solicitada e levou vários minutos. O usuário se afastou. Quando o relatório estiver pronto:
+
+```
+message: "Auditoria de dependências concluída: 3 CVEs críticos em lodash, axios, jsonwebtoken. Relatório: audit-report.txt"
+status: "proactive"
+```
+
+### Exemplo 2: sinalizar um ponto de decisão durante trabalho autônomo
+
+Durante uma refatoração de várias etapas, descobre-se que dois módulos têm interfaces conflitantes e não podem ser mesclados sem uma decisão de design:
+
+```
+message: "Refatoração pausada: AuthService e UserService têm interfaces de token conflitantes. Sua decisão é necessária para continuar."
+status: "proactive"
+```
+
+## Observações
+
+- Incline-se fortemente para **não** enviar. A notificação interrompe o usuário independentemente do que ele estiver fazendo. Trate-a como um custo que precisa ser justificado pelo valor da informação.
+- Comece com conteúdo acionável. As primeiras palavras devem dizer ao usuário o que aconteceu e o que, se houver algo, ele precisa fazer — não uma etiqueta de status genérica.
+- Mantenha `message` abaixo de 200 caracteres. Sistemas operacionais móveis truncarão strings mais longas, cortando a parte mais importante se ela aparecer no final.
+- Se o resultado indicar que o push não foi enviado porque o Remote Control não está conectado, esse é o comportamento esperado. Nenhuma nova tentativa ou ação adicional é necessária; a notificação local da área de trabalho ainda é disparada.
+- Evite spam de notificações. Se notificações forem enviadas com frequência para eventos menores, o usuário começará a ignorá-las. Reserve essa ferramenta para momentos em que haja chance real de o usuário ter se afastado e queira saber o resultado agora.