The NATS Command Line Interface is a Go-based utility designed to interact with and manage NATS, a cloud-native messaging system. The repository provides comprehensive command-line tooling for operators and developers working with NATS infrastructure, covering everything from basic message publishing and subscription to advanced cluster management and performance testing.
The CLI supports a wide range of operational capabilities organized around several core domains. JetStream management allows users to create, configure, and monitor NATS's persistent streaming layer. Key-Value and Object Store management provide interfaces for these specialized NATS features. The tool includes Service API management for working with NATS's request-reply patterns and microservices architectures. Users can perform JetStream data and configuration backups, publish and subscribe to messages, create and invoke services, and run benchmarking and latency tests to evaluate network performance. The CLI also provides deep system account inspection and reporting capabilities, configuration context maintenance for managing multiple server connections, access to the NATS ecosystem schema registry, and monitoring of streams, consumers, services, servers, and credentials.
A distinctive feature is the configuration context system, which allows users to maintain multiple named configurations for different NATS deployments. Contexts are stored as JSON documents in the user's home directory and can be easily switched between, supporting workflows where operators manage multiple NATS clusters or environments.
The repository shows active development and maintenance.
Installation is available through multiple channels including GitHub releases with packages for various operating systems, direct Go installation via go install, Homebrew for macOS, Scoop for Windows, and AUR for Arch Linux. Nightly Docker images are also provided for users wanting the latest development builds.
The CLI includes sophisticated messaging features such as support for HTTP-style headers in message publishing, queue group load sharing for subscribers, and message translation capabilities that allow piping message data through external commands like jq for formatting or processing. The benchmarking suite enables performance testing of core NATS, JetStream, and service-based architectures with configurable parameters for message size, concurrency, and throughput rates.
For cluster and super-cluster environments, the tool provides lifecycle event monitoring, server discovery and observation, and comprehensive reporting across distributed deployments. These capabilities require a system account to be configured on the NATS servers but provide visibility into client connections, subscriptions, and network topology across entire clusters.
