thinca / ciw

A wrapper to install cli binary from language associated package manager.

ciw - CLI Install Wrapper

A wrapper to install cli binary from language associated package manager.

Requirements

• jq
• curl

Following commands are required for each plugins.

• go
• npm
• cargo

Install

Put bin/ciw to your $PATH. This is just a Bash script.

$ curl https://raw.githubusercontent.com/thinca/ciw/master/bin/ciw -o path/to/bin/ciw
$ chmod a+x path/to/bin/ciw

Usage

Install app

$ ciw install cargo:ripgrep

Arguments of ciw install takes a form like ${type}:${package} or ${type}:${package}@${version}.

$ ciw install go:github.com/mattn/jvgrep/[email protected]

List installed apps

$ ciw list
cargo:ripgrep

Update apps

ciw update without arguments to update all installed apps.

$ ciw update

Or, ciw update with arguments to update specified apps.

$ ciw update cargo:ripgrep

ciw checks if a newer version exists, and does nothing if there is no newer version.

Note that only apps without @${version} can be updated.

Uninstall app

$ ciw uninstall cargo:ripgrep

Restore

You can restore all apps from ciw list.

# Save your apps list to "ciw.list" file
$ ciw list > ciw.list

# Restore your apps from saved list
$ ciw install $(< ciw.list)

Group

By default, all apps are installed to main group.

You can change group by -g or --group option or $CIW_GROUP environment variable.

$ ciw -g local install cargo:ripgrep

Installed app is placed at each group, but CLIs are linked at $CIW_INSTALL_PATH as same.

ciw list lists only the specified group.

Environment Variables

$CIW_INSTALL_PATH

Installed apps are linked from this directory. You should add this directory to $PATH.

Default: ${HOME}/.local/bin

$CIW_GROUP

Group name.

Default: main

$CIW_DATA_PATH

Base directory to place data of ciw.

Default:

• ${XDG_DATA_HOME}/ciw (if ${XDG_DATA_HOME} is present.)
• ${HOME}/.local/share/ciw

$CIW_PACKAGES_PATH

Base directory to install apps.

Default: ${CIW_DATA_PATH}/pkg/${CIW_GROUP}

$CIW_CACHE_PATH

Some plugin makes cache data under this directory.

Default:

• ${XDG_CACHE_HOME}/ciw (if ${XDG_CACHE_HOME} is present.)
• ${HOME}/.cache/ciw

License

Zlib License

Author

thinca [email protected]