CmdKeep

CmdKeep is a tool for conveniently saving and reusing shell commands.

Use it for commands you often forget, are tedious to type, or have several parameters.

Commands can be parameterized, and previous arguments are remembered.

Installation

Check the Releases section for the latest executables.

Add ck to your PATH environment variable for convenience.

Usage

Run ck -h to see available operations, or ck <operation> -h for help with an individual operation.

Command Templates

Commands are specified as template strings, where sets of braces indicate parameters.

Braces may optionally contain a name for the parameter. Multiple parameters with the same name will share a value.

Adding Commands

★ Creates a cat command with a file parameter:

ck add cat "cat {file}"

★ Creates a diff command with two unnamed parameters:

ck add diff "diff {} {}"

Running Commands

★ Runs a saved cat command. You will be prompted for any arguments:

ck cat
# OR
ck run cat

★ Runs the diff command with the given arguments (to skip prompting):

ck diff --args=firstarg,secondarg

★ Reruns the last command executed, prompting the user for arguments:

ck last

★ Reruns the last command with the same arguments. The user will not be prompted:

ck last -dy

★ Runs an arbitrary command without saving it:

ck -c 'git commit -m "{}"'

★ Prints the assembled diff command instead of executing it:

ck diff -p --args=firstarg,secondarg

Listing Commands

★ Lists all saved commands:

ck commands

Deleting Saved Comamnds

★ Deletes cat and diff commands that were previously saved using ck add:

ck rm cat diff

Other Use Cases

Run Multiple Commands in One Template (Bash)

ck add commit_push "bash -c 'git add . && git commit && git push'"

Evaluate a Command in the Current Shell (Bash)

# Add a `source` command with a 'file' parameter.
ck add source "source {file}"
# Print the command with the given argument, then evaluate the result.
eval "$(ck source -p --args=install.sh)"

Example Commands

Add these commands to your installation using ck add.

Note that quotes may need to be escaped, and many of the commands are for Bash/Unix systems.

Git

Key	Template
checkout_file	git checkout {revision} -- {file}
clone_code	bash -c 'repo_url={URL}; git clone $repo_url && cd "$(basename $repo_url .git)" && code .'
gcp	bash -c 'git add . && git commit && git push'
glog	git log --pretty="format:%C(auto,yellow)%h%C(auto,magenta)% G?%C(auto,blue)%>(18,trunc)%ad %C(auto,green)%<(12,trunc)%aN%C(auto,reset)%s" {file}
new_branch	git checkout -b '{branch name}'

Files

Key	Template
ssh	ssh {flags} {user}@{hostname}
rsync	rsync -avz --progress {src} {user}@{hostname}:{dest}
compress	tar {flags} -czvf '{archive name}' {contents}
extract	bash -c "mkdir -p '{output directory}' && tar -xzvf '{archive}' -C '{output directory}'"
chmod	chmod {flags} {perm} '{path}'
delete_empty	find . -type d -empty -delete
find_files	find '{directory}' -type f -iname '{glob}'
backup_replace	sed -i.bak 's/{old text}/{new text}/g' '{file}'
rec_replace	find '{directory}' -type f -exec sed -i 's/{old text}/{new text}/g' \{\} +
diff	diff {} {}
rg	rg '{search term}' '{directory}' --glob '{glob}' {flags}

Bash Functions

Key	Template
redirect_all	bash -c "{command} &> '{file}'"
tee_cmd	bash -c '{command} | tee "{output file}"'
bg	bash -c "nohup {command} > '{output file}' 2>&1 &"

Building from Source

1. Clone the repository.
2. Run go build -o bin/ck (platform-dependent).

Contributing

Pull requests are welcome!