cdp

2.2.0

cdp - A fast and intuitive project directory switcher for PowerShell. Fuzzy-find your way to any project instantly.

Minimum PowerShell version

5.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name cdp

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name cdp

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2025 GoldenZqqq. All rights reserved.

Package Details

Author(s)

  • GoldenZqqq

Tags

project-manager fzf fuzzy-search navigation productivity vscode cursor terminal cli windows-terminal ai-cli

Functions

Invoke-Cdp Switch-Project Get-ProjectList Add-Project Set-ProjectPin Clear-ProjectPin Repair-ProjectConfig Initialize-Cdp Add-ProjectAlias Remove-ProjectAlias Add-ProjectTag Remove-ProjectTag Import-GitProjects Remove-Project Edit-ProjectConfig Set-ProjectConfig Test-ProjectHealth Show-CdpAbout Get-CdpRecentProjects Reset-CdpRecentProjects Show-CdpProjectStatus Invoke-CdpWorkspace

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

v2.2.0 - Automation and Multi-Repository Workflows
- Added: cdp status --json and Show-CdpProjectStatus -Json emit stable schema version 1 for scripts, CI, and AI agents
- Added: status --no-color and -NoColor provide ANSI-free human-readable output
- Added: JSON status exit codes distinguish clean success, attention, partial scan failure, and fatal failure
- Added: optional Windows, WSL, Linux, and macOS project path profiles with CDP_PATH_PROFILE override
- Added: shared cross-runtime path-profile fixtures and path_profile_invalid automation diagnostics
- Added: full workspace list/show/add/edit/remove/validate/fix/open lifecycle with stable raw-path references
- Added: tabs and horizontal/vertical split layouts, per-project launchers, split sizes, and workspace completion
- Added: safe cdp exec/run selectors, native argv execution, bounded concurrency/timeouts, dry-run/fail-fast, and schema version 1 JSON results
- Added: deterministic frecency ranking keeps pinned projects first and favors frequent, recent visits across picker, list, and multi-match query candidates
- Added: CDP_FRECENCY opt-out plus safe cdp recent reset and Reset-CdpRecentProjects preview/approval workflows
- Improved: structured status keeps raw and resolved paths separate and exposes stable status, attention-reason, and redacted error codes
- Improved: switching, status, workspace, doctor/repair, add/scan/init, picker/list, and recent paths share one resolver while rootPath remains backward compatible
- Safety: repair and status fix preserve unavailable explicit platform mappings and mutate missing projects by name plus raw path identity
- Safety: workspace migration preserves unknown/unresolved references, launch planning validates every target before native WT/tmux argv execution, and dry-run starts no process
- Fixed: Windows PowerShell 5.1 normalizes JSON arrays consistently for path profiles, workspaces, and multi-repository exec
- Fixed: Windows PowerShell 5.1 workspace size validation and native stderr capture no longer fail on edition-specific runtime behavior
- Fixed: empty PowerShell JSON arrays and null entries remain stable across Windows PowerShell 5.1 and PowerShell 7

FileList

Version History

Version Downloads Last updated
2.2.0 (current version) 8 7/21/2026
2.0.4 14 7/17/2026
2.0.3 15 7/11/2026
2.0.2 9 7/10/2026
2.0.1 7 7/10/2026
2.0.0 8 7/10/2026
1.7.0 13 7/4/2026
1.6.3 9 7/3/2026
1.6.2 7 7/3/2026
1.6.1 8 7/3/2026
1.6.0 7 7/3/2026
1.5.0 13 6/17/2026
1.4.1 9 6/17/2026
1.4.0 7 6/15/2026
1.3.0 10 6/13/2026
1.2.6 42 10/21/2025
1.2.5 6 10/21/2025
1.2.4 6 10/21/2025
1.2.3 6 10/21/2025
1.2.2 8 10/17/2025
1.2.1 5 10/17/2025
1.2.0 9 10/17/2025
1.1.1 10 10/16/2025
1.1.0 8 10/16/2025
Show more