The Cased client (cased)

Overview
cased is 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.
Requirements & Install
The only requirement to run cased is Python 3.5 or better. There are several easy ways to install the program.
You can install using Homebrew via our tap:
1
brew install cased/tap/cased
Copied!
You can install the cased program system-wide (or into a virtualenv) with pip:
1
python3 -m pip install cased
Copied!
Note that this creates two programs, cased and cased-init, which will then be available on your PATH.
Alternatively, you can clone the Cased CLI repository and run:
1
./install
Copied!
Quick Setup
Now initialize the tool. You need to make sure cased-init (a single-purpose init script) runs every time a shell starts. To do that, just add this line to your ~/.bashrc, ~/.zshrc, or similar file:
1
eval "$(cased-init -)"
Copied!
Next, configure Cased with your unique user token. This will also sync your local client with your Cased remote settings.
1
cased configure <your-user-token>
Copied!
You can also just run:
1
cased configure
Copied!
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:
1
cased verify
Copied!
If you encounter any installation issues, please check our Troubleshooting support page.
Usage
After you've installed cased and 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 cased.
We recommend you periodically (and automatically) run cased sync to keep your local guarded programs up-to-date with your remote configuration. However, even if you don't do this, the cased client will still check its remote server for updates whenever it is invoked.
Configuration
The Cased remote server defaults to https://api.cased.com. To change that url, just set with:
1
cased url <your-remote-server>
Copied!
You can also reset the URL to use the default:
1
cased url --reset
Copied!
Uninstalling
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 rm the ~/.cguard/ directory, where the client stores data, although this isn't strictly necessary. You can also remove the cased and cased-init programs, which are likely in /usr/local/bin/ or a similar location (try which cased and which cased-init to find their location.)

Cased CLI Approvals - Previous

Working with the client on the Command Line

Next - Cased CLI Approvals

Use with Docker

Last modified 6mo ago

Copy link

Contents

Overview

Requirements & Install