Repolode
Enviar
thomasschafer

thomasschafer/scooter

Uma interface de terminal para localizar e substituir texto de forma interativa em arquivos ou na entrada padrão, com busca por regex ou texto literal e revisão de cada ocorrência.

Ver no GitHub
Estrelas
1,302
Forks
19
Issues abertas
12
Último commit
há 4 dias

O que é?

scooter é uma ferramenta de localizar e substituir que roda no terminal. Por padrão, ela busca recursivamente nos arquivos do diretório atual e também pode processar texto enviado pela entrada padrão (stdin). Você informa o texto a buscar e o texto de substituição e, antes de aplicar as alterações, escolhe quais ocorrências substituir.

As buscas podem usar texto literal ou uma expressão regular, com grupos de captura opcionais na substituição, como $1 e $2. Entre as opções estão a correspondência de palavras inteiras e a diferenciação entre maiúsculas e minúsculas, o modo multilinha, filtros de inclusão e exclusão de arquivos com glob e o respeito aos arquivos .gitignore e .ignore. Ocorrências que mudaram desde o início da busca são ignoradas e informadas ao final, para evitar sobrescrever resultados desatualizados.

O percurso dos arquivos é feito pelo ripgrep. A ferramenta também oferece temas para realce de sintaxe, integração com o editor para abrir os resultados no $EDITOR na linha correspondente e um modo sem TUI para scripts.

Recursos principais

  • 01Revisão interativa: escolha quais ocorrências substituir antes de aplicar as alterações.
  • 02Busca por texto literal ou regex, com grupos de captura nas substituições.
  • 03Filtra arquivos com padrões glob de inclusão e exclusão.
  • 04Respeita os arquivos .gitignore e .ignore e, por padrão, ignora arquivos ocultos.
  • 05Processa dados enviados pela entrada padrão e exibe os resultados sem a TUI.

Casos de uso

  • Renomear um identificador em toda a base de código, revisando cada alteração.
  • Fazer edições de texto em massa no diretório de um projeto pelo terminal.
  • Transformar texto enviado por pipe em scripts de shell com o modo --no-tui.

Início rápido

  1. 1

    Instale scooter com o Homebrew (macOS e Linux)

    brew install scooter
  2. 2

    Inicie o scooter em um terminal a partir do diretório que deseja pesquisar

    scooter

Antes de usar

  • Por padrão, o mecanismo de expressões regulares oferece suporte apenas a um subconjunto de recursos. Por isso, padrões avançados, como lookahead, precisam da flag -a.
  • As substituições são ignoradas se uma linha correspondente for alterada após a pesquisa. Esses casos ignorados são listados somente no final.

Em coleções

Ferramentas de CLI e terminal

Tópicos

#terminal#tui#find-and-replace#regex#rust#command-line

Perguntas frequentes

O que é scooter?
Uma interface de terminal para localizar e substituir texto de forma interativa em arquivos ou na entrada padrão, com busca por regex ou texto literal e revisão de cada ocorrência. scooter é uma ferramenta de localizar e substituir que roda no terminal. Por padrão, ela busca recursivamente nos arquivos do diretório atual e também pode processar texto enviado pela entrada padrão (stdin). Você informa o texto a buscar e o texto de substituição e, antes de aplicar as alterações, escolhe quais ocorrências substituir.
scooter é gratuito? Qual é a licença?
scooter é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
scooter ainda é mantido?
Manutenção ativa. O último commit de scooter foi em 18 de out. de 2026.
Para que posso usar scooter?
Renomear um identificador em toda a base de código, revisando cada alteração. Fazer edições de texto em massa no diretório de um projeto pelo terminal. Transformar texto enviado por pipe em scripts de shell com o modo --no-tui.
Como instalar scooter?
Instale scooter com o Homebrew (macOS e Linux): brew install scooter Inicie o scooter em um terminal a partir do diretório que deseja pesquisar: scooter
Onde consigo scooter?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/thomasschafer/scooter

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados