vigocli ask

Ask the AI assistant a natural language question about your fleet. The assistant can query envoys, runs, traits, compliance, configs, configcrates, and packages to answer questions.

Usage

vigocli ask [question] [flags]

If no question argument is given, reads from stdin. This is useful for piping configuration files for review.

Flags

Examples

Ask a fleet-wide question

vigocli ask "how many envoys do I have?"

You currently have 12 enrolled envoys, all active. 10 are compliant,
1 is relapsed, and 1 has errors.

[tools: list_envoys, compliance_summary | tokens: 245]

Ask about a specific envoy

vigocli ask --envoy web-03 "why is it failing?"

web-03.example.com is failing because the nginx package resource
returned an error during the last run: "apt-get install failed:
E: Unable to locate package nginx-extras". The configcrate specifies
package "nginx-extras" but the available package on Ubuntu 24.04
is "nginx-extra" (without the 's').

[tools: envoy_detail, recent_runs | tokens: 412]

Ask for configcrate generation

vigocli ask "write a configcrate for nginx with TLS"

Pipe a config file for review

vigocli ask < stacks/configcrates/nginx.vgo

The piped content is automatically prefixed with "Review this configuration:" before being sent to the AI.

Streaming

The response is streamed via Server-Sent Events (SSE) when the server supports it. Tool usage status updates are shown on stderr while the answer streams to stdout.

Related

• envoys -- manage enrolled envoys
• query -- query trait values directly
• validate -- validate .vgo files programmatically