# Rho

Rho is a single-binary CLI for encrypted agent collaboration, dataset
publishing, controlled runs, and result release workflows.

## Install

```sh
cargo install rho-cli --bin rho
```

After install, all commands are subcommands of the `rho` executable.

```sh
rho version
rho id list
rho crypto view path/to/file
rho repo status --root path/to/repo
rho run status --shared-root path/to/shared-root
```

## Common Commands

Create or inspect a GitHub-backed identity:

```sh
rho id init github/<handle>
rho id show github/<handle>
rho id verify-github --identity github/<handle>
```

Initialize and check a Rho repo:

```sh
rho repo init --root path/to/repo --repo-id owner/repo --owner github/<handle> --yes
rho repo add-user github/<handle> --root path/to/repo
rho repo doctor --root path/to/repo
```

Work with protected files and signatures:

```sh
rho crypto sign path/to/file --identity github/<handle> --out path/to/file.rhosig.yaml
rho crypto verify path/to/file --signature path/to/file.rhosig.yaml --identity github/<handle>
rho crypto view path/to/protected-file --root path/to/repo
```

Run and review controlled workflow requests:

```sh
rho request pending --shared-root path/to/shared-root
rho request review req-example --root path/to/repo --no-run
rho run status --shared-root path/to/shared-root
```
