# NVIDIA Fleet Intelligence Client
## Overview
`nvfleetint` provides command-line and Go interfaces to NVIDIA Fleet
Intelligence.
- **CLI:** Use the `nvfleetint` executable to inspect fleet status, node health,
inventory, alerts, events, and reports from a terminal or automation
workflow.
- **Go SDK:** Import
`github.com/NVIDIA/fleet-intelligence-client/nvfleetint` to integrate Fleet
Intelligence data into Go applications and services.
Both interfaces support fleet summaries, compute zones, node groups, nodes,
health history, alerts, events, tags, inventory reports, and error reports.
## Install
### CLI
#### Linux and macOS
Install `nvfleetint`:
```bash
curl -fsSL https://github.com/NVIDIA/fleet-intelligence-client/releases/latest/download/install.sh | bash
```
The installer verifies the release checksum and, on macOS, the Developer ID
signature and Apple notarization ticket before installing the executable.
For publisher-authenticated verification using the signed checksum manifest,
see [Verify release artifacts](docs/verify-releases.md).
#### Windows
Install `nvfleetint`:
```powershell
irm https://github.com/NVIDIA/fleet-intelligence-client/releases/latest/download/install.ps1 | iex
```
#### Staying current
`nvfleetint version` checks GitHub for the newest published release and tells
you when the installed build is behind. To upgrade:
```bash
nvfleetint upgrade
```
That runs the installer published with the new release, so it verifies the same
checksum and code signature a fresh install does. To install a specific release
instead of the newest one, name it:
```bash
nvfleetint upgrade --version v1.1.0
```
See [Version and updates](docs/cli.md#version-and-updates) for the JSON output,
the `--yes` flag for CI, and how to turn the check off.
### Go SDK
Add the `nvfleetint` package to a Go module:
```bash
go get github.com/NVIDIA/fleet-intelligence-client/nvfleetint
```
See the [Go SDK guide](docs/sdk.md) for client setup and usage.
## Quick Start
Choose an NGC API key:
- [Personal API key](https://docs.nvidia.com/ngc/latest/ngc-user-guide.html#generating-a-personal-api-key)
for individual use.
- [Service key](https://org.ngc.nvidia.com/identity-access/service-keys) for
programmatic integrations.
```bash
nvfleetint auth add # prompts for the API key and API URL
nvfleetint overview
nvfleetint node list
```
`auth add` reads the API key from stdin rather than a flag.
Credentials are stored in named profiles; with no name, `auth add` uses one
called `default`, so single-tenant setup is the one command above. To work
against several tenants or endpoints, name them: add more with `nvfleetint auth
add <name>`, switch the default with `nvfleetint auth use <name>`, and select one
for a single command with `--profile`. Re-running `auth add` with an existing
name changes that profile in place, which is how a key is rotated — press Enter
at the key prompt to keep the stored key without ever displaying it (`--yes`
covers replacing it from a script, where nothing can be confirmed):
```bash
nvfleetint auth add dev
nvfleetint node list --profile dev
```
Run `nvfleetint <command> --help` for command-specific flags.
## AI Skills
Install the bundled Fleet Intelligence skills for Claude Code, Cursor, and
Codex:
```bash
npx skills add NVIDIA/fleet-intelligence-client \
--skill '*' \
--agent claude-code --agent cursor --agent codex
```
Install and authenticate `nvfleetint` first. See
[Agent Skills](docs/skills.md) for available skills and usage guidance.
## Documentation
Full documentation is available at **[docs.nvidia.com/fleet-intel/client](https://docs.nvidia.com/fleet-intel/client)**, including the CLI guide, Go SDK reference, architecture overview, and agent skills.
For the broader Fleet Intelligence platform documentation, see [docs.nvidia.com/fleet-intel](https://docs.nvidia.com/fleet-intel).
The [OpenAPI contract](https://github.com/NVIDIA/fleet-intelligence-client/blob/main/api/openapi/openapi.yaml) is available in the repository.
## Contributing
See [CONTRIBUTING.md](https://github.com/NVIDIA/fleet-intelligence-client/blob/main/CONTRIBUTING.md) for development setup and guidelines.
## Security
Report vulnerabilities through the [security policy](https://github.com/NVIDIA/fleet-intelligence-client/blob/main/SECURITY.md).
## License
Apache License 2.0 - see [LICENSE](https://github.com/NVIDIA/fleet-intelligence-client/blob/main/LICENSE) for details. Open a [GitHub issue](https://github.com/NVIDIA/fleet-intelligence-client/issues) for support.