`cased` is the command-line tool for configuring and running Cased CLI.
Guard your team's critical command line infrastructure with Cased
casedis the command-line tool for configuring and running Cased CLI. It works via simple shims that wrap your other command-line programs. It handles the hard parts of configuring these shims, and keeps itself up-to-date with changes and additions to your remote Cased configuration.
brew install cased/tap/cased
You can install the
casedprogram system-wide (or into a
virtualenv) with pip:
python3 -m pip install cased
Note that this creates two programs,
cased-init, which will then be available on your
Alternatively, you can clone this repo and run:
Now initialize the tool. You need to make sure
initscript) runs every time a shell starts. To do that, just add this line to your
~/.zshrc, or similar file:
eval "$(cased-init -)"
Next, configure Cased with your unique user token. This will also sync your local client with your Cased remote settings.
cased configure <your-user-token>
You can also just run:
and follow the web-based connect instructions.
Lastly, start a new shell for the environment changes to take effect.
You can confirm the entire installation with:
After you've installed
casedand configured it, you're all set. Just run your programs as usual, and any that have been configured by your Cased server will run under
We recommend you periodically (and automatically) run
cased syncto keep your local guarded programs up-to-date with your remote configuration. However, even if you don't do this, the
casedclient will still check its remote server for updates whenever it is invoked.
The Cased remote server defaults to
api.cased.com. To change that url, just set with:
cased url <your-remote-server>
You can also reset the URL to use the default:
cased url --reset
Cased CLI supports recording of session output. To enable the functionality, set the
Although not needed for regular use,
caseddoes expose some low-level plumbing commands:
To see all currently installed shims:
To see all remote shims:
Since the Cased client is so lightweight, you can simply remove the
eval "$(cased-init -)"from your shell startup script, and open a new shell. Programs will no longer be guarded.
To completely remove a Cased install, you can
~/.cguard/directory, where the client stores data, although this isn't strictly necessary. You can also remove the
cased-initprograms, which are likely in
/usr/local/bin/or a similar location (try
which cased-initto find their location.)