https://github.com/nodef/extra-cd
Change the working directory, with shortcuts and listing.
https://github.com/nodef/extra-cd
cd change cli command directory extra interface line
Last synced: about 1 month ago
JSON representation
Change the working directory, with shortcuts and listing.
- Host: GitHub
- URL: https://github.com/nodef/extra-cd
- Owner: nodef
- License: mit
- Created: 2018-08-01T00:43:42.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2025-04-08T17:10:43.000Z (about 1 year ago)
- Last Synced: 2026-03-28T09:46:22.390Z (3 months ago)
- Topics: cd, change, cli, command, directory, extra, interface, line
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/extra-cd.sh
- Size: 84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
Change the working directory, with shortcuts and listing.
🐚 [Shell](https://www.npmjs.com/package/extra-cd.sh),
🖥️ [Command prompt](https://www.npmjs.com/package/extra-cd.cmd),
📜 [Files](https://unpkg.com/extra-cd.sh/).
The [cd] (or `chdir`) is a [builtin shell command] to *change* the *current*
*working directory* of the *shell*. This package provides a **user-friendly**
**version** of the `cd` command, called `ecd`. It **lists the contents** of a
directory upon changing directory, and also provides the ability to **save**
**absolute and relative shortcuts**. Please check the examples below.
> Stability: [Experimental](https://www.youtube.com/watch?v=L1j93RnIxEo).
[cd]: https://en.wikipedia.org/wiki/Cd_(command)
[builtin shell command]: https://en.wikipedia.org/wiki/Shell_builtin
```bash
# Install on Linux
$ npm install -g extra-cd.sh
$ source "$(which extra-cd)"
# Install on Windows
$ npm install -g extra-cd.cmd
```
```bash
$ ecd [-] [+/-/=] [path]
# [] -> optional argument
# <> -> argument value
# Change to workspace directory
$ ecd /local/mnt/workspace
# Change to up one directory
$ ecd ..
# Stay at current directory (list contents)
$ ecd .
# Change to previous directory
$ ecd -
# Add current directory as shortcut
$ ecd +work
# Change to root directory
$ ecd /
# Change to workspace directory using shortcut
$ ecd =work
# Remove workspace shortcut
$ ecd -work
# Add relative path shortcut
$ ecd +up3 ../../..
# Go up 3 directories
$ ecd =up3
# Remove relative path shortcut
$ ecd -up3
```
## References:
- [cd (command)](https://en.wikipedia.org/wiki/Cd_(command))
[](https://www.youtube.com/watch?v=aZ1Zp3gNcEI)
[](https://nodef.github.io)
[](https://zenodo.org/badge/latestdoi/143084625)
