CLI Reference

The CLI runs as a Lua program through OpenResty resty and reuses runtime modules from the edge.

Run from repo root:

./bin/fairvisor <command> [options]

Commands

Command Description
`fairvisor init [–template=api llm
`fairvisor validate <file ->`
`fairvisor test [–requests=] [–format=table json]`
fairvisor connect [--token=TOKEN] [--url=URL] [--output=PATH] Register edge and write credentials
`fairvisor status [–edge-url=URL] [–format=table json]`
fairvisor logs [--action=ACTION] [--reason=REASON] Filter structured logs
fairvisor version Print CLI version
fairvisor help Print usage

Quick examples

fairvisor init --template=api
fairvisor validate policy.json
fairvisor test policy.json --format json
fairvisor connect --token=<EDGE_TOKEN> --url=https://api.fairvisor.com
fairvisor status --edge-url=http://localhost:8080

Notes

  • There is no serve/reload command in this CLI.
  • Policy input for CLI commands is JSON bundle format, not YAML.