{"id":13596546,"url":"https://github.com/vors/ZLocation","last_synced_at":"2025-04-09T16:33:02.136Z","repository":{"id":24488756,"uuid":"27893363","full_name":"vors/ZLocation","owner":"vors","description":"ZLocation is the new Jump-Location","archived":false,"fork":false,"pushed_at":"2024-05-22T09:08:05.000Z","size":255,"stargazers_count":588,"open_issues_count":29,"forks_count":30,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-04T07:33:02.275Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PowerShell","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/vors.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2014-12-11T21:53:58.000Z","updated_at":"2025-03-18T13:11:14.000Z","dependencies_parsed_at":"2024-10-26T21:16:44.154Z","dependency_job_id":"7d16ed6e-f2bc-41a3-9a55-b141211f4800","html_url":"https://github.com/vors/ZLocation","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vors%2FZLocation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vors%2FZLocation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vors%2FZLocation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vors%2FZLocation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vors","download_url":"https://codeload.github.com/vors/ZLocation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248067965,"owners_count":21042391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-01T16:02:33.956Z","updated_at":"2025-04-09T16:32:57.129Z","avatar_url":"https://github.com/vors.png","language":"PowerShell","funding_links":[],"categories":["PowerShell","🚀 Productivity","Commandline Productivity"],"sub_categories":[],"readme":"[![Build status](https://ci.appveyor.com/api/projects/status/qqg75o50jj6e35mn/branch/master?svg=true)](https://ci.appveyor.com/project/vors/zlocation/branch/master)\n\nZLocation\n=========\n\n[![Join the chat at https://gitter.im/vors/ZLocation](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/vors/ZLocation?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nTracks your most used directories, based on number of previously run commands.\nAfter  a  short  learning  phase, `z` will take you to the most popular directory that matches all of the regular expressions given on the command line.\nYou can use **Tab-Completion / Intellisense** to pick directories that are not the first choice.\n\nZLocation is the successor of [Jump-Location](https://github.com/tkellogg/Jump-Location).\nLike [z.sh](https://github.com/rupa/z) is a reimagined clone of [autojump](https://github.com/joelthelion/autojump), Zlocation is a reimagined clone of Jump-Location.\n\nUsage\n-----\n\nZLocation keeps track of your `$pwd` (current folder).\nOnce visited, folder become known to ZLocation.\nYou can `cd` with just a hint of the path!\n\nThe full command name is `Invoke-ZLocation`, but in examples I use alias `z`.\nIt's all about navigation speed, isn't it?\n\n```\nPS C:\\Users\\sevoroby\u003e z c:\nPS C:\\\u003e z zlo\nPS C:\\dev\\ZLocation\u003e z dsc\nPS C:\\dev\\azure-sdk-tools\\src\\ServiceManagement\\Compute\\Commands.ServiceManagement\\IaaS\\Extensions\\DSC\u003e z test\nPS C:\\dev\\ZLocation\\ZLocation.Tests\u003e\n```\n\n### List known locations\n\n`z` without arguments will list all the known locations and their weights (short-cut for `Get-ZLocation`)\n\nTo see all locations matched to a query `foo` use `z -l foo`.\n\n### Navigating to less common directories with tab completion\n\nIf `z mydir` doesn't take you to the correct directory, you can also tab through\nZLocation's suggestions.\n\nFor example, pressing tab with `z src` will take you through all of ZLocation's\ncompletions for `src`.\n\n### Going back\n\nZLocation keeps a stack of directories as you jump between them. `z -` will\n\"pop\" the stack: it will move you to the previous directory you jumped to,\nbasically letting you undo your `z` navigation.\n\nIf the stack is empty (you have only jumped once), `z -` will take you to your\noriginal directory.\n\nFor example:\n\n```ps\nC:\\\u003ez foo\nC:\\foo\u003ez bar\nC:\\baz\\bar\u003e z -\nC:\\foo\u003ez -\nC:\\\u003ez -\nC:\\\u003e#no-op\n```\n\nGoals / Key features\n--------------------\n\n*  Support for multiple PS sessions.\n*  Good built-in ranking algorithm.\n*  ~~Customizable matching algorithm and weight function.~~\n*  Works on Windows, Linux and MacOS.\n\n## Install\nInstall from [PowerShellGet Gallery](https://www.powershellgallery.com/packages/ZLocation/)\n```powershell\nInstall-Module ZLocation -Scope CurrentUser\n```\n\nMake sure to **include ZLocation import in your `$PROFILE`**.\nIt intentionally doesn't alter `$PROFILE` automatically on installation.\n\nThis one-liner installs ZLocation, imports it and adds it to a profile.\n\n```powershell\nInstall-Module ZLocation -Scope CurrentUser; Import-Module ZLocation; Add-Content -Value \"`r`n`r`nImport-Module ZLocation`r`n\" -Encoding utf8 -Path $PROFILE.CurrentUserAllHosts\n```\n\nIf you want to display some additional information about ZLocation on start-up, you can put this snippet in `$PROFILE` after import. \n```powershell\nWrite-Host -Foreground Green \"`n[ZLocation] knows about $((Get-ZLocation).Keys.Count) locations.`n\"\n```\n\n### Note\n\nZLocation alternates your prompt function to track the location. Meaning if you use this module with other modules that modifies your prompt function (e.g. such as `posh-git`), then you'd need to adjust your [Powershell profile file](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-7). The statement `Import-Module ZLocation` needs to be placed **after** the other module imports that modifies your prompt function.\n\nYou can open up `profile.ps1` through using any of the below commands:\n\n```powershell\nnotepad $PROFILE.CurrentUserAllHosts\nnotepad $env:USERPROFILE\\Documents\\WindowsPowerShell\\profile.ps1\nnotepad $Home\\Documents\\WindowsPowerShell\\profile.ps1\n```\n\nAlternatively, type up the below in your file explorer, and then edit the `profile.ps1` file with an editor of your choice:\n\n```\n%USERPROFILE%\\Documents\\WindowsPowerShell\n```\n\nLicense\n-------\n\nZLocation is released under the [MIT](LICENSE) license.\n\nZLocation bundles a copy of [LiteDB](http://www.litedb.org/).\n\n### LiteDB License\n\n[MIT](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2017 - Maurício David.\n\nDevelop\n-------\n\n### Run tests\n\nInstall [Pester](https://github.com/pester/Pester).\nRun `Invoke-Pester` from the root folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvors%2FZLocation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvors%2FZLocation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvors%2FZLocation/lists"}