# Broch CLI

Command-line client for a [Broch](https://broch.io) SSH tunnel server — expose local services over secure, authenticated tunnels.

## Install

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

This installs the `broch` command on your `PATH`.

## Point it at a server

The CLI does **not** ship with a built-in server URL — you have to tell it which Broch server to talk to:

```bash
broch config set --server https://trial.broch.io
```

`https://trial.broch.io` is the hosted trial server. **For most real use you'll point the CLI at your own self-hosted Broch server instead** — there is no single "production" Broch server; each organization runs its own. For example:

```bash
broch config set --server https://broch.your-company.com
```

You can also override the server per-invocation with the `BROCH_SERVER_URL` environment variable. The setting persists in your local CLI config once set.

## Authenticate

```bash
broch auth login
```

## Use it

```bash
broch share my-app --target http://localhost:3000   # expose a local service over a tunnel
broch status                                        # show current server / auth state
broch -i                                            # interactive mode
```

Run `broch --help` for the full command list.

## Documentation

See [broch.io/docs](https://www.broch.io/docs/) for the full Broch documentation, including how to run your own self-hosted server.
