pacs

Project Aware Command Storage - A CLI for managing and running saved shell commands.

Install

cargo install pacs

Usage

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

# 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:

pacs add get-pods -t k8s 'kubectl --context {{kube-context}} get pods -o wide'

Define project-specific environments and values (for the active project):

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):

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):

source <(COMPLETE=zsh pacs)

Bash (~/.bashrc):

source <(COMPLETE=bash pacs)

Fish (~/.config/fish/config.fish):

source (COMPLETE=fish pacs | psub)