cd-extras
3.0.0-beta3
Fast directory navigation, history, bookmarks and path completion for PowerShell
Minimum PowerShell version
5.0
Installation Options
Owners
Copyright
(c) Nick Cox. All rights reserved.
Package Details
Author(s)
- Nick Cox
Tags
cd+ cd- AUTO_CD CD_PATH CDABLE_VARS bookmarks frecency navigation zoxide bash zsh
Functions
Add-Bookmark Clear-Stack Expand-Path Get-Ancestors Get-Bookmark Get-CdExtrasOption Get-FrecentLocation Get-RecentLocation Get-Stack Get-Up Redo-Location Remove-Bookmark Remove-RecentLocation Set-CdExtrasOption Set-FrecentLocation Set-LocationEx Set-RecentLocation Step-Up Switch-LocationPart Undo-Location
Dependencies
This module has no dependencies.
Release Notes
### Added
- Add recent and frecent directory navigation with `Get-RecentLocation`, `Set-RecentLocation`,
`Get-FrecentLocation` and `Set-FrecentLocation`.
- Add directory bookmarks with `Add-Bookmark`, `Get-Bookmark` and `Remove-Bookmark`.
- Add optional CSV persistence for recent locations and bookmarks. The CSV contains `Path`,
`LastEntered`, `EnterCount` and `Favour` columns and is enabled with `RECENT_DIRS_FILE`.
- Add configurable frecency providers and automatic zoxide integration when zoxide is available.
- Add `Get-CdExtrasOption` and its `getocd` alias.
- Add separate navigation, completion and configuration documentation.
### Changed
- Allow recent and frecent navigation by index or search terms.
- Allow `Set-CdExtrasOption` to update multiple options from any `IDictionary` implementation.
- Retain every bookmark when recent history is trimmed.
- Make `cdr -Prune` and `cdf -Prune` default to the current directory when no pattern is supplied.
- Normalise custom frecency results, discard invalid results and apply the result limit afterwards.
- Replace wildcard manifest exports with the explicit 3.0 public command and alias lists.
- Remove the completion warning beep and report truncated results in the completion tooltip.
### Fixed
- Prevent concurrent shells from losing each other's persisted history updates.
- Persist deletion of the final recent entry and reconcile external CSV additions, removals and
deletion consistently.
- Validate persisted CSV rows before replacing in-memory history.
- Prevent ordinary recent entries from displacing bookmarks.
- Reject missing paths and non-container items when creating bookmarks.
### Breaking changes
- Remove `Step-Between` and its `cdb` alias. Use `Set-RecentLocation` or `cdr` to move between
recently used directories.
- Replace the `ToolTipExtraInfo` option with `ToolTip`. The new callback receives the completion item
and a Boolean indicating whether results were truncated, and returns the complete tooltip text.
FileList
- cd-extras.nuspec
- cd-extras.psd1
- public\Get-Stack.ps1
- public\Undo-Location.ps1
- docs\cd.md
- public\Expand-Path.ps1
- public\Remove-Bookmark.ps1
- docs\completion.md
- about_Cd-Extras.help.txt
- public\Step-Up.ps1
- public\Set-RecentLocation.ps1
- private\CompleteAncestors.ps1
- cd-extras.psm1
- public\Get-CdExtrasOption.ps1
- public\Get-RecentLocation.ps1
- private\AutoCd.ps1
- public\Get-Up.ps1
- public\Switch-LocationPart.ps1
- assets\cd-enhancements.svg
- private\CompleteFrecent.ps1
- public\Remove-RecentLocation.ps1
- public\Set-FrecentLocation.ps1
- assets\overview.svg
- private\Core.ps1
- public\Clear-Stack.ps1
- public\Add-Bookmark.ps1
- assets\auto-cd.svg
- private\CompleteRecent.ps1
- public\Get-Bookmark.ps1
- public\Aliases.ps1
- assets\navigation-helpers.svg
- private\CompletePaths.ps1
- public\Set-CdExtrasOption.ps1
- public\Get-FrecentLocation.ps1
- docs\navigation.md
- private\CompleteStack.ps1
- public\Get-Ancestors.ps1
- public\_Classes.ps1
- docs\configuration.md
- private\CommandNotFound.ps1
- public\Set-LocationEx.ps1
- public\Redo-Location.ps1
Version History
| Version | Downloads | Last updated |
|---|---|---|
| 3.0.0-beta3 (current version) | 5 | 8/26/2026 |
| 3.0.0-beta2 | 19 | 3/18/2026 |
| 3.0.0-beta1 | 167 | 2/22/2023 |
| 2.9.4 | 16,563 | 3/28/2021 |
| 2.9.3 | 57 | 3/5/2021 |
| 2.9.2 | 50 | 2/25/2021 |
| 2.9.1 | 43 | 2/18/2021 |
| 2.9.0 | 120 | 12/1/2020 |
| 2.8.0 | 207 | 4/27/2020 |
| 2.7.0 | 156 | 1/25/2020 |
| 2.6.0 | 45 | 1/17/2020 |
| 2.5.0 | 43 | 1/14/2020 |
| 2.4.0 | 67 | 12/14/2019 |
| 2.3.0 | 44 | 12/3/2019 |
| 2.2.0 | 47 | 11/27/2019 |
| 2.1.0 | 44 | 11/13/2019 |
| 2.0.0 | 35 | 11/10/2019 |
| 2.0.0-beta2 | 24 | 10/22/2019 |
| 2.0.0-beta1 | 23 | 10/19/2019 |
| 1.12 | 77 | 10/7/2019 |
| 1.11 | 224 | 6/7/2019 |
| 1.10 | 29 | 6/6/2019 |
| 1.9 | 33 | 6/5/2019 |
| 1.8 | 42 | 6/3/2019 |
| 1.7 | 90 | 4/27/2019 |
| 1.6 | 85 | 3/31/2019 |
| 1.5.5 | 33 | 3/27/2019 |
| 1.5.4 | 24 | 3/26/2019 |
| 1.5.3 | 34 | 3/25/2019 |
| 1.5.2 | 28 | 3/25/2019 |
| 1.5.1 | 26 | 3/25/2019 |
| 1.5 | 33 | 3/23/2019 |
| 1.4 | 84 | 2/21/2019 |
| 1.3.1 | 143 | 12/13/2018 |
| 1.3 | 60 | 11/29/2018 |
| 1.2 | 69 | 11/16/2018 |
| 1.1.1 | 24 | 11/16/2018 |
| 1.1.0 | 324 | 9/19/2018 |
| 1.0.4 | 56 | 9/2/2018 |
| 1.0.3 | 23 | 9/2/2018 |
| 1.0.2 | 25 | 9/1/2018 |
| 1.0.1 | 27 | 8/29/2018 |
| 1.0 | 46 | 8/21/2018 |
| 0.9.1 | 47 | 8/1/2018 |
| 0.9.0 | 29 | 7/31/2018 |
| 0.8.2 | 30 | 7/30/2018 |
| 0.8.1 | 27 | 7/29/2018 |
| 0.8.0 | 21 | 7/29/2018 |
| 0.7.0 | 66 | 5/28/2018 |
| 0.6.2 | 38 | 5/20/2018 |
| 0.6.1 | 31 | 5/17/2018 |
| 0.6.0 | 38 | 5/6/2018 |
| 0.5.0 | 25 | 5/5/2018 |
| 0.4.4 | 32 | 4/30/2018 |
| 0.4.3 | 26 | 4/30/2018 |
| 0.4.2 | 31 | 4/25/2018 |
| 0.4.1 | 30 | 4/17/2018 |
| 0.4.0 | 24 | 4/17/2018 |
| 0.3.0 | 67 | 2/24/2018 |
| 0.2.2 | 63 | 2/14/2018 |
| 0.2.1 | 31 | 2/13/2018 |
| 0.2.0 | 33 | 2/11/2018 |
| 0.1.0 | 32 | 2/11/2018 |
| 0.0.1 | 37 | 2/6/2018 |