vexyl

Vexyl Labs CLI (vexyl) — Precision telemetry for the terminal era.

vexyl is a high-performance, developer-first CLI designed for observing Cloudflare-based stacks. It emphasizes speed, zero-latency streaming, and automation-friendly JSON output.

Installation

npm install -g @vexyl-labs/cli

Private Beta Handshake

Vexyl Labs is currently in private beta. You can reserve your spot directly from your terminal:

npx @vexyl-labs/cli reserve

Take the resulting token and enter it at vexyl.dev to claim your spot.

To override the reservation service (self-hosted or staging), set VEXYL_BETA_ENDPOINT or pass --endpoint.

Environment Overrides

• VEXYL_ENDPOINT: override the engine API endpoint (default: https://api.vexyl.dev).
• VEXYL_API_URL, VEXYL_ENGINE_URL, VEXYL_ENGINE_ENDPOINT, VEXYL_ENGINE_HOST: alternate endpoint env vars.
• VEXYL_TOKEN: override the saved API token.
• VEXYL_WORKSPACE_ID: default workspace for billing attribution.
• VEXYL_ACCOUNT_ID: default billing account.
• VEXYL_DEMO: enable demo responses (true, 1, yes).
• VEXYL_BETA_ENDPOINT: override the beta reservation service.
• VEXYL_NO_BANNER=1: disable the startup banner (useful for logs/CI).
• VEXYL_NO_TRUECOLOR=1: force 256-color banner output (if your terminal has issues with truecolor).

Local repo config is supported via vexyl.config.json or .vexylrc (e.g. { "service": "api-gateway", "endpoint": "https://api.vexyl.dev" }).

Legacy GRIDPOINT_* variables are still supported.

Startup Banner

By default, vexyl prints a small startup banner when running interactively (only when stdout is a TTY). It automatically adapts to your terminal width (it will use a smaller pre-rendered banner if the full one would wrap).

Disable it:

vexyl --no-banner

Or via environment variable:

VEXYL_NO_BANNER=1 vexyl status

Re-enable it by unsetting VEXYL_NO_BANNER (or setting it to anything other than 1) and removing --no-banner.

Core Commands

• vexyl status: Check system health and active incidents.
• vexyl triage: Run a fast health sweep and see next actions.
• vexyl metrics --watch: Stream live telemetry with zero latency.
• vexyl incidents explain <id>: Get intelligent root-cause analysis for specific incidents.
• vexyl incidents pack <id>: Export a sharable incident summary pack.
• vexyl deploy check: Risk-check recent telemetry before rollback decisions.
• vexyl deploy rollback: Instantly revert to the last known healthy state.
• vexyl config: Manage your workspace and engine endpoints.
• vexyl billing usage recent: Inspect recent usage events.
• vexyl billing usage series: View usage totals over time.

All commands support --demo for a no-setup preview.

Why vexyl?

• Zero Touch: No code changes required. Maps your Workers, D1, and Queues automatically.
• Privacy First: Observes systems, not people. Zero PII storage.
• Automation Ready: Every command supports --json for CI/CD gating and scripting.

© 2025 Vexyl Labs. All rights reserved.