{"id":13396148,"url":"https://github.com/ajeetdsouza/zoxide","last_synced_at":"2026-08-06T08:51:54.351Z","repository":{"id":37246726,"uuid":"245166720","full_name":"ajeetdsouza/zoxide","owner":"ajeetdsouza","description":"A smarter cd command. Supports all major shells.","archived":false,"fork":false,"pushed_at":"2026-08-03T18:32:57.000Z","size":4427,"stargazers_count":38486,"open_issues_count":134,"forks_count":854,"subscribers_count":72,"default_branch":"main","last_synced_at":"2026-08-04T16:15:03.867Z","etag":null,"topics":["autojump","bash","cli","command-line","command-line-tool","elvish","fasd","fish","fish-shell","fzf","hacktoberfest","jump","nushell","powershell","rust","shell","xonsh","xontrib","z","zsh"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/zoxide","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ajeetdsouza.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-03-05T13:11:40.000Z","updated_at":"2026-08-04T15:38:15.000Z","dependencies_parsed_at":"2026-08-02T03:00:47.089Z","dependency_job_id":null,"html_url":"https://github.com/ajeetdsouza/zoxide","commit_stats":{"total_commits":437,"total_committers":64,"mean_commits":6.828125,"dds":"0.22425629290617854","last_synced_commit":"3022cf3686b85288e6fbecb2bd23ad113fd83f3b"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/ajeetdsouza/zoxide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajeetdsouza%2Fzoxide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajeetdsouza%2Fzoxide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajeetdsouza%2Fzoxide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajeetdsouza%2Fzoxide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ajeetdsouza","download_url":"https://codeload.github.com/ajeetdsouza/zoxide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajeetdsouza%2Fzoxide/sbom","scorecard":{"id":174356,"data":{"date":"2025-08-11","repo":{"name":"github.com/ajeetdsouza/zoxide","commit":"4549438ffabd15eade76d076b6dc05627077e6e5"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.4,"checks":[{"name":"Maintained","score":10,"reason":"10 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":5,"reason":"Found 13/26 approved changesets -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:15","Warn: no topLevel permission defined: .github/workflows/no-response.yml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/release.yml:10","Warn: no topLevel permission defined: .github/workflows/winget.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/no-response.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/no-response.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:62: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:72: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:79: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:103: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:113: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/winget.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/ajeetdsouza/zoxide/winget.yml/main?enable=pin","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of  16 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.9.8 not signed: https://api.github.com/repos/ajeetdsouza/zoxide/releases/221090476","Warn: release artifact v0.9.7 not signed: https://api.github.com/repos/ajeetdsouza/zoxide/releases/199267207","Warn: release artifact v0.9.6 not signed: https://api.github.com/repos/ajeetdsouza/zoxide/releases/175829134","Warn: release artifact v0.9.5 not signed: https://api.github.com/repos/ajeetdsouza/zoxide/releases/174867511","Warn: release artifact v0.9.4 not signed: https://api.github.com/repos/ajeetdsouza/zoxide/releases/142874383","Warn: release artifact v0.9.8 does not have provenance: https://api.github.com/repos/ajeetdsouza/zoxide/releases/221090476","Warn: release artifact v0.9.7 does not have provenance: https://api.github.com/repos/ajeetdsouza/zoxide/releases/199267207","Warn: release artifact v0.9.6 does not have provenance: https://api.github.com/repos/ajeetdsouza/zoxide/releases/175829134","Warn: release artifact v0.9.5 does not have provenance: https://api.github.com/repos/ajeetdsouza/zoxide/releases/174867511","Warn: release artifact v0.9.4 does not have provenance: https://api.github.com/repos/ajeetdsouza/zoxide/releases/142874383"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 18 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-16T17:20:40.547Z","repository_id":37246726,"created_at":"2025-08-16T17:20:40.547Z","updated_at":"2025-08-16T17:20:40.547Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36331746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-06T04:43:03.162Z","status":"ssl_error","status_checked_at":"2026-08-06T04:43:02.660Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autojump","bash","cli","command-line","command-line-tool","elvish","fasd","fish","fish-shell","fzf","hacktoberfest","jump","nushell","powershell","rust","shell","xonsh","xontrib","z","zsh"],"created_at":"2024-07-30T18:00:41.296Z","updated_at":"2026-08-06T08:51:54.339Z","avatar_url":"https://github.com/ajeetdsouza.png","language":"Rust","funding_links":[],"categories":["Rust","Terminal","Tools and Plugins","Command-Line Productivity","Files and Directories","Plugins","Developer Tools","Command Line","Integrations","Examples","Command Line Utilities","CLI","Alternatives to `cd`","Command Line Apps","⚡ Productivity","应用相关","HarmonyOS","终端","cli","Catalog","Tools","🚀 Productivity","Miscellaneous Tools","语言资源库","Awesome Tools","bash","FileSystem","\u003ca name=\"core\"\u003e\u003c/a\u003ecore","Applications","CLI power tools ![](https://img.shields.io/badge/_-CLI-000000?style=flat-square\u0026logo=gnubash\u0026logoColor=white)","Command Line Tools","zsh","Uncategorized","\u003ca name=\"cd\"\u003e\u003c/a\u003eDirectory changers (alternatives to cd)","More Awesome Elvish Stuff","系统工具","Productivity","🛠️ Developer Tools","Shells","\\*nix/\\*nux","CLI Applications","CLI Tools with Great Aesthetics","工具","Modern Unix Replacements","Commandline Productivity","Lovely Commands","Terminal Productivity","Command-line Utilities","Other","Tool","Table of Contents","Navigation"],"sub_categories":["Visual Studio Code","Windows","Directory Navigation","ZSH on Windows","Command Line Tools","Dependency Management","Tools","directory jump","Other","Useful Linux Tools","Windows Manager","网络服务_其他","shell","Rust","rust","Terminal Tools","Others","🛠️ Utilities (79)","Privacy front-ends and search","Utilities","Uncategorized","System tools","Product marketing stack","CLI Tools","Sidecards","Terminal","多模态","Reusable Things","Finder","TUI Tool","Terminal Utilities"],"readme":"\u003c!-- markdownlint-configure-file {\n  \"MD013\": {\n    \"code_blocks\": false,\n    \"tables\": false\n  },\n  \"MD033\": false,\n  \"MD041\": false\n} --\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003csup\u003eSpecial thanks to:\u003c/sup\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003c!-- markdownlint-disable-next-line MD013 --\u003e\n      \u003ca href=\"https://go.warp.dev/zoxide\"\u003e\u003cimg alt=\"Sponsored by Warp\" width=\"230\" src=\"https://raw.githubusercontent.com/warpdotdev/brand-assets/refs/heads/main/Github/Sponsor/Warp-Github-LG-03.png\" /\u003e\u003c/a\u003e\n      \u003cdiv\u003e\u003csup\u003e\u003cb\u003eWarp, built for coding with multiple AI agents.\u003c/b\u003e\u003c/sup\u003e\u003c/div\u003e\n      \u003cdiv\u003e\u003csup\u003eAvailable for macOS, Linux, and Windows.\u003c/sup\u003e\u003c/div\u003e\n      \u003cdiv\u003e\u003csup\u003e\n        Visit\n        \u003ca href=\"https://go.warp.dev/zoxide\"\u003e\u003cu\u003ewarp.dev\u003c/u\u003e\u003c/a\u003e\n        to learn more.\n      \u003c/sup\u003e\u003c/div\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003c!-- markdownlint-disable-next-line MD013 --\u003e\n      \u003ca href=\"https://www.recall.ai/careers?ashby_jid=7b02811e-bc91-4ef2-925d-f56a5acac13b\u0026utm_source=github\u0026utm_medium=sponsorship\u0026utm_campaign=zoxide\"\u003e\u003cimg alt=\"Sponsored by Recall.ai\" width=\"230\" src=\"https://github.com/user-attachments/assets/0c5cb177-561c-4637-bef6-cf584939c829\" /\u003e\u003c/a\u003e\n      \u003cdiv\u003e\u003csup\u003eProcessing over 3TB/s of video at peak load,\u003c/sup\u003e\u003c/div\u003e\n      \u003c!-- markdownlint-disable-next-line MD013 --\u003e\n      \u003cdiv\u003e\u003csup\u003enow \u003ca href=\"https://www.recall.ai/careers?ashby_jid=7b02811e-bc91-4ef2-925d-f56a5acac13b\u0026utm_source=github\u0026utm_medium=sponsorship\u0026utm_campaign=zoxide\"\u003ehiring in SF.\u003c/a\u003e\u003c/sup\u003e\u003c/div\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003chr /\u003e\n\n# zoxide\n\n[![crates.io][crates.io-badge]][crates.io]\n[![Downloads][downloads-badge]][releases]\n[![Built with Nix][builtwithnix-badge]][builtwithnix]\n\nzoxide is a **smarter cd command**, inspired by z and autojump.\n\nIt remembers which directories you use most frequently, so you can \"jump\" to\nthem in just a few keystrokes.\u003cbr /\u003e\nzoxide works on all major shells.\n\n[Getting started](#getting-started) •\n[Installation](#installation) •\n[Configuration](#configuration) •\n[Integrations](#third-party-integrations)\n\n\u003c/div\u003e\n\n## Getting started\n\n![Tutorial][tutorial]\n\n```sh\nz foo              # cd into highest ranked directory matching foo\nz foo bar          # cd into highest ranked directory matching foo and bar\nz foo /            # cd into a subdirectory starting with foo\n\nz ~/foo            # z also works like a regular cd command\nz foo/             # cd into relative path\nz ..               # cd one level up\nz -                # cd into previous directory\n\nzi foo             # cd with interactive selection (using fzf)\n\nz foo\u003cSPACE\u003e\u003cTAB\u003e  # show interactive completions (bash 4.4+/fish/zsh only)\n```\n\nRead more about the matching algorithm [here][algorithm-matching].\n\n## Installation\n\nzoxide can be installed in 4 easy steps:\n\n1. **Install binary**\n\n   zoxide runs on most major platforms. If your platform isn't listed below,\n   please [open an issue][issues].\n\n   \u003cdetails\u003e\n   \u003csummary\u003eLinux / WSL\u003c/summary\u003e\n\n   \u003e The recommended way to install zoxide is via the install script:\n   \u003e\n   \u003e ```sh\n   \u003e curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh\n   \u003e ```\n   \u003e\n   \u003e Or, you can use a package manager:\n   \u003e\n   \u003e | Distribution        | Repository              | Instructions                                                      |\n   \u003e | ------------------- | ----------------------- | ----------------------------------------------------------------- |\n   \u003e | **_Any_**           | **[crates.io]**         | `cargo install zoxide --locked`                                   |\n   \u003e | _Any_               | [conda-forge]           | `conda install -c conda-forge zoxide`                             |\n   \u003e | _Any_               | [guix]                  | `guix install zoxide`                                             |\n   \u003e | _Any_               | [Linuxbrew]             | `brew install zoxide`                                             |\n   \u003e | _Any_               | [nixpkgs]               | `nix-env -iA nixpkgs.zoxide`                                      |\n   \u003e | Alpine Linux 3.13+  | [Alpine Linux Packages] | `apk add zoxide`                                                  |\n   \u003e | Arch Linux          | [Arch Linux Extra]      | `pacman -S zoxide`                                                |\n   \u003e | ~~Debian~~[^1]      | ~~[Debian Packages]~~   | ~~`apt install zoxide`~~                                          |\n   \u003e | Devuan 4.0+         | [Devuan Packages]       | `apt install zoxide`                                              |\n   \u003e | Exherbo Linux       | [Exherbo packages]      | `cave resolve -x repository/rust` \u003cbr /\u003e `cave resolve -x zoxide` |\n   \u003e | Fedora 32+          | [Fedora Packages]       | `dnf install zoxide`                                              |\n   \u003e | Gentoo              | [Gentoo Packages]       | `emerge app-shells/zoxide`                                        |\n   \u003e | Manjaro             |                         | `pacman -S zoxide`                                                |\n   \u003e | openSUSE Tumbleweed | [openSUSE Factory]      | `zypper install zoxide`                                           |\n   \u003e | ~~Parrot OS~~[^1]   |                         | ~~`apt install zoxide`~~                                          |\n   \u003e | ~~Raspbian~~[^1]    | ~~[Raspbian Packages]~~ | ~~`apt install zoxide`~~                                          |\n   \u003e | Rhino Linux         | [Pacstall Packages]     | `pacstall -I zoxide-deb`                                          |\n   \u003e | Slackware 15.0+     | [SlackBuilds]           | [Instructions][slackbuilds-howto]                                 |\n   \u003e | Solus               | [Solus Packages]        | `eopkg install zoxide`                                            |\n   \u003e | ~~Ubuntu~~[^1]      | ~~[Ubuntu Packages]~~   | ~~`apt install zoxide`~~                                          |\n   \u003e | Void Linux          | [Void Linux Packages]   | `xbps-install -S zoxide`                                          |\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003emacOS\u003c/summary\u003e\n\n   \u003e To install zoxide, use a package manager:\n   \u003e\n   \u003e | Repository      | Instructions                          |\n   \u003e | --------------- | ------------------------------------- |\n   \u003e | **[crates.io]** | `cargo install zoxide --locked`       |\n   \u003e | **[Homebrew]**  | `brew install zoxide`                 |\n   \u003e | [conda-forge]   | `conda install -c conda-forge zoxide` |\n   \u003e | [MacPorts]      | `port install zoxide`                 |\n   \u003e | [nixpkgs]       | `nix-env -iA nixpkgs.zoxide`          |\n   \u003e\n   \u003e Or, run this command in your terminal:\n   \u003e\n   \u003e ```sh\n   \u003e curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eWindows\u003c/summary\u003e\n\n   \u003e zoxide works with PowerShell, as well as shells running in Cygwin, Git\n   \u003e Bash, and MSYS2.\n   \u003e\n   \u003e The recommended way to install zoxide is via `winget`:\n   \u003e\n   \u003e ```sh\n   \u003e winget install ajeetdsouza.zoxide\n   \u003e ```\n   \u003e\n   \u003e Or, you can use an alternative package manager:\n   \u003e\n   \u003e | Repository      | Instructions                          |\n   \u003e | --------------- | ------------------------------------- |\n   \u003e | **[crates.io]** | `cargo install zoxide --locked`       |\n   \u003e | [Chocolatey]    | `choco install zoxide`                |\n   \u003e | [conda-forge]   | `conda install -c conda-forge zoxide` |\n   \u003e | [Scoop]         | `scoop install zoxide`                |\n   \u003e\n   \u003e If you're using Cygwin, Git Bash, or MSYS2, you can also use the install script:\n   \u003e\n   \u003e ```sh\n   \u003e curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eBSD\u003c/summary\u003e\n\n   \u003e To install zoxide, use a package manager:\n   \u003e\n   \u003e | Distribution  | Repository      | Instructions                    |\n   \u003e | ------------- | --------------- | ------------------------------- |\n   \u003e | **_Any_**     | **[crates.io]** | `cargo install zoxide --locked` |\n   \u003e | DragonFly BSD | [DPorts]        | `pkg install zoxide`            |\n   \u003e | FreeBSD       | [FreshPorts]    | `pkg install zoxide`            |\n   \u003e | NetBSD        | [pkgsrc]        | `pkgin install zoxide`          |\n   \u003e\n   \u003e Or, run this command in your terminal:\n   \u003e\n   \u003e ```sh\n   \u003e curl -sS https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | bash\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eAndroid\u003c/summary\u003e\n\n   \u003e To install zoxide, use a package manager:\n   \u003e\n   \u003e | Repository | Instructions         |\n   \u003e | ---------- | -------------------- |\n   \u003e | [Termux]   | `pkg install zoxide` |\n   \u003e\n   \u003e Or, run this command in your terminal:\n   \u003e\n   \u003e ```sh\n   \u003e curl -sS https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | bash\n   \u003e ```\n\n   \u003c/details\u003e\n\n2. **Setup zoxide on your shell**\n\n   To start using zoxide, add it to your shell.\n\n   \u003cdetails\u003e\n   \u003csummary\u003eBash\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (usually `~/.bashrc`):\n   \u003e\n   \u003e ```sh\n   \u003e eval \"$(zoxide init bash)\"\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eElvish\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (usually `~/.elvish/rc.elv`):\n   \u003e\n   \u003e ```sh\n   \u003e eval (zoxide init elvish | slurp)\n   \u003e ```\n   \u003e\n   \u003e **Note:**\n   \u003e zoxide only supports elvish v0.18.0 and above.\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eFish\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (usually\n   \u003e `~/.config/fish/config.fish`):\n   \u003e\n   \u003e ```sh\n   \u003e zoxide init fish | source\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eNushell\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your env file (find it by running `$nu.env-path`\n   \u003e in Nushell):\n   \u003e\n   \u003e ```sh\n   \u003e zoxide init nushell | save -f ~/.zoxide.nu\n   \u003e ```\n   \u003e\n   \u003e Now, add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (find it by running\n   \u003e `$nu.config-path` in Nushell):\n   \u003e\n   \u003e ```sh\n   \u003e source ~/.zoxide.nu\n   \u003e ```\n   \u003e\n   \u003e **Note:**\n   \u003e zoxide only supports Nushell v0.89.0+.\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003ePowerShell\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (find it by running\n   \u003e `echo $profile` in PowerShell):\n   \u003e\n   \u003e ```powershell\n   \u003e Invoke-Expression (\u0026 { (zoxide init powershell | Out-String) })\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eTcsh\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (usually `~/.tcshrc`):\n   \u003e\n   \u003e ```sh\n   \u003e zoxide init tcsh \u003e ~/.zoxide.tcsh\n   \u003e source ~/.zoxide.tcsh\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eXonsh\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (usually `~/.xonshrc`):\n   \u003e\n   \u003e ```python\n   \u003e execx($(zoxide init xonsh), 'exec', __xonsh__.ctx, filename='zoxide')\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eZsh\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file (usually `~/.zshrc`):\n   \u003e\n   \u003e ```sh\n   \u003e eval \"$(zoxide init zsh)\"\n   \u003e ```\n   \u003e\n   \u003e For completions to work, the above line must be added _after_ `compinit` is\n   \u003e called. You may have to rebuild your completions cache by running\n   \u003e `rm ~/.zcompdump*; compinit`.\n\n   \u003c/details\u003e\n\n   \u003cdetails\u003e\n   \u003csummary\u003eAny POSIX shell\u003c/summary\u003e\n\n   \u003e Add this to the \u003cins\u003e**end**\u003c/ins\u003e of your config file:\n   \u003e\n   \u003e ```sh\n   \u003e eval \"$(zoxide init posix --hook prompt)\"\n   \u003e ```\n\n   \u003c/details\u003e\n\n   \u003e **Note:**\n   \u003e [Warp] provides its own completions, so `Space+Tab` completions are not\n   \u003e supported there.\n\n3. **Install fzf** \u003csup\u003e(optional)\u003c/sup\u003e\n\n   [fzf] is a command-line fuzzy finder, used by zoxide for completions /\n   interactive selection. It can be installed from [here][fzf-installation].\n\n   \u003e **Note:**\n   \u003e The minimum supported fzf version is v0.51.0.\n\n4. **Import your data** \u003csup\u003e(optional)\u003c/sup\u003e\n\n   If you currently use any of these plugins, you may want to import your data\n   into zoxide. The data file is auto-detected using each plugin's standard\n   conventions.\n\n   ```sh\n   zoxide import \u003cplugin\u003e\n   ```\n\n   | Plugin   | Command                  |\n   | -------- | ------------------------ |\n   | atuin    | `zoxide import atuin`    |\n   | autojump | `zoxide import autojump` |\n   | fasd     | `zoxide import fasd`     |\n   | z        | `zoxide import z`        |\n   | z.lua    | `zoxide import z.lua`    |\n   | zsh-z    | `zoxide import zsh-z`    |\n\n## Configuration\n\n### Flags\n\nWhen calling `zoxide init`, the following flags are available:\n\n- `--cmd`\n  - Changes the prefix of the `z` and `zi` commands.\n  - `--cmd j` would change the commands to (`j`, `ji`).\n  - `--cmd cd` would replace the `cd` command.\n- `--hook \u003cHOOK\u003e`\n  - Changes how often zoxide increments a directory's score:\n\n    | Hook            | Description                       |\n    | --------------- | --------------------------------- |\n    | `none`          | Never                             |\n    | `prompt`        | At every shell prompt             |\n    | `pwd` (default) | Whenever the directory is changed |\n\n- `--no-cmd`\n  - Prevents zoxide from defining the `z` and `zi` commands.\n  - These functions will still be available in your shell as `__zoxide_z` and\n    `__zoxide_zi`, should you choose to redefine them.\n\n### Environment variables\n\nEnvironment variables[^2] can be used for configuration. They must be set before\n`zoxide init` is called.\n\n- `_ZO_DATA_DIR`\n  - Specifies the directory in which the database is stored.\n  - The default value varies across OSes:\n\n    | OS          | Path                                     | Example                                    |\n    | ----------- | ---------------------------------------- | ------------------------------------------ |\n    | Linux / BSD | `$XDG_DATA_HOME` or `$HOME/.local/share` | `/home/alice/.local/share`                 |\n    | macOS       | `$HOME/Library/Application Support`      | `/Users/Alice/Library/Application Support` |\n    | Windows     | `%LOCALAPPDATA%`                         | `C:\\Users\\Alice\\AppData\\Local`             |\n\n- `_ZO_ECHO`\n  - When set to 1, `z` will print the matched directory before navigating to\n    it.\n- `_ZO_EXCLUDE_DIRS`\n  - Excludes the specified directories from the database.\n  - This is provided as a list of [globs][glob], separated by OS-specific\n    characters:\n\n    | OS                  | Separator | Example                 |\n    | ------------------- | --------- | ----------------------- |\n    | Linux / macOS / BSD | `:`       | `$HOME:$HOME/private/*` |\n    | Windows             | `;`       | `$HOME;$HOME/private/*` |\n\n  - By default, this is set to `\"$HOME\"`.\n- `_ZO_FZF_OPTS`\n  - Custom options to pass to [fzf] during interactive selection. See\n    [`man fzf`][fzf-man] for the list of options.\n- `_ZO_MAXAGE`\n  - Configures the [aging algorithm][algorithm-aging], which limits the maximum\n    number of entries in the database.\n  - By default, this is set to 10000.\n- `_ZO_RESOLVE_SYMLINKS`\n  - When set to 1, `z` will resolve symlinks before adding directories to the\n    database.\n\n## Third-party integrations\n\n| Application           | Description                                  | Plugin                     |\n| --------------------- | -------------------------------------------- | -------------------------- |\n| [aerc]                | Email client                                 | Natively supported         |\n| [alfred]              | macOS launcher                               | [alfred-zoxide]            |\n| [clink]               | Improved cmd.exe for Windows                 | [clink-zoxide]             |\n| [emacs]               | Text editor                                  | [zoxide.el]                |\n| [felix]               | File manager                                 | Natively supported         |\n| [joshuto]             | File manager                                 | Natively supported         |\n| [lf]                  | File manager                                 | See the [wiki][lf-wiki]    |\n| [nnn]                 | File manager                                 | [nnn-autojump]             |\n| [ranger]              | File manager                                 | [ranger-zoxide]            |\n| [raycast]             | macOS launcher                               | [raycast-zoxide]           |\n| [rfm]                 | File manager                                 | Natively supported         |\n| [sesh]                | `tmux` session manager                       | Natively supported         |\n| [telescope.nvim]      | Fuzzy finder for Neovim                      | [telescope-zoxide]         |\n| [tmux-session-wizard] | `tmux` session manager                       | Natively supported         |\n| [tmux-sessionx]       | `tmux` session manager                       | Natively supported         |\n| [vim] / [neovim]      | Text editor                                  | [zoxide.vim]               |\n| [xplr]                | File manager                                 | [zoxide.xplr]              |\n| [xxh]                 | Transports shell configuration over SSH      | [xxh-plugin-prerun-zoxide] |\n| [yazi]                | File manager                                 | Natively supported         |\n| [zabb]                | Finds the shortest possible query for a path | Natively supported         |\n| [zesh]                | `zellij` session manager                     | Natively supported         |\n| [zsh-autocomplete]    | Realtime completions for zsh                 | Natively supported         |\n\n[^1]:\n    Debian / Ubuntu derivatives update their packages very slowly. If you're\n    using one of these distributions, consider using the install script instead.\n\n[^2]:\n    If you're not sure how to set an environment variable on your shell, check\n    out the [wiki][wiki-env].\n\n[aerc]: https://github.com/rjarry/aerc\n[alfred]: https://www.alfredapp.com/\n[alfred-zoxide]: https://github.com/yihou/alfred-zoxide\n[algorithm-aging]: https://github.com/ajeetdsouza/zoxide/wiki/Algorithm#aging\n[algorithm-matching]: https://github.com/ajeetdsouza/zoxide/wiki/Algorithm#matching\n[alpine linux packages]: https://pkgs.alpinelinux.org/packages?name=zoxide\n[arch linux extra]: https://archlinux.org/packages/extra/x86_64/zoxide/\n[builtwithnix-badge]: https://img.shields.io/badge/builtwith-nix-7d81f7?logo=nixos\u0026logoColor=white\u0026style=flat-square\n[builtwithnix]: https://builtwithnix.org/\n[chocolatey]: https://community.chocolatey.org/packages/zoxide\n[clink-zoxide]: https://github.com/shunsambongi/clink-zoxide\n[clink]: https://github.com/mridgers/clink\n[conda-forge]: https://anaconda.org/conda-forge/zoxide\n[crates.io-badge]: https://img.shields.io/crates/v/zoxide?logo=rust\u0026logoColor=white\u0026style=flat-square\n[crates.io]: https://crates.io/crates/zoxide\n[debian packages]: https://packages.debian.org/stable/admin/zoxide\n[exherbo packages]: https://gitlab.exherbo.org/exherbo/rust/-/tree/master/packages/sys-apps/zoxide\n[devuan packages]: https://pkginfo.devuan.org/cgi-bin/package-query.html?c=package\u0026q=zoxide\n[downloads-badge]: https://img.shields.io/github/downloads/ajeetdsouza/zoxide/total?logo=github\u0026logoColor=white\u0026style=flat-square\n[dports]: https://github.com/DragonFlyBSD/DPorts/tree/master/sysutils/zoxide\n[emacs]: https://www.gnu.org/software/emacs/\n[fedora packages]: https://src.fedoraproject.org/rpms/rust-zoxide\n[felix]: https://github.com/kyoheiu/felix\n[freshports]: https://www.freshports.org/sysutils/zoxide/\n[fzf-installation]: https://github.com/junegunn/fzf#installation\n[fzf-man]: https://manpages.ubuntu.com/manpages/en/man1/fzf.1.html\n[fzf]: https://github.com/junegunn/fzf\n[gentoo packages]: https://packages.gentoo.org/packages/app-shells/zoxide\n[glob]: https://man7.org/linux/man-pages/man7/glob.7.html\n[guix]: https://packages.guix.gnu.org/packages/zoxide/\n[homebrew]: https://formulae.brew.sh/formula/zoxide\n[issues]: https://github.com/ajeetdsouza/zoxide/issues/new\n[joshuto]: https://github.com/kamiyaa/joshuto\n[lf]: https://github.com/gokcehan/lf\n[lf-wiki]: https://github.com/gokcehan/lf/wiki/Integrations#zoxide\n[linuxbrew]: https://formulae.brew.sh/formula-linux/zoxide\n[macports]: https://ports.macports.org/port/zoxide/summary\n[neovim]: https://github.com/neovim/neovim\n[nixpkgs]: https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/zo/zoxide/package.nix\n[nnn-autojump]: https://github.com/jarun/nnn/blob/master/plugins/autojump\n[nnn]: https://github.com/jarun/nnn\n[opensuse factory]: https://build.opensuse.org/package/show/openSUSE:Factory/zoxide\n[pacstall packages]: https://pacstall.dev/packages/zoxide-deb\n[pkgsrc]: https://pkgsrc.se/sysutils/zoxide\n[ranger-zoxide]: https://github.com/jchook/ranger-zoxide\n[ranger]: https://github.com/ranger/ranger\n[raspbian packages]: https://archive.raspbian.org/raspbian/pool/main/r/rust-zoxide/\n[raycast]: https://www.raycast.com/\n[raycast-zoxide]: https://www.raycast.com/mrpunkin/raycast-zoxide\n[releases]: https://github.com/ajeetdsouza/zoxide/releases\n[rfm]: https://github.com/dsxmachina/rfm\n[scoop]: https://github.com/ScoopInstaller/Main/tree/master/bucket/zoxide.json\n[sesh]: https://github.com/joshmedeski/sesh\n[slackbuilds]: https://slackbuilds.org/repository/15.0/system/zoxide/\n[slackbuilds-howto]: https://slackbuilds.org/howto/\n[solus packages]: https://github.com/getsolus/packages/tree/main/packages/z/zoxide/\n[telescope-zoxide]: https://github.com/jvgrootveld/telescope-zoxide\n[telescope.nvim]: https://github.com/nvim-telescope/telescope.nvim\n[termux]: https://github.com/termux/termux-packages/tree/master/packages/zoxide\n[tmux-session-wizard]: https://github.com/27medkamal/tmux-session-wizard\n[tmux-sessionx]: https://github.com/omerxx/tmux-sessionx\n[tutorial]: contrib/tutorial.webp\n[ubuntu packages]: https://packages.ubuntu.com/jammy/zoxide\n[vim]: https://github.com/vim/vim\n[void linux packages]: https://github.com/void-linux/void-packages/tree/master/srcpkgs/zoxide\n[warp]: https://www.warp.dev\n[wiki-env]: https://github.com/ajeetdsouza/zoxide/wiki/HOWTO:-set-environment-variables \"HOWTO: set environment variables\"\n[xplr]: https://github.com/sayanarijit/xplr\n[xxh-plugin-prerun-zoxide]: https://github.com/xxh/xxh-plugin-prerun-zoxide\n[xxh]: https://github.com/xxh/xxh\n[yazi]: https://github.com/sxyazi/yazi\n[zabb]: https://github.com/Mellbourn/zabb\n[zesh]: https://github.com/roberte777/zesh\n[zoxide.el]: https://gitlab.com/Vonfry/zoxide.el\n[zoxide.vim]: https://github.com/nanotee/zoxide.vim\n[zoxide.xplr]: https://github.com/sayanarijit/zoxide.xplr\n[zsh-autocomplete]: https://github.com/marlonrichert/zsh-autocomplete\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajeetdsouza%2Fzoxide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajeetdsouza%2Fzoxide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajeetdsouza%2Fzoxide/lists"}