Skip to main content
Project cd
==========

pcd (project cd) - Is a fast way to jump between projects from your terminal

Instead of:
cd ~/development/github/palantir/backend/pigeon-surveillance
Just:
pcd pigeon-surveillance

Supported shells:
* Bash
* Zsh
* Fish


INSTALL
-------
pipx install --python python3.14 git+https://github.com/jestenough/pcd.git
pcd shell install
Restart your shell after installing shell integration.


QUICK START
----------
cd <your root folder, e.g. ~/Github/>
pcd init
pcd <project name from your root folder>
pcd discovers projects inside registered scan roots.


COMMANDS
--------

pcd <project> Jump to a project
pcd Show help

pcd add <path> Add a project manually
pcd remove <project> Remove a manual project

pcd init Add the current directory as a scan root
pcd uninit Remove the current directory from scan roots
pcd roots List scan roots
pcd refresh Rescan roots and rebuild the project cache

pcd list List all known projects
pcd config-path Print the configuration file path

pcd shell install Install shell integration
pcd shell status Show shell integration status
pcd shell uninstall Remove shell integration

pcd --project <project> Jump to a project whose name matches a command
pcd --version Show version
pcd --help Show help

* Projects inside registered roots are discovered automatically.
* You can register multiple scan roots.


DEVELOPMENT
-----------
make install
make check
make build
See ./dist folder
You can install *.whl with your python package manager


SEE ALSO
--------
Features:
FEATURES.txt

Planned changes:
ROADMAP.md

Changelog:
CHANGELOG.md

License:
MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pcd_cli-0.1.0.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pcd_cli-0.1.0-py3-none-any.whl (21.9 kB view details)

Uploaded Python 3

File details

Details for the file pcd_cli-0.1.0.tar.gz.

File metadata

  • Download URL: pcd_cli-0.1.0.tar.gz
  • Upload date:
  • Size: 17.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pcd_cli-0.1.0.tar.gz
Algorithm Hash digest
SHA256 3184ac637e7b71670baf636d7bb9af32bc0c9037811824b9231f4962dd16e148
MD5 9e8fc27d1cddcb71bd254846f0f13c82
BLAKE2b-256 a20714c3fba393c02b0e843b11cf485da471200fccc31a30403bdd29b5a1f323

See more details on using hashes here.

Provenance

The following attestation bundles were made for pcd_cli-0.1.0.tar.gz:

Publisher: release.yml on jestenough/pcd

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pcd_cli-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: pcd_cli-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 21.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pcd_cli-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0c2f8deda1e3c931e9acec7a3ab2175339baf4d06e36ba72028f2390814f300b
MD5 21a949507602936b65481126126ba5b4
BLAKE2b-256 2296454d75330d3dacb8af1683dab7956cda0f857e40202d5def086788a2394c

See more details on using hashes here.

Provenance

The following attestation bundles were made for pcd_cli-0.1.0-py3-none-any.whl:

Publisher: release.yml on jestenough/pcd

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page