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

CommandDescription
`fairvisor init [–template=apillm
`fairvisor validate <file->`
`fairvisor test [–requests=] [–format=tablejson]`
fairvisor connect [--token=TOKEN] [--url=URL] [--output=PATH]Register edge and write credentials
`fairvisor status [–edge-url=URL] [–format=tablejson]`
fairvisor logs [--action=ACTION] [--reason=REASON]Filter structured logs
fairvisor versionPrint CLI version
fairvisor helpPrint 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.