Repolode
ajeetdsouza

ajeetdsouza/zoxide

Um comando cd mais inteligente, que aprende quais diretórios você mais usa e permite acessá-los com poucas teclas em todos os principais shells.

Estrelas
40,192
Forks
929
Issues abertas
160
Último commit
anteontem

O que é?

zoxide é uma alternativa ao comando cd que acompanha os diretórios que você visita e os classifica de acordo com a frequência e a data de uso. Digite z seguido de parte do nome, como z foo, para acessar o diretório correspondente mais bem classificado, sem precisar digitar caminhos completos na maioria das vezes.

Funciona com Bash, Zsh, Fish, PowerShell, Nushell, Elvish, Xonsh, Tcsh e qualquer shell POSIX. É possível instalar pelo crates.io, Homebrew, winget, Scoop, conda e pelos repositórios de várias distribuições Linux. Se o fzf estiver instalado, o comando zi abre um seletor interativo. Também é possível importar o histórico de z, autojump, fasd, atuin e ferramentas semelhantes.

O comportamento da busca e o envelhecimento do banco de dados podem ser configurados por variáveis de ambiente, incluindo padrões glob para exclusões, localização do banco de dados e número máximo de entradas. O projeto é escrito em Rust e distribuído sob a licença MIT.

Recursos principais

  • 01Classifica os diretórios por frequência e uso recente, para que os atalhos reflitam o que você realmente usa.
  • 02Funciona com Bash, Zsh, Fish, PowerShell, Nushell, Elvish, Xonsh e outros shells.
  • 03Seleção interativa com fzf usando o comando zi.
  • 04Importa o histórico de z, autojump, fasd, atuin e outras ferramentas.
  • 05Permite configurar exclusões, localização do banco de dados e limites de envelhecimento por variáveis de ambiente.

Casos de uso

  • Acessar pastas de projetos usadas com frequência no terminal sem digitar caminhos completos.
  • Migrar de z, autojump ou fasd mantendo o histórico de diretórios existente.
  • Usar o mesmo comando para navegar entre diretórios em shells do Windows PowerShell, Linux e macOS.

Início rápido

  1. 1

    Instale o binário com o script de instalação

    Instale seguindo as instruções oficiais do README
  2. 2

    Ou instale pelo crates.io com o Cargo

    cargo install zoxide --locked
  3. 3

    Adicione zoxide ao final do arquivo de configuração do Bash (geralmente ~/.bashrc)

    eval "$(zoxide init bash)"
  4. 4

    Reinicie o shell e use z para acessar um diretório

    z foo

Antes de usar

  • A configuração do shell exige a edição manual do arquivo de configuração.
  • A conclusão com Tab e a seleção interativa (zi) exigem a instalação separada do fzf.

Tópicos

Perguntas frequentes

O que é zoxide?
Um comando cd mais inteligente, que aprende quais diretórios você mais usa e permite acessá-los com poucas teclas em todos os principais shells. zoxide é uma alternativa ao comando cd que acompanha os diretórios que você visita e os classifica de acordo com a frequência e a data de uso. Digite z seguido de parte do nome, como z foo, para acessar o diretório correspondente mais bem classificado, sem precisar digitar caminhos completos na maioria das vezes.
zoxide é gratuito? Qual é a licença?
zoxide é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
zoxide ainda é mantido?
Manutenção ativa. O último commit de zoxide foi em 18 de out. de 2026.
Para que posso usar zoxide?
Acessar pastas de projetos usadas com frequência no terminal sem digitar caminhos completos. Migrar de z, autojump ou fasd mantendo o histórico de diretórios existente. Usar o mesmo comando para navegar entre diretórios em shells do Windows PowerShell, Linux e macOS.
Como instalar zoxide?
Instale o binário com o script de instalação Ou instale pelo crates.io com o Cargo: cargo install zoxide --locked Adicione zoxide ao final do arquivo de configuração do Bash (geralmente ~/.bashrc): eval "$(zoxide init bash)" Reinicie o shell e use z para acessar um diretório: z foo
Onde consigo zoxide?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ajeetdsouza/zoxide

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

Projetos relacionados