#command-line-tool #project #folder #cd

bin+lib project_cd

A CLI tool to help you switch between your projects folder

1 unstable release

Uses new Rust 2024

new 0.1.0 May 7, 2025

#250 in Configuration

Download history 128/week @ 2025-05-06

128 downloads per month

MIT license

18KB
489 lines

Project cd

Table of Contents

Motivation

Sometimes you need to switch between project folders in your terminal too often, this project tries to make that a little easier.

Requirements

Installation

To install you just need to execute

## Install package
cargo install --locked project_cd

## Install wrapper script
project_cd -i

Source pcd script

It's a bit tricky change folder from a script in a terminal. Usually scripts create a child process to execute its commands, so when you change the folder you're only changing in the child process, that it's terminated at the end of the execution. So to allow the pcd to change the folder at the parent directory you need to add the following line into your .bashrc or equivalent

# Pcd activate
source ~/.cargo/bin/pcd

It might vary depending on your cargo binary folder, but the project_cd -i command will show you the exact path of the pcd wrapper

Usage

After you're done with the installation, you just need to execute the pcd with the desired flags use the --help to more information about it

Adding a new project to the list

> pcd -a <path-to-project> 

Removing a project from the list

> pcd -r <project_name>

Switching to a project

> pcd

Contributing

If you feel like something is missing/broken, feel free to create an issue or submit a PR.

License

This project is under the MIT License. See the LICENSE file for more details.

Dependencies

~5–13MB
~151K SLoC