# pacs
[](https://crates.io/crates/pacs)  [](https://github.com/preiter93/pacs/actions/workflows/ci.yml) [](https://deps.rs/repo/github/preiter93/pacs) [](./LICENSE)
**P**roject **A**ware **C**ommand **S**torage - A CLI for managing and running saved shell commands.
## Install
```sh
cargo install pacs
```
## Usage
```sh
pacs init # initialize pacs
pacs add build "cargo build" # save a command
pacs run build # run it
pacs ls # list all commands
pacs edit build # edit in $EDITOR
pacs rm build # delete it
pacs project add MyProject # create a project
pacs project switch MyProject # set active project
pacs project clear # clear active project
```
## Example Output
```shell
# pacs ls
── Global ──
hello-world
echo "Hello World"
── MyProject ──
get-pods:
kubectl --context dev get pods -o wide
```
## Environments and Placeholders
Use double curly braces to mark placeholders:
```sh
pacs add get-pods -t k8s 'kubectl --context {{kube-context}} get pods -o wide'
```
Define project-specific environments and values (for the active project):
```sh
pacs env add dev # add an environment
pacs env edit # edit environments in $EDITOR
pacs env ls # list all environments
pacs env switch dev # set active environment
```
Listing, running, and copying with a specific environment (active project):
```sh
pacs ls -e dev # list with environment
pacs run get-pods -e dev # run with environment
pacs copy get-pods -e dev # copy with environment
```
Notes:
- If no active environment is set (or values are missing), pacs shows the raw unexpanded command.
- If active environment is set and environment values are defined, pacs expands the command before listing, running or copying it.
## Shell Completions
**Zsh** (`~/.zshrc`):
```sh
source <(COMPLETE=zsh pacs)
```
**Bash** (`~/.bashrc`):
```sh
source <(COMPLETE=bash pacs)
```
**Fish** (`~/.config/fish/config.fish`):
```sh
source (COMPLETE=fish pacs | psub)
```