https://github.com/toshi0383/cmdshelf
Better scripting life with cmdshelf 📚
https://github.com/toshi0383/cmdshelf
rust script-manager
Last synced: 9 months ago
JSON representation
Better scripting life with cmdshelf 📚
- Host: GitHub
- URL: https://github.com/toshi0383/cmdshelf
- Owner: toshi0383
- License: apache-2.0
- Created: 2017-06-19T00:58:38.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-05-28T07:30:28.000Z (almost 7 years ago)
- Last Synced: 2025-06-13T05:46:09.037Z (10 months ago)
- Topics: rust, script-manager
- Language: Rust
- Homepage:
- Size: 220 KB
- Stars: 128
- Watchers: 7
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# cmdshelf 
`cmdshelf` is a new way of scripting.😎
- ✅ Seperate name space using directories (e.g. `swiftpm/install.sh` `your/tool/install.sh`)
- ✅ No more `$PATH` configurations
- ✅ bash-completion for all commands
- ✅ `stdout`, `stdin`, `stderr`
- ✅ No quoting required for arguments. (just like `swift run`)
- ✅ The coolest manual page
- ✅ Portable environment (`.cmdshelf.toml`)
- ✅ Execute any executables.
You can see detailed document [here](docs/getting-started.md), or type `man cmdshelf`.
# Install
## macOS
```
brew install cmdshelf
```
It's recommended to [upgrade your bash to version 4](https://troymccall.com/better-bash-4--completions-on-osx/), to use full feature of cmdshelf's bash-completion.
See: https://github.com/toshi0383/cmdshelf/pull/88
## Build from source
With Rust's package manager [cargo](https://github.com/rust-lang/cargo), you can install cmdshelf via:
```bash
cargo install cmdshelf
```
Note that rust is required.
### Install auto bash-completion
Put this in your `~/.bashrc`,
```shell
source /path-to/cmdshelf-completion.bash
```
# Contribute
Any contribution is welcomed.
Feel free to open issue for bug reports, questions, or feature requests.