# CLI Overview

- Canonical URL: https://docs.fairvisor.com/docs/cli/overview/
- Section: docs
- Last updated: n/a
> Installation and general usage of the fairvisor CLI.


The `fairvisor` CLI is distributed as a container image for operator and CI usage.

## Installation

- CLI image: `ghcr.io/fairvisor/fairvisor-cli:<tag>`

```bash
docker pull ghcr.io/fairvisor/fairvisor-cli:v0.1.0
```

## Usage

```bash
docker run --rm -v "$PWD:/work" -w /work ghcr.io/fairvisor/fairvisor-cli:v0.1.0 help
docker run --rm -v "$PWD:/work" -w /work ghcr.io/fairvisor/fairvisor-cli:v0.1.0 validate policy.json
docker run --rm -v "$PWD:/work" -w /work ghcr.io/fairvisor/fairvisor-cli:v0.1.0 test policy.json
```

Source-based execution remains available for development:

```bash
./bin/fairvisor version
```

## Commands

```
fairvisor <command> [options]

Commands:
  init       Scaffold a policy.json and edge.env.example
  validate   Validate a policy bundle file
  test       Dry-run the rule engine against sample requests
  connect    Register this edge with the SaaS control plane
  status     Query the running edge health and metrics
  logs       Filter structured log output from stdin
  version    Print the CLI version
  help       Print this message
```