Quick Start

Install the ANNÁVE CLI and run your first command in under two minutes.

Install

Homebrew (macOS / Linux)

bash
brew install annave

go install

Requires Go 1.24 or later.

bash
go install annave.tech/cli/cmd/annave@latest

Build from source

bash
git clone https://github.com/annavetech/annave-cli-golang
cd annave-cli-golang
go build -o annave ./cmd/annave
mv annave /usr/local/bin/annave

Verify

bash
annave version
# annave 0.1.0

First commands

Analyze a log file

bash
annave log analyze /var/log/syslog

Check service health

bash
annave health check https://api.example.com tcp://redis:6379

Audit for secrets

bash
annave security audit .

Scan Kubernetes for idle resources

bash
annave cleanup scan

Output formats

Every command supports --format plain|json|table. Default is plain. Use json for scripting or piping to other tools.

bash
annave health check https://api.example.com --format json | jq '.results[].status'

Exit codes

CodeMeaning
0Command ran successfully. Findings and anomalies are data — they do not cause a non-zero exit.
1Execution error — message printed to stderr with the ERR_* code.

Next steps

  • Log analysis — annave log analyze
  • Service health checks — annave health check
  • Security auditing — annave security audit
  • Kubernetes cleanup scanning — annave cleanup scan
  • Infrastructure validation — annave infra validate
  • AWS cost monitoring — annave cost scan
  • Local doc search — annave doc search