# Cowth CLI for Linux

cowthctl connects to the Cowth hosted broker service.

## Installation

Extract the binary and move it to a directory on your PATH:

```sh
unzip cowthctl-*-linux-x64.zip
sudo mv cowthctl-*-linux-x64/cowthctl /usr/local/bin/
```

Or use the one-line installer (recommended):

```sh
curl -fsSL https://download.cowth.dev/install.sh | sh
```

## Quick start

```sh
cowthctl sandbox profile init --user <username>
cowthctl pub --user <username> --topic <topic> -m "hello"
cowthctl sub --user <username> --topic <topic>
cowthctl doctor
cowthctl --help
```

## Commands

```
cowthctl pub --user <name> --topic <path> -m <msg> [-l] [-i <secs>]
    Publish a message to a topic.
    -l, --loop        Repeat until Ctrl+C
    -i, --interval    Seconds between publishes (min 0.1, default 1)

cowthctl sub --user <name> --topic <path> [-n <count>]
    Subscribe and print incoming messages.
    -n, --count       Stop after receiving <n> messages

cowthctl sandbox profile init --user <name>
    Set up credentials profile.
    Reads token from COWTH_SANDBOX_CREDENTIAL_TOKEN

cowthctl doctor
    Check connection and profile health.

cowthctl version
    Print version.
```

Sign up and documentation: https://cowth.dev

SHA-256 checksums are published alongside every release artifact at
https://download.cowth.dev and must be verified before use in production.
