rialoman 0.1.6

Rialo native toolchain manager
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# rialoman

Rialoman is the toolchain manager for the Rialo network. It installs prebuilt Rialo toolchains and allows switching between them by keeping shims in the PATH in sync with the active toolchain.

Rialoman uses the following directory layout to manage the installations:
```
$RIALO_HOME (default: $XDG_DATA_HOME/rialo or $HOME/.local/share/rialo)
  bin/         # shims added to PATH
  toolchains/  # channel/version directories
  downloads/   # cached tarballs + manifests (planned)
  tmp/         # staging for atomic installs
  current.json # currently active toolchain pointer
```

## Installation

You can install `rialoman` via `cargo` or using the hosted installer script:

### Option A: `cargo install`
```bash
cargo install rialoman
```

### Option B: curl installer
```bash
curl -fsSL https://rialo-artifacts.s3.us-east-2.amazonaws.com/rialoman/commit/install.sh | bash
```

The installer downloads the prebuilt `rialoman` binary for Linux (amd64/arm64) or macOS (arm64), installs it into `$RIALO_HOME/bin`, and optionally appends the PATH snippet to existing shell profiles (supports Bash, Zsh).

## Examples

### Installing/Uninstalling the CLI

```bash
rialoman install stable@latest
rialoman install commit@830b4ee6
rialoman uninstall 830b4ee6
```

### Switching versions

```bash
# Explicit version
rialoman use stable@0.1.0

# "commit" channel shorthand
rialoman use 830b4ee6
```

### Inspection

```bash
rialoman list         # shows installed toolchains, marks the current one
rialoman current      # prints channel@version
rialoman which rialo  # resolves a binary within the current toolchain
```