Skip to content

Commit

Permalink
Bump to v0.3.1; add docs
Browse files Browse the repository at this point in the history
  • Loading branch information
ProbablyFaiz committed Mar 26, 2024
1 parent 23ff21b commit cb1c8d2
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 1 deletion.
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,41 @@

## Installation

On your local machine:
```bash
pip install "rl @ git+https://github.com/reglab/rl.git"
```

On Sherlock, you should probably use the pre-compiled binary instead:
```bash
wget "https://github.com/ProbablyFaiz/rl/releases/download/v0.3.1/rl" -O ~/.local/bin/rl
```


## Setup

> [!NOTE]
> RL requires you to configure Duo and NetID credentials to work. These **never** leave your device;
> use of RL is as secure as using an SSH key stored on your device to sign in to a remote server.
> For the same reason, you should not use RL on a shared computer or share your configuration with others.
### Duo

> *TODO: Add visual instructions for setting up Duo.*
- Go to Duo Central. Add a device with the phone number `805-555-0199` (this is a [reserved fake number](https://arc.
net/l/quote/fbclpupw)). When it shows the QR code, right click and copy its image address.
- Run `rl configure duo`. Paste the image address when prompted.


### Sherlock

To access Sherlock, RL also requires your NetID credentials. You can configure them by running `rl configure sherlock`.

That's it! You should now be able to use `rl ssh` without needing to enter a Duo code.

## Usage

```bash
Usage: rl [OPTIONS] COMMAND [ARGS]...

Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "rl"
version = "0.3.0"
version = "0.3.1"
authors = [
{ name = "Faiz Surani", email = "[email protected]" },
]
Expand Down

0 comments on commit cb1c8d2

Please sign in to comment.