# Clerval CLI

Command-line interface for [Clerval](https://clerval.net) — connect your machines, run agents locally, and manage devices from the terminal.

## Install

```bash
npm install -g @clerval/cli
```

## Quick start

```bash
# Sign in to your Clerval account
clrv login

# Connect this machine (runs in the background)
clrv connect --daemon
```

Open Clerval → **Settings → Devices** to confirm the machine appears.

`clrv connect` uses the official Clerval device gateway (`device-gateway.clerval.net`) so cloud agents can run tools on this machine.

## Common commands

```bash
clrv --help
clrv login
clrv connect --daemon
clrv agent --help
```

## Shell completion

| Shell | Command                          |
| ----- | -------------------------------- |
| zsh   | `source <(clrv completion zsh)`  |
| bash  | `source <(clrv completion bash)` |

## Links

- [Clerval](https://clerval.net)
- [Changelog](https://clerval.net/updates)

## License

**Clerval Proprietary License 1.0** — closed-source software. Copyright © Clerval. All rights reserved.

- Full license text: [LICENSE](./LICENSE) (included in this package)
- Online copy: <https://unpkg.com/@clerval/cli@latest/LICENSE>
- npm package: <https://www.npmjs.com/package/@clerval/cli>

You may install and use the CLI with Clerval only. You may not copy, modify, redistribute, reverse engineer, or use this software to build a competing product.
